@xuhaojun/fs-temp v1.2.1-noah.0

fs-temp

fs-temp is a quick and simple way to create temporary files and directories.

Why another one? I know that there are already libraries doing similar things, but I felt that their implementation was unnecessary complicated. I also wanted a quick way to turn a buffer into a file.

Installation

npm install --save fs-temp

Usage

var temp = require('fs-temp')

var data = new Buffer('testing 1 2 3')
var path = temp.writeFileSync(data)

// `path` now holds the path to a file with the specified `data`

var temp = require('fs-temp')

var path = temp.template('linusu-%s').mkdirSync()

// `path` now holds the path to a directory with the prefix 'linusu-'

Promise support

If you require fs-temp/promise you'll receive an alternative API where all functions that takes callbacks are replaced by Promise-returning functions.

var temp = require('fs-temp/promise')

var data = new Buffer('testing 1 2 3')

temp.writeFile(data).then(path => {
  // `path` now holds the path to a file with the specified `data`
})

API

The api mimics the one provided by fs very closely.

.open(flags[, mode], callback)

Asynchronous file open.

flags is either 'w' (only writing) or 'w+' (writing and reading).

The callback gets two arguments (err, obj). obj has fd and path.

.openSync(flags[, mode])

Synchronous version of .open(), returns obj with fd and path.

.mkdir([mode, ]callback)

Creates an empty directory.

The callback gets two arguments (err, path).

.mkdirSync([mode])

Synchronous version of .mkdir(), returns path.

.writeFile(data[, encoding], callback)

Asynchronously writes data to a file. data can be a string or a buffer. The encoding argument is ignored if data is a buffer. It defaults to 'utf8'.

The callback gets two arguments (err, path).

.writeFileSync(data[, encoding])

Synchronous version of .writeFileSync(), returns path.

.createWriteStream([options])

Creates and returns a fs.WriteStream that will write it's content to a temporary file. It differs from the standard WriteStream in the following ways.

• An event named path will be emitted with the path to the file before the open event is emitted.
• The property path will be null until the path event is emitted.

.template(template)

Returns a copy of the module that uses the specified template when generating file names. template should be a string where %s will be replaced with some random characters (e.g. 'linusu-%s').

The string should contain %s exactly once. If you want to include a literal percent sign, escape it with another one, e.g. '%%string' becomes '%string'.

License

The MIT License (MIT)

Copyright (c) 2014 Linus Unnebäck