fs-temp
`fs-temp` is a quick and simple way to create temporary files and directories.
Last updated a month ago by linusu .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install fs-temp 
SYNC missed versions from official npm registry.

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

Current Tags

  • 1.2.1                                ...           latest (a month ago)

11 Versions

  • 1.2.1                                ...           a month ago
  • 1.2.0                                ...           a month ago
  • 1.1.2                                ...           4 years ago
  • 1.1.1                                ...           4 years ago
  • 1.1.0                                ...           4 years ago
  • 1.0.0                                ...           5 years ago
  • 0.2.0                                ...           5 years ago
  • 0.1.3                                ...           5 years ago
  • 0.1.2                                ...           5 years ago
  • 0.1.1                                ...           6 years ago
  • 0.1.0                                ...           6 years ago
Maintainers (1)
Downloads
Today 25
This Week 112
This Month 229
Last Day 26
Last Week 161
Last Month 743
Dependencies (1)
Dev Dependencies (2)

Copyright 2014 - 2016 © taobao.org |