site_opytex/theme/node_modules/parse-filepath/README.md

3.3 KiB

parse-filepath NPM version NPM downloads Build Status

Pollyfill for node.js path.parse, parses a filepath into an object.

You might also be interested in global-prefix.

Install

Install with npm:

$ npm install parse-filepath --save

Usage

var parsePath = require('parse-filepath');
parsePath(filepath);

This can be used as a polyfill for the native node.js path.parse() method, and it also adds a few properties:

  • path: the original filepath
  • isAbsolute: (getter) true if the given path is absolute
  • absolute: (getter) fully resolved, absolute filepath
  • dirname: alias for dir
  • basename: alias for base
  • extname: alias for ext
  • stem: alias for name

Example

var parsePath = require('parse-filepath');
console.log(parsePath('foo/bar/baz/index.js'));

Returns:

{ root: '',
  dir: 'foo/bar/baz',
  base: 'index.js',
  ext: '.js',
  name: 'index',

  // aliases
  extname: '.js',
  basename: 'index.js',
  dirname: 'foo/bar/baz',
  stem: 'index',

  // original path
  path: 'foo/bar/baz/index.js',

  // getters
  absolute: [Getter/Setter],
  isAbsolute: [Getter/Setter] }

You might also be interested in these projects:

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.


This file was generated by verb, v, on March 29, 2016.