SimpleArgs

Simple Command Line Arguments process, for Node.js.

Installation

Via npm on Node:

npm install simpleargs

Reference in your program:

var simpleargs = require('simpleargs');

Usage

var argv = simpleargs(process.argv.slice(2));
console.dir(argv);

Invoking the above example

node example.js -p 3000 -host localhost
{ p: 3000, host: 'localhost' }

Any additional argument without associated option goes to the _ array property:

node example.js -p 3000 -host localhost hello world
{ p: 3000, host: 'localhost', _: ['hello', 'world'] }

You can define options with short name, name, default value and description

simpleargs.define('p','port',3000,'Port number')
    .define('h','host','localhost', 'Host name/address')

// if you call the program
// node hello.js Hello world -p 4000 --host 'mydomain'        
var options = simpleargs(process.argv.slice(2));
// then options is { _: ['Hello', 'world'], port: 4000, host: 'mydomain' }

Development

git clone git://github.com/ajlopez/SimpleArgs.git
cd SimpleArgs
npm install
npm test

Samples

TBD

To do

• Invalid parameters
• Show usage

Versions

• 0.0.1: Initial version
• 0.0.2: Inspired by minimist
• 0.0.3: Flag support
• 0.0.4: Avoid parse big integers, returns them as strings
• 0.0.5: When no arguments, returned _ is an empty array

References

• Using Feature Flags or Feature Toggles with Node.js

Contribution

Feel free to file issues and submit pull requests � contributions are welcome.

If you submit a pull request, please be sure to add or update corresponding test cases, and ensure that npm test continues to pass.

(Thanks to JSON5 by aseemk. This file is based on that project README.md).