deferred-exec

Deferred based tool to run exec commands

deferred-exec

Deferred based tool to run exec commands

Install the module with: npm install deferred-exec or add it to your project's package.json file.

You can also clone this repo and npm install folderOfClonedRepo to get a branch or development copy.

All calls return a promise, which means it's easy to do stuff when they complete or fail:

var dexec = require( 'deferred-exec' );
 
dexec( 'echo "yay"' ).done( function( stdoutstderrcommand ) {
  console.log( stdout ); // logs "yay" 
});

Since they are deferreds, you can pass them around in your code:

var dexec = require( 'deferred-exec' );
 
var command = dexec( 'echo "gotcha"' );
 
doSomethingWithCommand( command );
 
// meanwhile, in some other part of your application 
function doSomethingWithCommand( command ) {
  command.done( function( stdoutstderrcommand ) {
    console.log( 'just ran', command, 'and got', stdout );
  });
}

Use Underscore.Deferred if you want to use _.when to group multiple commands. (Note: you can use underscore.deferred with lodash)

var dexec = require( 'deferred-exec' );
 
// require and mixin lodash with _.deferred 
var _ = require( 'lodash' );
_.mixin( require( 'underscore.deferred' ) );
 
var commandA = dexec( 'ls /etc' );
var commandB = dexec( 'echo "hi"' );
 
// when both commands succeed 
_.when( commandA, commandB ).done( function( ab ){
  console.log( 'commandA output:', a[0] );
  console.log( 'commandB output:', b[0] );
});

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

Copyright (c) 2012 Dan Heberden
Licensed under the MIT license.