jprichardson
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-extraUsage
var path = require('path-extra');You can still use all of the vanilla Node.js path methods.
Methods:
replaceExt(filePath, extension)
Replaces the extension from path with extension and returns the updated path string.
From the module replace-ext.
Example:
path.replaceExt('dir/file.md', '.html')
// => 'dir/file.html'normalizeTrim(filePath)
A path.normalize() that trims trailing slashes. Useful for comparing file paths.
Example:
path.normalize('/foo/bar//baz/asdf/quux/../')
// => /foo/bar/baz/asdf/
path.normalizeTrim('/foo/bar//baz/asdf/quux/../')
// => /foo/bar/baz/asdfbase(filePath, [includeExt])
A smart wrapper for path.basename().
- When
includeExtisfalse, returns the basename without an extension (path.basename(filePath, path.extname(filePath))). - When
includeExtistrue, works likepath.basename(filePath). includeExtisfalseby default.
Example:
path.base('path/to/file.md')
// => file
path.base('path/to/file.md', false)
// => file
path.base('path/to/file.md', true)
// => file.mdremoveExt(filepath)
Remove a path's extension.
Example:
path.removeExt('some/dir/file.ext')
// => some/dir/filefileNameWithPostfix(filePath, postfix)
Append string to the end of the filename.
Example:
path.fileNameWithPostfix('path/to/file-name.ext', '-old')
// => path/to/file-name-old.extfileNameWithPrefix(filePath, prefix)
Append string to the beginning of the filename.
Example:
path.fileNameWithPrefix('path/to/file-name.ext', 'new-')
// => path/to/new-file-name.exthomedir(), 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