minimist-options

Write options for minimist and yargs in a comfortable way. Supports string, boolean, number and array options.

Installation

$ npm install --save minimist-options

Usage

1const buildOptions = require('minimist-options');
2const minimist = require('minimist');
3
4const options = buildOptions({
5	name: {
6		type: 'string',
7		alias: 'n',
8		default: 'john'
9	},
10
11	force: {
12		type: 'boolean',
13		alias: ['f', 'o'],
14		default: false
15	},
16
17	score: {
18		type: 'number',
19		alias: 's',
20		default: 0
21	},
22
23	arr: {
24		type: 'array',
25		alias: 'a',
26		default: []
27	},
28
29	strings: {
30		type: 'string-array',
31		alias: 's',
32		default: ['a', 'b']
33	},
34
35	booleans: {
36		type: 'boolean-array',
37		alias: 'b',
38		default: [true, false]
39	},
40
41	numbers: {
42		type: 'number-array',
43		alias: 'n',
44		default: [0, 1]
45	},
46
47	published: 'boolean',
48
49	// Special option for positional arguments (`_` in minimist)
50	arguments: 'string'
51});
52
53const args = minimist(process.argv.slice(2), options);

instead of:

1const minimist = require('minimist');
2
3const options = {
4	string: ['name', '_'],
5	number: ['score'],
6	array: [
7		'arr',
8		{key: 'strings', string: true},
9		{key: 'booleans', boolean: true},
10		{key: 'numbers', number: true}
11	],
12	boolean: ['force', 'published'],
13	alias: {
14		n: 'name',
15		f: 'force',
16		s: 'score',
17		a: 'arr'
18	},
19	default: {
20		name: 'john',
21		f: false,
22		score: 0,
23		arr: []
24	}
25};
26
27const args = minimist(process.argv.slice(2), options);

Array options

The array types are only supported by yargs.

minimist does not explicitly support array type options. If you set an option multiple times, it will indeed yield an array of values. However, if you only set it once, it will simply give the value as is, without wrapping it in an array. Thus, effectively ignoring {type: 'array'}.

{type: 'array'} is shorthand for {type: 'string-array'}. To have values coerced to boolean or number, use boolean-array or number-array, respectively.

License

MIT © Vadim Demedes