123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881 |
- const EventEmitter = require('events').EventEmitter;
- const spawn = require('child_process').spawn;
- const path = require('path');
- const fs = require('fs');
- class Option {
-
- constructor(flags, description) {
- this.flags = flags;
- this.required = flags.includes('<');
- this.optional = flags.includes('[');
-
- this.variadic = /\w\.\.\.[>\]]$/.test(flags);
- this.mandatory = false;
- const optionFlags = _parseOptionFlags(flags);
- this.short = optionFlags.shortFlag;
- this.long = optionFlags.longFlag;
- this.negate = false;
- if (this.long) {
- this.negate = this.long.startsWith('--no-');
- }
- this.description = description || '';
- this.defaultValue = undefined;
- }
-
- name() {
- if (this.long) {
- return this.long.replace(/^--/, '');
- }
- return this.short.replace(/^-/, '');
- };
-
- attributeName() {
- return camelcase(this.name().replace(/^no-/, ''));
- };
-
- is(arg) {
- return this.short === arg || this.long === arg;
- };
- }
- class CommanderError extends Error {
-
- constructor(exitCode, code, message) {
- super(message);
-
- Error.captureStackTrace(this, this.constructor);
- this.name = this.constructor.name;
- this.code = code;
- this.exitCode = exitCode;
- this.nestedError = undefined;
- }
- }
- class Command extends EventEmitter {
-
- constructor(name) {
- super();
- this.commands = [];
- this.options = [];
- this.parent = null;
- this._allowUnknownOption = false;
- this._args = [];
- this.rawArgs = null;
- this._scriptPath = null;
- this._name = name || '';
- this._optionValues = {};
- this._storeOptionsAsProperties = true;
- this._storeOptionsAsPropertiesCalled = false;
- this._passCommandToAction = true;
- this._actionResults = [];
- this._actionHandler = null;
- this._executableHandler = false;
- this._executableFile = null;
- this._defaultCommandName = null;
- this._exitCallback = null;
- this._aliases = [];
- this._combineFlagAndOptionalValue = true;
- this._hidden = false;
- this._hasHelpOption = true;
- this._helpFlags = '-h, --help';
- this._helpDescription = 'display help for command';
- this._helpShortFlag = '-h';
- this._helpLongFlag = '--help';
- this._hasImplicitHelpCommand = undefined;
- this._helpCommandName = 'help';
- this._helpCommandnameAndArgs = 'help [command]';
- this._helpCommandDescription = 'display help for command';
- }
-
- command(nameAndArgs, actionOptsOrExecDesc, execOpts) {
- let desc = actionOptsOrExecDesc;
- let opts = execOpts;
- if (typeof desc === 'object' && desc !== null) {
- opts = desc;
- desc = null;
- }
- opts = opts || {};
- const args = nameAndArgs.split(/ +/);
- const cmd = this.createCommand(args.shift());
- if (desc) {
- cmd.description(desc);
- cmd._executableHandler = true;
- }
- if (opts.isDefault) this._defaultCommandName = cmd._name;
- cmd._hidden = !!(opts.noHelp || opts.hidden);
- cmd._hasHelpOption = this._hasHelpOption;
- cmd._helpFlags = this._helpFlags;
- cmd._helpDescription = this._helpDescription;
- cmd._helpShortFlag = this._helpShortFlag;
- cmd._helpLongFlag = this._helpLongFlag;
- cmd._helpCommandName = this._helpCommandName;
- cmd._helpCommandnameAndArgs = this._helpCommandnameAndArgs;
- cmd._helpCommandDescription = this._helpCommandDescription;
- cmd._exitCallback = this._exitCallback;
- cmd._storeOptionsAsProperties = this._storeOptionsAsProperties;
- cmd._passCommandToAction = this._passCommandToAction;
- cmd._combineFlagAndOptionalValue = this._combineFlagAndOptionalValue;
- cmd._executableFile = opts.executableFile || null;
- this.commands.push(cmd);
- cmd._parseExpectedArgs(args);
- cmd.parent = this;
- if (desc) return this;
- return cmd;
- };
-
- createCommand(name) {
- return new Command(name);
- };
-
- addCommand(cmd, opts) {
- if (!cmd._name) throw new Error('Command passed to .addCommand() must have a name');
-
-
- function checkExplicitNames(commandArray) {
- commandArray.forEach((cmd) => {
- if (cmd._executableHandler && !cmd._executableFile) {
- throw new Error(`Must specify executableFile for deeply nested executable: ${cmd.name()}`);
- }
- checkExplicitNames(cmd.commands);
- });
- }
- checkExplicitNames(cmd.commands);
- opts = opts || {};
- if (opts.isDefault) this._defaultCommandName = cmd._name;
- if (opts.noHelp || opts.hidden) cmd._hidden = true;
- this.commands.push(cmd);
- cmd.parent = this;
- return this;
- };
-
- arguments(desc) {
- return this._parseExpectedArgs(desc.split(/ +/));
- };
-
- addHelpCommand(enableOrNameAndArgs, description) {
- if (enableOrNameAndArgs === false) {
- this._hasImplicitHelpCommand = false;
- } else {
- this._hasImplicitHelpCommand = true;
- if (typeof enableOrNameAndArgs === 'string') {
- this._helpCommandName = enableOrNameAndArgs.split(' ')[0];
- this._helpCommandnameAndArgs = enableOrNameAndArgs;
- }
- this._helpCommandDescription = description || this._helpCommandDescription;
- }
- return this;
- };
-
- _lazyHasImplicitHelpCommand() {
- if (this._hasImplicitHelpCommand === undefined) {
- this._hasImplicitHelpCommand = this.commands.length && !this._actionHandler && !this._findCommand('help');
- }
- return this._hasImplicitHelpCommand;
- };
-
- _parseExpectedArgs(args) {
- if (!args.length) return;
- args.forEach((arg) => {
- const argDetails = {
- required: false,
- name: '',
- variadic: false
- };
- switch (arg[0]) {
- case '<':
- argDetails.required = true;
- argDetails.name = arg.slice(1, -1);
- break;
- case '[':
- argDetails.name = arg.slice(1, -1);
- break;
- }
- if (argDetails.name.length > 3 && argDetails.name.slice(-3) === '...') {
- argDetails.variadic = true;
- argDetails.name = argDetails.name.slice(0, -3);
- }
- if (argDetails.name) {
- this._args.push(argDetails);
- }
- });
- this._args.forEach((arg, i) => {
- if (arg.variadic && i < this._args.length - 1) {
- throw new Error(`only the last argument can be variadic '${arg.name}'`);
- }
- });
- return this;
- };
-
- exitOverride(fn) {
- if (fn) {
- this._exitCallback = fn;
- } else {
- this._exitCallback = (err) => {
- if (err.code !== 'commander.executeSubCommandAsync') {
- throw err;
- } else {
-
- }
- };
- }
- return this;
- };
-
- _exit(exitCode, code, message) {
- if (this._exitCallback) {
- this._exitCallback(new CommanderError(exitCode, code, message));
-
- }
- process.exit(exitCode);
- };
-
- action(fn) {
- const listener = (args) => {
-
- const expectedArgsCount = this._args.length;
- const actionArgs = args.slice(0, expectedArgsCount);
- if (this._passCommandToAction) {
- actionArgs[expectedArgsCount] = this;
- } else {
- actionArgs[expectedArgsCount] = this.opts();
- }
-
- if (args.length > expectedArgsCount) {
- actionArgs.push(args.slice(expectedArgsCount));
- }
- const actionResult = fn.apply(this, actionArgs);
-
- let rootCommand = this;
- while (rootCommand.parent) {
- rootCommand = rootCommand.parent;
- }
- rootCommand._actionResults.push(actionResult);
- };
- this._actionHandler = listener;
- return this;
- };
-
- _checkForOptionNameClash(option) {
- if (!this._storeOptionsAsProperties || this._storeOptionsAsPropertiesCalled) {
-
- return;
- }
-
- if (option.name() === 'help') {
- return;
- }
- const commandProperty = this._getOptionValue(option.attributeName());
- if (commandProperty === undefined) {
-
- return;
- }
- let foundClash = true;
- if (option.negate) {
-
- const positiveLongFlag = option.long.replace(/^--no-/, '--');
- foundClash = !this._findOption(positiveLongFlag);
- } else if (option.long) {
- const negativeLongFlag = option.long.replace(/^--/, '--no-');
- foundClash = !this._findOption(negativeLongFlag);
- }
- if (foundClash) {
- throw new Error(`option '${option.name()}' clashes with existing property '${option.attributeName()}' on Command
- - call storeOptionsAsProperties(false) to store option values safely,
- - or call storeOptionsAsProperties(true) to suppress this check,
- - or change option name
- Read more on https://git.io/JJc0W`);
- }
- };
-
- _optionEx(config, flags, description, fn, defaultValue) {
- const option = new Option(flags, description);
- const oname = option.name();
- const name = option.attributeName();
- option.mandatory = !!config.mandatory;
- this._checkForOptionNameClash(option);
-
- if (typeof fn !== 'function') {
- if (fn instanceof RegExp) {
-
-
- const regex = fn;
- fn = (val, def) => {
- const m = regex.exec(val);
- return m ? m[0] : def;
- };
- } else {
- defaultValue = fn;
- fn = null;
- }
- }
-
- if (option.negate || option.optional || option.required || typeof defaultValue === 'boolean') {
-
- if (option.negate) {
- const positiveLongFlag = option.long.replace(/^--no-/, '--');
- defaultValue = this._findOption(positiveLongFlag) ? this._getOptionValue(name) : true;
- }
-
- if (defaultValue !== undefined) {
- this._setOptionValue(name, defaultValue);
- option.defaultValue = defaultValue;
- }
- }
-
- this.options.push(option);
-
-
- this.on('option:' + oname, (val) => {
- const oldValue = this._getOptionValue(name);
-
- if (val !== null && fn) {
- val = fn(val, oldValue === undefined ? defaultValue : oldValue);
- } else if (val !== null && option.variadic) {
- if (oldValue === defaultValue || !Array.isArray(oldValue)) {
- val = [val];
- } else {
- val = oldValue.concat(val);
- }
- }
-
- if (typeof oldValue === 'boolean' || typeof oldValue === 'undefined') {
-
- if (val == null) {
- this._setOptionValue(name, option.negate
- ? false
- : defaultValue || true);
- } else {
- this._setOptionValue(name, val);
- }
- } else if (val !== null) {
-
- this._setOptionValue(name, option.negate ? false : val);
- }
- });
- return this;
- };
-
- option(flags, description, fn, defaultValue) {
- return this._optionEx({}, flags, description, fn, defaultValue);
- };
-
- requiredOption(flags, description, fn, defaultValue) {
- return this._optionEx({ mandatory: true }, flags, description, fn, defaultValue);
- };
-
- combineFlagAndOptionalValue(arg) {
- this._combineFlagAndOptionalValue = (arg === undefined) || arg;
- return this;
- };
-
- allowUnknownOption(arg) {
- this._allowUnknownOption = (arg === undefined) || arg;
- return this;
- };
-
- storeOptionsAsProperties(value) {
- this._storeOptionsAsPropertiesCalled = true;
- this._storeOptionsAsProperties = (value === undefined) || value;
- if (this.options.length) {
- throw new Error('call .storeOptionsAsProperties() before adding options');
- }
- return this;
- };
-
- passCommandToAction(value) {
- this._passCommandToAction = (value === undefined) || value;
- return this;
- };
-
- _setOptionValue(key, value) {
- if (this._storeOptionsAsProperties) {
- this[key] = value;
- } else {
- this._optionValues[key] = value;
- }
- };
-
- _getOptionValue(key) {
- if (this._storeOptionsAsProperties) {
- return this[key];
- }
- return this._optionValues[key];
- };
-
- parse(argv, parseOptions) {
- if (argv !== undefined && !Array.isArray(argv)) {
- throw new Error('first parameter to parse must be array or undefined');
- }
- parseOptions = parseOptions || {};
-
- if (argv === undefined) {
- argv = process.argv;
-
- if (process.versions && process.versions.electron) {
- parseOptions.from = 'electron';
- }
- }
- this.rawArgs = argv.slice();
-
- let userArgs;
- switch (parseOptions.from) {
- case undefined:
- case 'node':
- this._scriptPath = argv[1];
- userArgs = argv.slice(2);
- break;
- case 'electron':
-
- if (process.defaultApp) {
- this._scriptPath = argv[1];
- userArgs = argv.slice(2);
- } else {
- userArgs = argv.slice(1);
- }
- break;
- case 'user':
- userArgs = argv.slice(0);
- break;
- default:
- throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
- }
- if (!this._scriptPath && process.mainModule) {
- this._scriptPath = process.mainModule.filename;
- }
-
- this._name = this._name || (this._scriptPath && path.basename(this._scriptPath, path.extname(this._scriptPath)));
-
- this._parseCommand([], userArgs);
- return this;
- };
-
- parseAsync(argv, parseOptions) {
- this.parse(argv, parseOptions);
- return Promise.all(this._actionResults).then(() => this);
- };
-
- _executeSubCommand(subcommand, args) {
- args = args.slice();
- let launchWithNode = false;
- const sourceExt = ['.js', '.ts', '.tsx', '.mjs'];
-
- this._checkForMissingMandatoryOptions();
-
- let scriptPath = this._scriptPath;
-
- if (!scriptPath && process.mainModule) {
- scriptPath = process.mainModule.filename;
- }
- let baseDir;
- try {
- const resolvedLink = fs.realpathSync(scriptPath);
- baseDir = path.dirname(resolvedLink);
- } catch (e) {
- baseDir = '.';
- }
-
- let bin = path.basename(scriptPath, path.extname(scriptPath)) + '-' + subcommand._name;
- if (subcommand._executableFile) {
- bin = subcommand._executableFile;
- }
- const localBin = path.join(baseDir, bin);
- if (fs.existsSync(localBin)) {
-
- bin = localBin;
- } else {
-
- sourceExt.forEach((ext) => {
- if (fs.existsSync(`${localBin}${ext}`)) {
- bin = `${localBin}${ext}`;
- }
- });
- }
- launchWithNode = sourceExt.includes(path.extname(bin));
- let proc;
- if (process.platform !== 'win32') {
- if (launchWithNode) {
- args.unshift(bin);
-
- args = incrementNodeInspectorPort(process.execArgv).concat(args);
- proc = spawn(process.argv[0], args, { stdio: 'inherit' });
- } else {
- proc = spawn(bin, args, { stdio: 'inherit' });
- }
- } else {
- args.unshift(bin);
-
- args = incrementNodeInspectorPort(process.execArgv).concat(args);
- proc = spawn(process.execPath, args, { stdio: 'inherit' });
- }
- const signals = ['SIGUSR1', 'SIGUSR2', 'SIGTERM', 'SIGINT', 'SIGHUP'];
- signals.forEach((signal) => {
-
- process.on(signal, () => {
- if (proc.killed === false && proc.exitCode === null) {
- proc.kill(signal);
- }
- });
- });
-
-
- const exitCallback = this._exitCallback;
- if (!exitCallback) {
- proc.on('close', process.exit.bind(process));
- } else {
- proc.on('close', () => {
- exitCallback(new CommanderError(process.exitCode || 0, 'commander.executeSubCommandAsync', '(close)'));
- });
- }
- proc.on('error', (err) => {
-
- if (err.code === 'ENOENT') {
- const executableMissing = `'${bin}' does not exist
- - if '${subcommand._name}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
- - if the default executable name is not suitable, use the executableFile option to supply a custom name`;
- throw new Error(executableMissing);
-
- } else if (err.code === 'EACCES') {
- throw new Error(`'${bin}' not executable`);
- }
- if (!exitCallback) {
- process.exit(1);
- } else {
- const wrappedError = new CommanderError(1, 'commander.executeSubCommandAsync', '(error)');
- wrappedError.nestedError = err;
- exitCallback(wrappedError);
- }
- });
-
- this.runningCommand = proc;
- };
-
- _dispatchSubcommand(commandName, operands, unknown) {
- const subCommand = this._findCommand(commandName);
- if (!subCommand) this._helpAndError();
- if (subCommand._executableHandler) {
- this._executeSubCommand(subCommand, operands.concat(unknown));
- } else {
- subCommand._parseCommand(operands, unknown);
- }
- };
-
- _parseCommand(operands, unknown) {
- const parsed = this.parseOptions(unknown);
- operands = operands.concat(parsed.operands);
- unknown = parsed.unknown;
- this.args = operands.concat(unknown);
- if (operands && this._findCommand(operands[0])) {
- this._dispatchSubcommand(operands[0], operands.slice(1), unknown);
- } else if (this._lazyHasImplicitHelpCommand() && operands[0] === this._helpCommandName) {
- if (operands.length === 1) {
- this.help();
- } else {
- this._dispatchSubcommand(operands[1], [], [this._helpLongFlag]);
- }
- } else if (this._defaultCommandName) {
- outputHelpIfRequested(this, unknown);
- this._dispatchSubcommand(this._defaultCommandName, operands, unknown);
- } else {
- if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
-
- this._helpAndError();
- }
- outputHelpIfRequested(this, parsed.unknown);
- this._checkForMissingMandatoryOptions();
- if (parsed.unknown.length > 0) {
- this.unknownOption(parsed.unknown[0]);
- }
- if (this._actionHandler) {
- const args = this.args.slice();
- this._args.forEach((arg, i) => {
- if (arg.required && args[i] == null) {
- this.missingArgument(arg.name);
- } else if (arg.variadic) {
- args[i] = args.splice(i);
- }
- });
- this._actionHandler(args);
- this.emit('command:' + this.name(), operands, unknown);
- } else if (operands.length) {
- if (this._findCommand('*')) {
- this._dispatchSubcommand('*', operands, unknown);
- } else if (this.listenerCount('command:*')) {
- this.emit('command:*', operands, unknown);
- } else if (this.commands.length) {
- this.unknownCommand();
- }
- } else if (this.commands.length) {
-
- this._helpAndError();
- } else {
-
- }
- }
- };
-
- _findCommand(name) {
- if (!name) return undefined;
- return this.commands.find(cmd => cmd._name === name || cmd._aliases.includes(name));
- };
-
- _findOption(arg) {
- return this.options.find(option => option.is(arg));
- };
-
- _checkForMissingMandatoryOptions() {
-
- for (let cmd = this; cmd; cmd = cmd.parent) {
- cmd.options.forEach((anOption) => {
- if (anOption.mandatory && (cmd._getOptionValue(anOption.attributeName()) === undefined)) {
- cmd.missingMandatoryOptionValue(anOption);
- }
- });
- }
- };
-
- parseOptions(argv) {
- const operands = [];
- const unknown = [];
- let dest = operands;
- const args = argv.slice();
- function maybeOption(arg) {
- return arg.length > 1 && arg[0] === '-';
- }
-
- let activeVariadicOption = null;
- while (args.length) {
- const arg = args.shift();
-
- if (arg === '--') {
- if (dest === unknown) dest.push(arg);
- dest.push(...args);
- break;
- }
- if (activeVariadicOption && !maybeOption(arg)) {
- this.emit(`option:${activeVariadicOption.name()}`, arg);
- continue;
- }
- activeVariadicOption = null;
- if (maybeOption(arg)) {
- const option = this._findOption(arg);
-
- if (option) {
- if (option.required) {
- const value = args.shift();
- if (value === undefined) this.optionMissingArgument(option);
- this.emit(`option:${option.name()}`, value);
- } else if (option.optional) {
- let value = null;
-
- if (args.length > 0 && !maybeOption(args[0])) {
- value = args.shift();
- }
- this.emit(`option:${option.name()}`, value);
- } else {
- this.emit(`option:${option.name()}`);
- }
- activeVariadicOption = option.variadic ? option : null;
- continue;
- }
- }
-
- if (arg.length > 2 && arg[0] === '-' && arg[1] !== '-') {
- const option = this._findOption(`-${arg[1]}`);
- if (option) {
- if (option.required || (option.optional && this._combineFlagAndOptionalValue)) {
-
- this.emit(`option:${option.name()}`, arg.slice(2));
- } else {
-
- this.emit(`option:${option.name()}`);
- args.unshift(`-${arg.slice(2)}`);
- }
- continue;
- }
- }
-
- if (/^--[^=]+=/.test(arg)) {
- const index = arg.indexOf('=');
- const option = this._findOption(arg.slice(0, index));
- if (option && (option.required || option.optional)) {
- this.emit(`option:${option.name()}`, arg.slice(index + 1));
- continue;
- }
- }
-
- if (arg.length > 1 && arg[0] === '-') {
- dest = unknown;
- }
-
- dest.push(arg);
- }
- return { operands, unknown };
- };
-
- opts() {
- if (this._storeOptionsAsProperties) {
-
- const result = {};
- const len = this.options.length;
- for (let i = 0; i < len; i++) {
- const key = this.options[i].attributeName();
- result[key] = key === this._versionOptionName ? this._version : this[key];
- }
- return result;
- }
- return this._optionValues;
- };
-
- missingArgument(name) {
- const message = `error: missing required argument '${name}'`;
- console.error(message);
- this._exit(1, 'commander.missingArgument', message);
- };
-
- optionMissingArgument(option, flag) {
- let message;
- if (flag) {
- message = `error: option '${option.flags}' argument missing, got '${flag}'`;
- } else {
- message = `error: option '${option.flags}' argument missing`;
- }
- console.error(message);
- this._exit(1, 'commander.optionMissingArgument', message);
- };
-
- missingMandatoryOptionValue(option) {
- const message = `error: required option '${option.flags}' not specified`;
- console.error(message);
- this._exit(1, 'commander.missingMandatoryOptionValue', message);
- };
-
- unknownOption(flag) {
- if (this._allowUnknownOption) return;
- const message = `error: unknown option '${flag}'`;
- console.error(message);
- this._exit(1, 'commander.unknownOption', message);
- };
-
- unknownCommand() {
- const partCommands = [this.name()];
- for (let parentCmd = this.parent; parentCmd; parentCmd = parentCmd.parent) {
- partCommands.unshift(parentCmd.name());
- }
- const fullCommand = partCommands.join(' ');
- const message = `error: unknown command '${this.args[0]}'.` +
- (this._hasHelpOption ? ` See '${fullCommand} ${this._helpLongFlag}'.` : '');
- console.error(message);
- this._exit(1, 'commander.unknownCommand', message);
- };
-
- version(str, flags, description) {
- if (str === undefined) return this._version;
- this._version = str;
- flags = flags || '-V, --version';
- description = description || 'output the version number';
- const versionOption = new Option(flags, description);
- this._versionOptionName = versionOption.attributeName();
- this.options.push(versionOption);
- this.on('option:' + versionOption.name(), () => {
- process.stdout.write(str + '\n');
- this._exit(0, 'commander.version', str);
- });
- return this;
- };
-
- description(str, argsDescription) {
- if (str === undefined && argsDescription === undefined) return this._description;
- this._description = str;
- this._argsDescription = argsDescription;
- return this;
- };
-
- alias(alias) {
- if (alias === undefined) return this._aliases[0];
- let command = this;
- if (this.commands.length !== 0 && this.commands[this.commands.length - 1]._executableHandler) {
-
- command = this.commands[this.commands.length - 1];
- }
- if (alias === command._name) throw new Error('Command alias can\'t be the same as its name');
- command._aliases.push(alias);
- return this;
- };
-
- aliases(aliases) {
-
- if (aliases === undefined) return this._aliases;
- aliases.forEach((alias) => this.alias(alias));
- return this;
- };
-
- usage(str) {
- if (str === undefined) {
- if (this._usage) return this._usage;
- const args = this._args.map((arg) => {
- return humanReadableArgName(arg);
- });
- return [].concat(
- (this.options.length || this._hasHelpOption ? '[options]' : []),
- (this.commands.length ? '[command]' : []),
- (this._args.length ? args : [])
- ).join(' ');
- }
- this._usage = str;
- return this;
- };
-
- name(str) {
- if (str === undefined) return this._name;
- this._name = str;
- return this;
- };
-
- prepareCommands() {
- const commandDetails = this.commands.filter((cmd) => {
- return !cmd._hidden;
- }).map((cmd) => {
- const args = cmd._args.map((arg) => {
- return humanReadableArgName(arg);
- }).join(' ');
- return [
- cmd._name +
- (cmd._aliases[0] ? '|' + cmd._aliases[0] : '') +
- (cmd.options.length ? ' [options]' : '') +
- (args ? ' ' + args : ''),
- cmd._description
- ];
- });
- if (this._lazyHasImplicitHelpCommand()) {
- commandDetails.push([this._helpCommandnameAndArgs, this._helpCommandDescription]);
- }
- return commandDetails;
- };
-
- largestCommandLength() {
- const commands = this.prepareCommands();
- return commands.reduce((max, command) => {
- return Math.max(max, command[0].length);
- }, 0);
- };
-
- largestOptionLength() {
- const options = [].slice.call(this.options);
- options.push({
- flags: this._helpFlags
- });
- return options.reduce((max, option) => {
- return Math.max(max, option.flags.length);
- }, 0);
- };
-
- largestArgLength() {
- return this._args.reduce((max, arg) => {
- return Math.max(max, arg.name.length);
- }, 0);
- };
-
- padWidth() {
- let width = this.largestOptionLength();
- if (this._argsDescription && this._args.length) {
- if (this.largestArgLength() > width) {
- width = this.largestArgLength();
- }
- }
- if (this.commands && this.commands.length) {
- if (this.largestCommandLength() > width) {
- width = this.largestCommandLength();
- }
- }
- return width;
- };
-
- optionHelp() {
- const width = this.padWidth();
- const columns = process.stdout.columns || 80;
- const descriptionWidth = columns - width - 4;
- function padOptionDetails(flags, description) {
- return pad(flags, width) + ' ' + optionalWrap(description, descriptionWidth, width + 2);
- };
-
- const help = this.options.map((option) => {
- const fullDesc = option.description +
- ((!option.negate && option.defaultValue !== undefined) ? ' (default: ' + JSON.stringify(option.defaultValue) + ')' : '');
- return padOptionDetails(option.flags, fullDesc);
- });
-
- const showShortHelpFlag = this._hasHelpOption && this._helpShortFlag && !this._findOption(this._helpShortFlag);
- const showLongHelpFlag = this._hasHelpOption && !this._findOption(this._helpLongFlag);
- if (showShortHelpFlag || showLongHelpFlag) {
- let helpFlags = this._helpFlags;
- if (!showShortHelpFlag) {
- helpFlags = this._helpLongFlag;
- } else if (!showLongHelpFlag) {
- helpFlags = this._helpShortFlag;
- }
- help.push(padOptionDetails(helpFlags, this._helpDescription));
- }
- return help.join('\n');
- };
-
- commandHelp() {
- if (!this.commands.length && !this._lazyHasImplicitHelpCommand()) return '';
- const commands = this.prepareCommands();
- const width = this.padWidth();
- const columns = process.stdout.columns || 80;
- const descriptionWidth = columns - width - 4;
- return [
- 'Commands:',
- commands.map((cmd) => {
- const desc = cmd[1] ? ' ' + cmd[1] : '';
- return (desc ? pad(cmd[0], width) : cmd[0]) + optionalWrap(desc, descriptionWidth, width + 2);
- }).join('\n').replace(/^/gm, ' '),
- ''
- ].join('\n');
- };
-
- helpInformation() {
- let desc = [];
- if (this._description) {
- desc = [
- this._description,
- ''
- ];
- const argsDescription = this._argsDescription;
- if (argsDescription && this._args.length) {
- const width = this.padWidth();
- const columns = process.stdout.columns || 80;
- const descriptionWidth = columns - width - 5;
- desc.push('Arguments:');
- this._args.forEach((arg) => {
- desc.push(' ' + pad(arg.name, width) + ' ' + wrap(argsDescription[arg.name] || '', descriptionWidth, width + 4));
- });
- desc.push('');
- }
- }
- let cmdName = this._name;
- if (this._aliases[0]) {
- cmdName = cmdName + '|' + this._aliases[0];
- }
- let parentCmdNames = '';
- for (let parentCmd = this.parent; parentCmd; parentCmd = parentCmd.parent) {
- parentCmdNames = parentCmd.name() + ' ' + parentCmdNames;
- }
- const usage = [
- 'Usage: ' + parentCmdNames + cmdName + ' ' + this.usage(),
- ''
- ];
- let cmds = [];
- const commandHelp = this.commandHelp();
- if (commandHelp) cmds = [commandHelp];
- let options = [];
- if (this._hasHelpOption || this.options.length > 0) {
- options = [
- 'Options:',
- '' + this.optionHelp().replace(/^/gm, ' '),
- ''
- ];
- }
- return usage
- .concat(desc)
- .concat(options)
- .concat(cmds)
- .join('\n');
- };
-
- outputHelp(cb) {
- if (!cb) {
- cb = (passthru) => {
- return passthru;
- };
- }
- const cbOutput = cb(this.helpInformation());
- if (typeof cbOutput !== 'string' && !Buffer.isBuffer(cbOutput)) {
- throw new Error('outputHelp callback must return a string or a Buffer');
- }
- process.stdout.write(cbOutput);
- this.emit(this._helpLongFlag);
- };
-
- helpOption(flags, description) {
- if (typeof flags === 'boolean') {
- this._hasHelpOption = flags;
- return this;
- }
- this._helpFlags = flags || this._helpFlags;
- this._helpDescription = description || this._helpDescription;
- const helpFlags = _parseOptionFlags(this._helpFlags);
- this._helpShortFlag = helpFlags.shortFlag;
- this._helpLongFlag = helpFlags.longFlag;
- return this;
- };
-
- help(cb) {
- this.outputHelp(cb);
-
-
- this._exit(process.exitCode || 0, 'commander.help', '(outputHelp)');
- };
-
- _helpAndError() {
- this.outputHelp();
-
- this._exit(1, 'commander.help', '(outputHelp)');
- };
- };
- exports = module.exports = new Command();
- exports.program = exports;
- exports.Command = Command;
- exports.Option = Option;
- exports.CommanderError = CommanderError;
- function camelcase(flag) {
- return flag.split('-').reduce((str, word) => {
- return str + word[0].toUpperCase() + word.slice(1);
- });
- }
- function pad(str, width) {
- const len = Math.max(0, width - str.length);
- return str + Array(len + 1).join(' ');
- }
- function wrap(str, width, indent) {
- const regex = new RegExp('.{1,' + (width - 1) + '}([\\s\u200B]|$)|[^\\s\u200B]+?([\\s\u200B]|$)', 'g');
- const lines = str.match(regex) || [];
- return lines.map((line, i) => {
- if (line.slice(-1) === '\n') {
- line = line.slice(0, line.length - 1);
- }
- return ((i > 0 && indent) ? Array(indent + 1).join(' ') : '') + line.trimRight();
- }).join('\n');
- }
- function optionalWrap(str, width, indent) {
-
-
- if (str.match(/[\n]\s+/)) return str;
-
- const minWidth = 40;
- if (width < minWidth) return str;
- return wrap(str, width, indent);
- }
- function outputHelpIfRequested(cmd, args) {
- const helpOption = cmd._hasHelpOption && args.find(arg => arg === cmd._helpLongFlag || arg === cmd._helpShortFlag);
- if (helpOption) {
- cmd.outputHelp();
-
- cmd._exit(0, 'commander.helpDisplayed', '(outputHelp)');
- }
- }
- function humanReadableArgName(arg) {
- const nameOutput = arg.name + (arg.variadic === true ? '...' : '');
- return arg.required
- ? '<' + nameOutput + '>'
- : '[' + nameOutput + ']';
- }
- function _parseOptionFlags(flags) {
- let shortFlag;
- let longFlag;
-
-
- const flagParts = flags.split(/[ |,]+/);
- if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1])) shortFlag = flagParts.shift();
- longFlag = flagParts.shift();
-
- if (!shortFlag && /^-[^-]$/.test(longFlag)) {
- shortFlag = longFlag;
- longFlag = undefined;
- }
- return { shortFlag, longFlag };
- }
- function incrementNodeInspectorPort(args) {
-
-
-
-
- return args.map((arg) => {
- if (!arg.startsWith('--inspect')) {
- return arg;
- }
- let debugOption;
- let debugHost = '127.0.0.1';
- let debugPort = '9229';
- let match;
- if ((match = arg.match(/^(--inspect(-brk)?)$/)) !== null) {
-
- debugOption = match[1];
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+)$/)) !== null) {
- debugOption = match[1];
- if (/^\d+$/.test(match[3])) {
-
- debugPort = match[3];
- } else {
-
- debugHost = match[3];
- }
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/)) !== null) {
-
- debugOption = match[1];
- debugHost = match[3];
- debugPort = match[4];
- }
- if (debugOption && debugPort !== '0') {
- return `${debugOption}=${debugHost}:${parseInt(debugPort) + 1}`;
- }
- return arg;
- });
- }
|