fs plus

Yet another filesystem helper based on node's fs module. This library exports everything from node's fs module but with some extra helpers.

Using

npm install fs-plus

fs = require 'fs-plus'

Documentation

`getHomeDirectory()`

Returns the absolute path to the home directory.

`absolute(relativePath)`

Make the given path absolute by resolving it against the current working directory.

Params

String relativePath: The string representing the relative path. If the path is prefixed with '~', it will be expanded to the current user's home directory.

Return

String: The absolute path or the relative path if it's unable to determine its real path.

`normalize(pathToNormalize)`

Normalize the given path treating a leading ~ segment as referring to the home directory. This method does not query the filesystem.

Params

String pathToNormalize: The string containing the abnormal path. If the path is prefixed with '~', it will be expanded to the current user's home directory.

Return

String Returns a normalized path.

`tildify(pathToTildify)`

Convert an absolute path to tilde path on Linux and macOS: /Users/username/dev => ~/dev

Params

String pathToTildify: The string containing the full path.

Return

String Returns a tildified path.

`getAppDataDirectory()`

Get path to store application specific data.

Return

String Returns the absolute path or null if platform isn't supported
- macOS: ~/Library/Application Support/
- Windows: %AppData%
- Linux: /var/lib

`isAbsolute(pathToCheck)`

Is the given path absolute?

Params

String pathToCheck: The relative or absolute path to check.

Return

Bolean Returns true if the path is absolute, false otherwise.

`existsSync(pathToCheck)`

Returns true if a file or folder at the specified path exists.

`isDirectorySync(directoryPath)`

Returns true if the given path exists and is a directory.

`isDirectory(directoryPath)`

Asynchronously checks that the given path exists and is a directory.

`isFileSync(filePath)`

Returns true if the specified path exists and is a file.

`isSymbolicLinkSync(symlinkPath)`

Returns true if the specified path is a symbolic link.

`isSymbolicLink(symlinkPath, callback)`

Calls back with true if the specified path is a symbolic link.

`isExecutableSync(pathToCheck)`

Returns true if the specified path is executable.

`getSizeSync(pathToCheck)`

Returns the size of the specified path.

`listSync(rootPath, extensions)`

Returns an Array with the paths of the files and directories contained within the directory path. It is not recursive.

Params

String rootPath: The absolute path to the directory to list.
Array extensions: An array of extensions to filter the results by. If none are given, none are filtered (optional).

`list(rootPath, extensions)`

Asynchronously lists the files and directories in the given path. The listing is not recursive.

`listTreeSync(rootPath)`

Get all paths under the given path.

Params

String rootPath The {String} path to start at.

Return

Array Returns an array of strings under the given path.

`moveSync(source, target)`

Moves the file or directory to the target synchronously.

`removeSync(pathToRemove)`

Removes the file or directory at the given path synchronously.

`writeFileSync(filePath, content, options)`

Open, write, flush, and close a file, writing the given content synchronously. It also creates the necessary parent directories.

`writeFile(filePath, content, options, callback)`

Open, write, flush, and close a file, writing the given content asynchronously. It also creates the necessary parent directories.

`copySync(sourcePath, destinationPath)`

Copies the given path recursively and synchronously.

`makeTreeSync(directoryPath)`

Create a directory at the specified path including any missing parent directories synchronously.

`makeTree(directoryPath, callback)`

Create a directory at the specified path including any missing parent directories asynchronously.

`traverseTreeSync(rootPath, onFile, onDirectory)`

Recursively walk the given path and execute the given functions synchronously.

Params

String rootPath: The string containing the directory to recurse into.
Function onFile: The function to execute on each file, receives a single argument the absolute path.
Function onDirectory: The function to execute on each directory, receives a single argument the absolute path (defaults to onFile). If this function returns a falsy value then the directory is not entered.

`traverseTree(rootPath, onFile, onDirectory, onDone)`

Public: Recursively walk the given path and execute the given functions asynchronously.

`md5ForPath(pathToDigest)`

Hashes the contents of the given file.

Params

String pathToDigest: The string containing the absolute path.

Return

String Returns a string containing the MD5 hexadecimal hash.

`resolve(loadPaths, pathToResolve, extensions)`

Finds a relative path among the given array of paths.

Params

Array loadPaths: An array of absolute and relative paths to search.
String pathToResolve The string containing the path to resolve.
Array extensions An array of extensions to pass to {resolveExtensions} in which case pathToResolve should not contain an extension (optional).

Return

Returns the absolute path of the file to be resolved if it's found and undefined otherwise.

`resolveOnLoadPath()`

Like .resolve but uses node's modules paths as the load paths to search.

`resolveExtension(pathToResolve, extensions)`

Finds the first file in the given path which matches the extension in the order given.

Params

