vow-fs

Vow-based file I/O for Node.js

Requirements

Vow-fs works with Node.js 0.6 and above.

Getting Started

You can install vow-fs using Node Package Manager (npm):

npm install vow-fs

Usage

var fs = require('vow-fs');

API

read(path, [encoding])

Returns a promise for the file's content at a given path.

write(path, data, [encoding])

Writes data to file at a given path. Returns a promise for the completion of the operation.

append(path, data, [encoding])

Appendsdata to file's content at a given path. Returns a promise for the completion of the operation.

remove(path)

Removes a file at a given path. Returns a promise for the completion of the operation.

copy(sourcePath, targetPath)

Copies a file from sourcePath to targetPath. Returns a promise for the completion of the operation.

move(sourcePath, targetPath)

Moves a file or directory from sourcePath to targetPath. Returns a promise for the completion of the operation.

stat(path)

Returns a promise for the metadata about the given path as a Stats object.

exists(path)

Returns a promise for whether the given path exists.

link(sourcePath, targetPath)

Creates a hard link from the sourcePath to targetPath.

symLink(sourcePath, targetPath, [type=file])

Creates a symbolic link from the sourcePath to targetPath.

chown(path, uid, gid)

Changes the owner of a given path.

chmod(path, mode)

Changes the mode of a given path to mode.

absolute(path)

isFile(path)

Returns a promise for whether the given path is a file.

isDir(path)

Returns a promise for whether the given path is a directory.

isSocket(path)

Returns a promise for whether the given path is a socket.

isSymLink(path)

Returns a promise for whether the given path is a symbolic link.

makeTmpFile([options])

Makes a temporary file. Returns a promise with generated path to file. The options:

• prefix (absent by default)
• dir (operating system's directory for temp files by default)
• ext (.tmp by default)

listDir(path)

Returns a promise for a list of files and directories in directory at the given path.

makeDir(path, [mode=0777], [failIfExist=false])

Makes a directory at a given path and any necessary subdirectories (like mkdir -p). Returns a promise for the completion of the operation.

removeDir(path)

Recursively removes a directory at a given path (like remove -rf). Returns a promise for the completion of the operation.

glob(pattern, [options])

Matches files using the patterns. See https://github.com/isaacs/node-glob for details.