command-line-commands/dist/index.cjs

Add a git-like command interface to your app.

'use strict';

var arrayify = require('array-back');

/**
 * A module for testing for and extracting names from options (e.g. `--one`, `-o`)
 */

class Arg {
  constructor (re) {
    this.re = re;
  }

  test (arg) {
    return this.re.test(arg)
  }
}

const isShort = new Arg(/^-([^\d-])$/);
const isLong = new Arg(/^--(\S+)/);
const isCombined = new Arg(/^-([^\d-]{2,})$/);
const isOption = function (arg) {
  return isShort.test(arg) || isLong.test(arg) || isCombined.test(arg)
};

/**
 * @module command-line-commands
 * @example
 * const commandLineCommands = require('command-line-commands')
 */

/**
 * Parses the `argv` value supplied (or `process.argv` by default), extracting and returning the `command` and remainder of `argv`. The command will be the first value in the `argv` array unless it is an option (e.g. `--help`).
 *
 * @param {string|string[]} - One or more command strings, one of which the user must supply. Include `null` to represent "no command" (effectively making a command optional).
 * @param [argv] {string[]} - An argv array, defaults to the global `process.argv` if not supplied.
 * @returns {{ command: string, argv: string[] }}
 * @throws `INVALID_COMMAND` - user supplied a command not specified in `commands`.
 * @alias module:command-line-commands
 */
function commandLineCommands (commands, argv) {
  if (!commands || (Array.isArray(commands) && !commands.length)) {
    throw new Error('Please supply one or more commands')
  }
  if (argv) {
    argv = arrayify(argv);
  } else {
    /* if no argv supplied, assume we are parsing process.argv. */
    /* never modify the global process.argv directly. */
    argv = process.argv.slice(0);
    argv.splice(0, 2);
  }

  /* the command is the first arg, unless it's an option (e.g. --help) */
  const command = (isOption(argv[0]) || !argv.length) ? null : argv.shift();

  if (arrayify(commands).indexOf(command) === -1) {
    const err = new Error('Command not recognised: ' + command);
    err.command = command;
    err.name = 'INVALID_COMMAND';
    throw err
  }

  return { command, argv }
}

module.exports = commandLineCommands;