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.