String pathToResolve: the string containing relative or absolute path of the file in question without the extension or '.'.
Array extensions: the ordered array of extensions to try.

Return

Returns the absolute path of the file if it exists with any of the given extensions, otherwise it's undefined.

`isCompressedExtension(ext)`

Returns true for extensions associated with compressed files.

`isImageExtension(ext)`

Returns true for extensions associated with image files.

`isPdfExtension(ext)`

Returns true for extensions associated with pdf files.

`isBinaryExtension(ext)`

Returns true for extensions associated with binary files.

`isReadmePath(readmePath)`

Returns true for files named similarily to 'README'

`isMarkdownExtension(ext)`

Returns true for extensions associated with Markdown files.

`isCaseInsensitive()`

Is the filesystem case insensitive? Returns true if case insensitive, false otherwise.

`isCaseSensitive()`

Is the filesystem case sensitive? Returns true if case sensitive, false otherwise.

`statSyncNoException(path[, options])`

Calls fs.statSync, catching all exceptions raised. This method calls fs.statSyncNoException when provided by the underlying fs module (Electron < 3.0). Returns fs.Stats if the file exists, false otherwise.

`lstatSyncNoException(path[, options])`

Calls fs.lstatSync, catching all exceptions raised. This method calls fs.lstatSyncNoException when provided by the underlying fs module (Electron < 3.0). Returns fs.Stats if the file exists, false otherwise.

Current Tags

3.1.1 ... latest (6 years ago)

fs plus

Using

Documentation

getHomeDirectory()

absolute(relativePath)

Params

Return

normalize(pathToNormalize)

Params

Return

tildify(pathToTildify)

Params

Return

getAppDataDirectory()

Return

isAbsolute(pathToCheck)

Params

Return

existsSync(pathToCheck)

isDirectorySync(directoryPath)

isDirectory(directoryPath)

isFileSync(filePath)

isSymbolicLinkSync(symlinkPath)

isSymbolicLink(symlinkPath, callback)

isExecutableSync(pathToCheck)

getSizeSync(pathToCheck)

listSync(rootPath, extensions)

Params

list(rootPath, extensions)

listTreeSync(rootPath)

Params

Return

moveSync(source, target)

removeSync(pathToRemove)

writeFileSync(filePath, content, options)

writeFile(filePath, content, options, callback)

copySync(sourcePath, destinationPath)

makeTreeSync(directoryPath)

makeTree(directoryPath, callback)

traverseTreeSync(rootPath, onFile, onDirectory)

Params

traverseTree(rootPath, onFile, onDirectory, onDone)

md5ForPath(pathToDigest)

Params

Return

resolve(loadPaths, pathToResolve, extensions)

Params

Return

resolveOnLoadPath()

resolveExtension(pathToResolve, extensions)

Params

Return

isCompressedExtension(ext)

isImageExtension(ext)

isPdfExtension(ext)

isBinaryExtension(ext)

isReadmePath(readmePath)

isMarkdownExtension(ext)

isCaseInsensitive()

isCaseSensitive()

statSyncNoException(path[, options])

lstatSyncNoException(path[, options])

Current Tags

50 Versions

`getHomeDirectory()`

`absolute(relativePath)`

`normalize(pathToNormalize)`

`tildify(pathToTildify)`

`getAppDataDirectory()`

`isAbsolute(pathToCheck)`

`existsSync(pathToCheck)`

`isDirectorySync(directoryPath)`

`isDirectory(directoryPath)`

`isFileSync(filePath)`

`isSymbolicLinkSync(symlinkPath)`

`isSymbolicLink(symlinkPath, callback)`

`isExecutableSync(pathToCheck)`

`getSizeSync(pathToCheck)`

`listSync(rootPath, extensions)`

`list(rootPath, extensions)`

`listTreeSync(rootPath)`

`moveSync(source, target)`

`removeSync(pathToRemove)`

`writeFileSync(filePath, content, options)`

`writeFile(filePath, content, options, callback)`

`copySync(sourcePath, destinationPath)`

`makeTreeSync(directoryPath)`

`makeTree(directoryPath, callback)`

`traverseTreeSync(rootPath, onFile, onDirectory)`

`traverseTree(rootPath, onFile, onDirectory, onDone)`

`md5ForPath(pathToDigest)`

`resolve(loadPaths, pathToResolve, extensions)`

`resolveOnLoadPath()`

`resolveExtension(pathToResolve, extensions)`

`isCompressedExtension(ext)`

`isImageExtension(ext)`

`isPdfExtension(ext)`

`isBinaryExtension(ext)`

`isReadmePath(readmePath)`

`isMarkdownExtension(ext)`

`isCaseInsensitive()`

`isCaseSensitive()`

`statSyncNoException(path[, options])`

`lstatSyncNoException(path[, options])`