armansansd 3424b1927b first commit 2 years ago
..
lib 3424b1927b first commit 2 years ago
tests 3424b1927b first commit 2 years ago
.npmignore 3424b1927b first commit 2 years ago
LICENSE 3424b1927b first commit 2 years ago
README.md 3424b1927b first commit 2 years ago
package.json 3424b1927b first commit 2 years ago

README.md

File - Common higher level file and path operations

Install

  npm install file
  var file = require("file");

API

file.walk(start, callback)

Navigates a file tree, calling callback for each directory, passing in (null, dirPath, dirs, files).

file.walkSync(start, callback)

Synchronus version of file.walk, calling callback for each directory, passing in (dirPath, dirs, files).

file.mkdirs(path, mode, callback)

Makes all the directories in a path. (analgous to mkdir -P) For example given a path like "test/this/path" in an empty directory, mkdirs would make the directories "test", "this" and "path".

file.mkdirsSync(path, mode)

Like file.mkdirs but synchronous.

file.path.abspath(path)

Expands ".", "..", "~" and non root paths to their full absolute path. Relative paths default to being children of the current working directory.

file.path.relativePath(root, fullPath)

Given a root path, and a fullPath attempts to diff between the two to give us an acurate path relative to root.

file.path.join(head, tail)

Just like path.join but haves a little more sanely when give a head equal to "". file.path.join("", "tail") returns "tail", path.join("", "tail") returns "/tail"