vow-fs

File I/O by Vow

npm install vow-fs
1 666 downloads in the last day
10 268 downloads in the last week
44 911 downloads in the last month

vow-fs NPM version Build Status

Vow-based file I/O for Node.js

Requirements

Vow-fs works with Node.js 0.6, 0.8 and 0.10.

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=utf8])

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

write(path, data, [encoding=utf8])

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

append(path, data, [encoding=utf8])

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.

stats(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.

Creates a hard link from the sourcePath to targetPath.

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.

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.

npm loves you