flow-write

Thin wrapper for graceful-fs file write stream.

Installation

$ npm install flow-write

API

To create a writeStream factory,

var writeStream = require( 'flow-write' ),
	wStream = writeStream();

wStream.path( [filepath] )

This method is a setter/getter. If no output filepath is provided, returns the output filepath. You configure the stream factory by specifying an output filepath:

wStream.path( 'path/to/output/destination' );

wStream.stream( [clbk] )

Provided a filepath has been specified, to create a new writeStream:

var stream = wStream.stream( clbk );

Where the optional clbk is invoked upon stream end and has an error as its first argument. If no write errors, error is null.

Usage

Methods are chainable:

var stream = writeStream()
	.path( 'path/to/file/destination' )
	.stream( clbk );

readStream.pipe( stream );

Examples

var eventStream = require( 'event-stream' ),
	writeStream = require( 'flow-write' );

// Create some data...
var data = new Array( 1000 );
for ( var i = 0; i < data.length; i++ ) {
	data[ i ] = Math.random();
}

// Create a readable stream:
var readStream = eventStream.readArray( data );

// Create a new stream, passing along an optional error handler:
var stream = writeStream()
	.path( __dirname + '/path/to/output/file.json' )
	.stream( onError );

// Pipe the data to the stream...
readStream.pipe( stream );

// Error handler:
function onError( error ) {
	if ( error ) {
		console.error( error.stack );
		throw new Error( 'Error!!!' );
	}
	console.log( 'Finished!' );
}

Tests

Unit tests use the Mocha test framework with Chai assertions.

Assuming you have installed Mocha, execute the following command in the top-level application directory to run the tests:

$ mocha

All new feature development should have corresponding unit tests to validate correct functionality.

License

MIT license.

---

Copyright

Copyright © 2014. Athan Reines.