bower/lib/util/cmd.js

var cp = require('child_process');
var Q = require('q');
var createError = require('./createError');

// Executes a shell command, buffering the stdout and stderr
// If an error occurs, a meaningful error is generated
// Returns a promise that gets fulfilled if the command succeeds
// or rejected if it fails
function cmd(command, args, options) {
    var process,
        stderr = '',
        stdout = '',
        deferred = Q.defer();

    process = cp.spawn(command, args, options);
    process.stdout.on('data', function (data) { stdout += data.toString(); });
    process.stderr.on('data', function (data) { stderr += data.toString(); });

    // Listen to the close event instead of exit
    // They are similar but close ensures that streams are flushed
    process.on('close', function (code) {
        var fullCommand,
            error;

        if (code) {
            // Generate the full command to be presented in the error message
            if (!Array.isArray(args)) {
                args = [];
            }

            fullCommand = command;
            fullCommand += args.length ? ' ' + args.join(' ') : '';

            // Build the error instance
            error = createError('Failed to execute "' + fullCommand + '", exit code of #' + code, 'ECMDERR', {
                details: stderr,
                exitCode: code
            });

            return deferred.reject(error);
        }

        return deferred.resolve(stdout);
    });

    return deferred.promise;
}

module.exports = cmd;