❤
npm
Sign UpSign In

baker-js

1.1.1 • Public • Published

baker

Baker lets you easily add a command line interface to your node scripts. It is inspired by python baker library (https://pypi.python.org/pypi/Baker/1.3)

Install

npm install baker-js

Usage

examples/basic.js

const baker = require('baker-js');
 
function run(a, b, c) {
  console.log("Run", a, b, c);
}
 
function tester(a, rest, options) {
  console.log("Test", a, rest, options);
}
 
 
if (require.main === module) {
  baker.command(tester, { command: "test", args: "rest", opts: "options" });
  baker.command(run, { default: true, required: ["a"] });
 
  baker.run();
}

output

$ node examples/basic.js --help
Usage: basic.js COMMAND <options>
Available commands: 
    test
    run

$ node examples/basic.js run --help
Usage: basic.js, run a <b> <c>

Required Arguments:
  a
Options:
  --b
  --c

$ node examples/basic.js run 1 2 3
Run 1 2 3

$ node examples/basic.js test 1 2 3 4 --five 5 --six 6 7
Test 1 [ 2, 3, 4, 7 ] { five: 5, six: 6 }

Options

baker.command(func, options)
@param Function func
@param Object options
@param String options.command name of command, defaults to function name.  Requried for anonymous functions.
@param Boolean options.default If true this function will run if no command name given on command line.
@param Array options.required List of requried args.  Script will eixt with error if arg not found on command line.
@param String options.opts Name of parameter to recieve object with all unmatche named commandline args.
@param String options.args Name of parameter to recieve an array of unmatched positional command line args.

Promises

When a promise is returned by the command function baker will wait till the promise is resolved and return the result of the promise

const baker = require('baker-js');
const request = require('request-promise');
 
function run() {
  return request('https://github.com/gabe0x02/baker-js').then((body) => {
    return `${body.trim().substring(0, 15)}...`;
  });
}
 
if (require.main === module) {
  baker.command(run, { default: true });
  baker.run();
}

output

$ node examples/promise.js 
<!DOCTYPE html>...

Generators

Baker also supports co generator flow control. (https://github.com/tj/co) Simply pass in a generator and write some synchronous looking code..

generator_example.js

const baker = require('baker-js');
const request = require('request-promise');
 
function *run() {
  const start = new Date();
  console.log("Start");
  const body = yield request('https://github.com/gabe0x02/baker-js');
  console.log("End");
  console.log("Length:", body.length, "chars");
  console.log("Duration:", new Date() - start, "ms");
 
  return `${body.trim().substring(0, 15)}...`;
}
 
if (require.main === module) {
  baker.command(run, { default: true });
  baker.run();
}

output

$ node examples/generator.js 
Start
End
Length: 56287 chars
Duration: 744 ms
<!DOCTYPE html>...

TODO

  • More testing in could be useful.
  • Better usage output
  • Allow argument descriptions in usage
  • Better documentation of options. args, opts, default, etc
  • post to npm

Readme

Keywords

Package Sidebar

Install

npm i baker-js

Repository

github.com/gabe0x02/baker-js

Homepage

github.com/gabe0x02/baker-js#readme

Weekly Downloads

1,276

Version

1.1.1

License

ISC

Unpacked Size

30.6 kB

Total Files

16

Last publish

Collaborators

  • gabe0x02
Try on RunKit
Report malware