atom/fs-plus


node's fs module with some helpful additions

http://atom.github.io/fs-plus

License: MIT

Language: CoffeeScript


fs plus

macOS Build Status Windows Build Status Dependency Status

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.

Project Statistics

Sourcerank 16
Repository Size 228 KB
Stars 94
Forks 28
Watchers 22
Open issues 6
Dependencies 76
Contributors 31
Tags 49
Created
Last updated
Last pushed

Top Contributors See all

Kevin Sawicki Antonio Scandurra Damien Guard oclbdk Ionică Bizău (Johnny B.) David Wilson Andres Suarez John Gardner Abe Estrada Marek Hrabe Ross Allen Matt Colyer Lukas Geiger Lee Dohm Nathan Sobo PJ Eby Kyle Kelley Rayjan Wilson Bryant Ung Ian Olsen

Packages Referencing this Repo

fs-plus
node's fs with more helpers
Latest release 3.1.1 - Updated - 94 stars
fs-plus
node's fs with more helpers
Latest release 2.9.2 - Published - 94 stars

Recent Tags See all

v3.1.1 December 19, 2018
v3.1.0 December 14, 2018
v3.0.2 January 24, 2018
v3.0.0 March 06, 2017
v2.10.1 March 04, 2017
v2.10.0 March 03, 2017
v2.9.3 October 11, 2016
v2.9.2 September 21, 2016
v2.9.1 May 26, 2016
v2.9.0 May 26, 2016
v2.8.2 April 10, 2016
v2.8.1 May 18, 2015
v2.8.0 May 05, 2015
v2.7.1 April 20, 2015
v2.7.0 April 02, 2015

Something wrong with this page? Make a suggestion

Last synced: 2019-01-29 00:18:31 UTC

Login to resync this repository