outpipe

write output to a file through shell commands

purpose

Suppose you have a tool like
watchify
or factor-bundle
that write to multiple files or write to the same file more than once.

If you want to pipe the output of these tools to other programs, such as
minification with the uglify command, it's very difficult! You might need to
use the tool's API or use a separate command to watch for changes to the output
files. Ick.

You don't get the elegance of something like:

 $ browserify main.js | uglifyjs -cm | gzip > bundle.js.gz

Until now! With this library and a hypothetical version of watchify, you could
do:

 $ watchify main.js -dv -o 'uglifyjs -cm | gzip > bundle.js.gz'

example

Here's a small watcher program that will just copy input files to a destination,
but transforms can be applied along the way with shell pipes and redirects.

 var outpipe = require('outpipe');
var gaze = require('gaze');
var fs = require('fs');

var minimist = require('minimist');
var argv = minimist(process.argv.slice(2), {
    alias: { o: 'output' }
});

var file = argv._[0];
gaze(file, function (err, w) {
    w.on('changed', read);
});
read();

function read () {
    var r = fs.createReadStream(file);
    r.pipe(outpipe(argv.output));
}

We can run the program with a single output file:

 $ node watch.js input/x.js -o output/hmm.js

which just copies x.js to output/hmm.js whenever x.js changes.

We could also run a minification step using the uglify command:

 $ node watch.js input/x.js -o 'uglifyjs -cm > output/wow.js'

or we can just print the size of the minified and gzipped output to stdout:

 $ node watch.js input/x.js -o 'uglifyjs -cm | gzip | wc -c'
123

or we could write that size to a file:

 $ node watch.js input/x.js -o 'uglifyjs -cm | gzip | wc -c > size.txt'

methods

 var outpipe = require('outpipe')

var w = outpipe(cmd, opts={})

Return a writable stream w that will pipe output to the command string cmd.

If cmd has no operators (| or >), it will write to a file.

Otherwise, each command between pipes will be executed and output is written to
a file if > is given.

opts can be:

• opts.env - an object mapping environment variables to their values or a
  function (key) {} that returns the values.

stdout and stderr are forwarded to process.stdout and process.stderr if
unhandled in the command.

install

With npm do:

npm install outpipe

license

MIT