A tempfile creator for 'non-destructive' file operations in node.js
Super simple, dependency-free temporary file creator for 'non-destructive' operations in your
nondest is for times when you need to be able to safely edit (or hack away at) the contents of a file from within a node application for some purpose, without ever wanting to actually alter the data on disk.
I've experienced file corruption during long running operations with open file streams, so with this I'm safely working on copied data.
npm install nondest
There's not much to it. Call
create with the path and options to use, and work with the files after the
available event fires.
NOTE: a call to remove() is required to delete the temp directory.
var nondest = require'nondest';
Create the temporary copy & wait for it's availability:
nondestcreate'../filepath'on'available'// hack away on files in tmppathon'error'// do something with err;
If you want to keep $TMPDIR tidy:
processon'exit'nondestremove// handle error during rmdir;;
The following events are emitted:
available: files have finished copying and are ready at the returned
error: domain error occurred within the module
The following options are available:
id: the temp directory name, defaults to
util.format('_nondest_%s_%s', process.pid, new Date().getTime()), or you can pass in something super unique
limit: the number of simultaneous "workers" allowed during copy operation - defaults to 12
RegExpor function() to filter what gets copied
temppath: provide a path to override the use of $TMPDIR if you wish
A couple of notes:
All functionality in the module is wrapped in a
domain so any errors encountered should only bubble up to nondest's
domain.on('error') which then will fire it's
error event for you to handle.
I have not yet tested this on every platform so please open an issue if you find any platform or other bugs. And be sure to submit a pull request if you tweak, correct, or otherwise improve the code ; )