2019-10-25 19:51:40 -04:00
|
|
|
namespace minimist {
|
|
|
|
export interface Opts {
|
|
|
|
/**
|
|
|
|
* A string or array of strings argument names to always treat as strings
|
|
|
|
*/
|
|
|
|
string?: string | string[];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A boolean, string or array of strings to always treat as booleans. If true will treat
|
|
|
|
* all double hyphenated arguments without equals signs as boolean (e.g. affects `--foo`, not `-f` or `--foo=bar`)
|
|
|
|
*/
|
|
|
|
boolean?: boolean | string | string[];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* An object mapping string names to strings or arrays of string argument names to use as aliases
|
|
|
|
*/
|
|
|
|
alias?: { [key: string]: string | string[] };
|
|
|
|
|
|
|
|
/**
|
|
|
|
* An object mapping string argument names to default values
|
|
|
|
*/
|
|
|
|
default?: { [key: string]: any };
|
|
|
|
|
|
|
|
/**
|
|
|
|
* When true, populate argv._ with everything after the first non-option
|
|
|
|
*/
|
|
|
|
stopEarly?: boolean;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A function which is invoked with a command line parameter not defined in the opts
|
|
|
|
* configuration object. If the function returns false, the unknown option is not added to argv
|
|
|
|
*/
|
|
|
|
unknown?: (arg: string) => boolean;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* When true, populate argv._ with everything before the -- and argv['--'] with everything after the --.
|
|
|
|
* Note that with -- set, parsing for arguments still stops after the `--`.
|
|
|
|
*/
|
|
|
|
'--'?: boolean;
|
|
|
|
}
|
|
|
|
|
|
|
|
export interface ParsedArgs {
|
|
|
|
[arg: string]: any;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* If opts['--'] is true, populated with everything after the --
|
|
|
|
*/
|
|
|
|
'--'?: string[];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Contains all the arguments that didn't have an option associated with them
|
|
|
|
*/
|
|
|
|
_: string[];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const parse = (args: string[], options: minimist.Opts) => {
|
|
|
|
options = options || {};
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let flags = { bools : {}, strings : {}, unknownFn: null, allBools: false };
|
2019-10-25 19:51:40 -04:00
|
|
|
|
|
|
|
if (typeof options['unknown'] === 'function') {
|
|
|
|
flags.unknownFn = options['unknown'];
|
|
|
|
}
|
|
|
|
|
|
|
|
if (typeof options['boolean'] === 'boolean' && options['boolean']) {
|
|
|
|
flags.allBools = true;
|
|
|
|
} else {
|
|
|
|
[].concat(options['boolean']).filter(Boolean).forEach(function (key) {
|
|
|
|
flags.bools[key] = true;
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let aliases = {};
|
2019-10-25 19:51:40 -04:00
|
|
|
Object.keys(options.alias || {}).forEach(function (key) {
|
|
|
|
aliases[key] = [].concat(options.alias[key]);
|
|
|
|
aliases[key].forEach(function (x) {
|
|
|
|
aliases[x] = [key].concat(aliases[key].filter(function (y) {
|
|
|
|
return x !== y;
|
|
|
|
}));
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
|
|
|
[].concat(options.string).filter(Boolean).forEach(function (key) {
|
|
|
|
flags.strings[key] = true;
|
|
|
|
if (aliases[key]) {
|
|
|
|
flags.strings[aliases[key]] = true;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let defaults = options['default'] || {};
|
2019-10-25 19:51:40 -04:00
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let argv = { _ : [] };
|
2019-10-25 19:51:40 -04:00
|
|
|
Object.keys(flags.bools).forEach(function (key) {
|
|
|
|
setArg(key, defaults[key] === undefined ? false : defaults[key]);
|
|
|
|
});
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let notFlags = [];
|
2019-10-25 19:51:40 -04:00
|
|
|
|
|
|
|
if (args.indexOf('--') !== -1) {
|
|
|
|
notFlags = args.slice(args.indexOf('--')+1);
|
|
|
|
args = args.slice(0, args.indexOf('--'));
|
|
|
|
}
|
|
|
|
|
|
|
|
function argDefined(key, arg) {
|
|
|
|
return (flags.allBools && /^--[^=]+$/.test(arg)) ||
|
|
|
|
flags.strings[key] || flags.bools[key] || aliases[key];
|
|
|
|
}
|
|
|
|
|
|
|
|
function setArg (key, val, arg?) {
|
|
|
|
if (arg && flags.unknownFn && !argDefined(key, arg)) {
|
|
|
|
if (flags.unknownFn(arg) === false) return;
|
|
|
|
}
|
|
|
|
|
|
|
|
var value = !flags.strings[key] && isNumber(val)
|
|
|
|
? Number(val) : val
|
|
|
|
;
|
|
|
|
setKey(argv, key.split('.'), value);
|
|
|
|
|
|
|
|
(aliases[key] || []).forEach(function (x) {
|
|
|
|
setKey(argv, x.split('.'), value);
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
function setKey (obj, keys, value) {
|
|
|
|
var o = obj;
|
|
|
|
keys.slice(0,-1).forEach(function (key) {
|
|
|
|
if (o[key] === undefined) o[key] = {};
|
|
|
|
o = o[key];
|
|
|
|
});
|
|
|
|
|
|
|
|
var key = keys[keys.length - 1];
|
|
|
|
if (o[key] === undefined || flags.bools[key] || typeof o[key] === 'boolean') {
|
|
|
|
o[key] = value;
|
|
|
|
}
|
|
|
|
else if (Array.isArray(o[key])) {
|
|
|
|
o[key].push(value);
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
o[key] = [ o[key], value ];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function aliasIsBoolean(key) {
|
|
|
|
return aliases[key].some(function (x) {
|
|
|
|
return flags.bools[x];
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
for (let i = 0; i < args.length; i++) {
|
|
|
|
let arg = args[i];
|
2019-10-25 19:51:40 -04:00
|
|
|
|
|
|
|
if (/^--.+=/.test(arg)) {
|
|
|
|
// Using [\s\S] instead of . because js doesn't support the
|
|
|
|
// 'dotall' regex modifier. See:
|
|
|
|
// http://stackoverflow.com/a/1068308/13216
|
2019-10-27 17:39:59 -04:00
|
|
|
let m = arg.match(/^--([^=]+)=([\s\S]*)$/);
|
|
|
|
let key = m[1];
|
|
|
|
let value: any = m[2];
|
2019-10-25 19:51:40 -04:00
|
|
|
if (flags.bools[key]) {
|
|
|
|
value = value !== 'false';
|
|
|
|
}
|
|
|
|
setArg(key, value, arg);
|
|
|
|
}
|
|
|
|
/*
|
|
|
|
else if (/^--no-.+/.test(arg)) {
|
|
|
|
var key = arg.match(/^--no-(.+)/)[1];
|
|
|
|
setArg(key, false, arg);
|
|
|
|
}
|
|
|
|
*/
|
|
|
|
else if (/^--.+/.test(arg)) {
|
2019-10-27 17:39:59 -04:00
|
|
|
let key = arg.match(/^--(.+)/)[1];
|
|
|
|
let next = args[i + 1];
|
2019-10-25 19:51:40 -04:00
|
|
|
if (next !== undefined && !/^-/.test(next)
|
|
|
|
&& !flags.bools[key]
|
|
|
|
&& !flags.allBools
|
|
|
|
&& (aliases[key] ? !aliasIsBoolean(key) : true)) {
|
|
|
|
setArg(key, next, arg);
|
|
|
|
i++;
|
|
|
|
}
|
|
|
|
else if (/^(true|false)$/.test(next)) {
|
|
|
|
setArg(key, next === 'true', arg);
|
|
|
|
i++;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
setArg(key, flags.strings[key] ? '' : true, arg);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else if (/^-[^-]+/.test(arg)) {
|
2019-10-27 17:39:59 -04:00
|
|
|
let letters = arg.slice(1,-1).split('');
|
2019-10-25 19:51:40 -04:00
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let broken = false;
|
|
|
|
for (let j = 0; j < letters.length; j++) {
|
|
|
|
let next = arg.slice(j+2);
|
2019-10-25 19:51:40 -04:00
|
|
|
|
|
|
|
if (next === '-') {
|
|
|
|
setArg(letters[j], next, arg)
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (/[A-Za-z]/.test(letters[j]) && /=/.test(next)) {
|
|
|
|
setArg(letters[j], next.split('=')[1], arg);
|
|
|
|
broken = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (/[A-Za-z]/.test(letters[j])
|
|
|
|
&& /-?\d+(\.\d*)?(e-?\d+)?$/.test(next)) {
|
|
|
|
setArg(letters[j], next, arg);
|
|
|
|
broken = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (letters[j+1] && letters[j+1].match(/\W/)) {
|
|
|
|
setArg(letters[j], arg.slice(j+2), arg);
|
|
|
|
broken = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
setArg(letters[j], flags.strings[letters[j]] ? '' : true, arg);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let key = arg.slice(-1)[0];
|
2019-10-25 19:51:40 -04:00
|
|
|
if (!broken && key !== '-') {
|
|
|
|
if (args[i+1] && !/^(-|--)[^-]/.test(args[i+1])
|
|
|
|
&& !flags.bools[key]
|
|
|
|
&& (aliases[key] ? !aliasIsBoolean(key) : true)) {
|
|
|
|
setArg(key, args[i+1], arg);
|
|
|
|
i++;
|
|
|
|
}
|
|
|
|
else if (args[i+1] && /true|false/.test(args[i+1])) {
|
|
|
|
setArg(key, args[i+1] === 'true', arg);
|
|
|
|
i++;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
setArg(key, flags.strings[key] ? '' : true, arg);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
if (!flags.unknownFn || flags.unknownFn(arg) !== false) {
|
|
|
|
argv._.push(
|
|
|
|
flags.strings['_'] || !isNumber(arg) ? arg : Number(arg)
|
|
|
|
);
|
|
|
|
}
|
|
|
|
if (options.stopEarly) {
|
|
|
|
argv._.push.apply(argv._, args.slice(i + 1));
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
Object.keys(defaults).forEach(function (key) {
|
|
|
|
if (!hasKey(argv, key.split('.'))) {
|
|
|
|
setKey(argv, key.split('.'), defaults[key]);
|
|
|
|
|
|
|
|
(aliases[key] || []).forEach(function (x) {
|
|
|
|
setKey(argv, x.split('.'), defaults[key]);
|
|
|
|
});
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
if (options['--']) {
|
2019-10-27 17:39:59 -04:00
|
|
|
argv['--'] = [];
|
2019-10-25 19:51:40 -04:00
|
|
|
notFlags.forEach(function(key) {
|
|
|
|
argv['--'].push(key);
|
|
|
|
});
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
notFlags.forEach(function(key) {
|
|
|
|
argv._.push(key);
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
return argv;
|
|
|
|
};
|
|
|
|
|
|
|
|
function hasKey (obj, keys) {
|
2019-10-27 17:39:59 -04:00
|
|
|
let o = obj;
|
2019-10-25 19:51:40 -04:00
|
|
|
keys.slice(0,-1).forEach(function (key) {
|
|
|
|
o = (o[key] || {});
|
|
|
|
});
|
|
|
|
|
2019-10-27 17:39:59 -04:00
|
|
|
let key = keys[keys.length - 1];
|
2019-10-25 19:51:40 -04:00
|
|
|
return key in o;
|
|
|
|
}
|
|
|
|
|
|
|
|
function isNumber (x) {
|
|
|
|
if (typeof x === 'number') return true;
|
|
|
|
if (/^0x[0-9a-f]+$/i.test(x)) return true;
|
|
|
|
return /^[-+]?(?:\d+(?:\.\d*)?|\.\d+)(e[-+]?\d+)?$/.test(x);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
function minimist<T>(args?: string[], opts?: minimist.Opts): T & minimist.ParsedArgs {
|
|
|
|
return parse(args || [], opts) as any;
|
|
|
|
}
|
|
|
|
export = minimist;
|