path-extra

Node.js: path-extra
===================

This module simply modifies the Node.js 'path' object with extra methods. It is a drop in replacement for the path module.

Installation
------------

$ npm install path-extra

Usage
-----

``javascript
var path = require('path-extra');
`

You can still use all of the vanilla Node.js path methods.

Methods:

$3

Replaces the extension from path with extension and returns the updated path string.

From the module replace-ext.

Example:

`js
path.replaceExt('dir/file.md', '.html')
// => 'dir/file.html'
`

$3

A path.normalize() that trims trailing slashes. Useful for comparing file paths.

Example:

`js
path.normalize('/foo/bar//baz/asdf/quux/../')
// => /foo/bar/baz/asdf/
path.normalizeTrim('/foo/bar//baz/asdf/quux/../')
// => /foo/bar/baz/asdf
`

$3

A smart wrapper for path.basename().

- When includeExt is false, returns the basename without an extension (path.basename(filePath, path.extname(filePath))).
- When includeExt is true, works like path.basename(filePath).
- includeExt is false by default.

Example:

`js
path.base('path/to/file.md')
// => file
path.base('path/to/file.md', false)
// => file
path.base('path/to/file.md', true)
// => file.md
`

$3

Remove a path's extension.

Example:

`js
path.removeExt('some/dir/file.ext')
// => some/dir/file
`

$3

Append string to the end of the filename.

Example:

`js
path.fileNameWithPostfix('path/to/file-name.ext', '-old')
// => path/to/file-name-old.ext
`

$3

Append string to the beginning of the filename.

Example:

`js
path.fileNameWithPrefix('path/to/file-name.ext', 'new-')
// => path/to/new-file-name.ext
`

---

homedir(), tempdir(), and datadir()` have been removed in version 4.0.0. Please use the ospath module instead.

License
-------

(The MIT License)

Copyright (c) 2011-2015 JP Richardson