rminimist
Parse argument options
This works exactly like minimist, with a few exceptions (see difference with minimist).
Usage
npm install --save rminimist
var argv = processargv
API
rminimist
rminimist(args, [options])
Return an argument object argv populated with the array arguments from args
.
argv._
contains all the arguments that didn't have an option associated with them.
Any arguments after --
will not be parsed and will end up in argv._
.
Options can be:
opts.string
- an array of strings argument names to always treat as stringsopts.boolean
- an array of strings to always treat as booleans.opts.array
- an array of strings to treat as arrays. (only in rminimist)opts.number
- an array of strings to treat as numbers. (only in rminimist)opts.alias
- an object mapping string names to strings or arrays of string argument names to use as aliasesopts.default
- an object mapping string argument names to default valuesopts.stopEarly
- when true, populate argv._ with everything after the first non-optionopts['--']
- when true, populate argv._ with everything before the -- and argv['--'] with everything after the --.
See minimist for more details and examples.
Difference with minimist
rminimist tries to be less "smart" than minimist. While minimist is often usable with minimal options, rminimist prefers you to be explicit.
-
Aliases are not duplicated. They will always resolve to the canonical version.
// minimist_: f: 'document.txt' file: 'document.txt'// rminimist_: file: 'document.txt' -
The syntax
-n4
(short flag + number) is not supported. This improves compatibility with number flags (eg,-1
).// minimist_: n: 4// rminimist'4': true _: n: true -
Booleans don't default to
false
. They're simply not defined if not present.// minimist_: debug: true verbose: false// rminimist_: debug: true -
Values are overridden, not appended as an array. Use the
array
option to explicitly enable the array behavior.// minimist_: watch: 'lib' 'test'// rminimist_: watch: 'test' -
A new option
array
is introduced to make values into an array.// rminimist_: watch: 'lib' 'test' -
Order is always preserved (except for numeric keys).
// minimist_: file: 'doc.txt' a: true// rminimist_: a: true file: 'doc.txt' -
Number-like values are never auto-cast to numbers. Use the
number
option instead.// minimist_: port: 4000// rminimist_: port: '4000'_: port: 4000 -
boolean: true
andstring: true
are not supported. Use the array syntax instead.// minimist// rminimist -
The
unknown
option is not supported.
Thanks
rminimist © 2016+, Rico Sta. Cruz. Released under the MIT License.
Authored and maintained by Rico Sta. Cruz with help from contributors (list).
ricostacruz.com · GitHub @rstacruz · Twitter @rstacruz