impulse-bin

node.js bin/ script module loader

npm install impulse-bin
11 downloads in the last week
30 downloads in the last month

impulse-bin

node.js bin/ script module loader

  • Adapters for commander.js and node-optimist
  • Injects common dependencies like this.child_process, this.shelljs, etc.
  • Basic set of long-con console loggers for stdout/stderr/verbose with color

Build Status

Purpose

  • CLI scripts that are easier to test without running the executable.
  • Reduce boilerplate.

Example

bin/myproj

Executables are reduced to thin loading calls.

var bin = require('impulse-bin').create();
bin.run(require('commander'), require('./lib/cli/myproj'));

lib/cli/myproj.js

While the rest is separated into input parsing and input consumption.

  • init() receives a CLI input provider like commander.js or node-optimist for you to configure.
  • run() receives the parsed this.options and this.args from the provider.
exports.init = function(provider) {
  provider.option('-c, --config <dir>', 'Config file');
};

exports.run = function() {
  this.exitOnMissingOption(['config']);

  if (!this.shelljs._('test', '-f', this.options.config)) {
    this.stderr('config file not found: %s', this.options.config);
  }

  this.stdout('using config file: %s', this.clc.green(this.options.config));

  // ...
};

Pass arguments from bin/myproj to the lib/cli/myproj.js

// bin/myproj
bin.run(require('commander'), require('./lib/cli/myproj'), 1, 2, 3);

// lib/cli/myproj.js
exports.run = function() {
  console.log([].slice.call(arguments)); // [1, 2, 3]
};

Installation

NPM

npm install impulse-bin

Documentation

License

MIT

Tests

npm test
npm loves you