zhibo_2025/node_modules/npm-run-all2/bin/common/parse-cli-args.js

/**
 * @author Toru Nagashima
 * @copyright 2016 Toru Nagashima. All rights reserved.
 * See LICENSE file in root directory for full license.
 */
'use strict'

// ------------------------------------------------------------------------------
// Helpers
// ------------------------------------------------------------------------------

const OVERWRITE_OPTION = /^--([^:]+?):([^=]+?)(?:=(.+))?$/
const CONFIG_OPTION = /^--([^=]+?)(?:=(.+))$/
const PACKAGE_CONFIG_PATTERN = /^npm_package_config_(.+)$/
const CONCAT_OPTIONS = /^-[clnprs]+$/

/**
 * Overwrites a specified package config.
 *
 * @param {object} config - A config object to be overwritten.
 * @param {string} packageName - A package name to overwrite.
 * @param {string} variable - A variable name to overwrite.
 * @param {string} value - A new value to overwrite.
 * @returns {void}
 */
function overwriteConfig (config, packageName, variable, value) {
  const scope = config[packageName] || (config[packageName] = {})
  scope[variable] = value
}

/**
 * Creates a package config object.
 * This checks `process.env` and creates the default value.
 *
 * @returns {object} Created config object.
 */
function createPackageConfig () {
  const retv = {}
  const packageName = process.env.npm_package_name
  if (!packageName) {
    return retv
  }

  for (const key of Object.keys(process.env)) {
    const m = PACKAGE_CONFIG_PATTERN.exec(key)
    if (m != null) {
      overwriteConfig(retv, packageName, m[1], process.env[key])
    }
  }

  return retv
}

/**
 * Adds a new group into a given list.
 *
 * @param {object[]} groups - A group list to add.
 * @param {object} initialValues - A key-value map for the default of new value.
 * @returns {void}
 */
function addGroup (groups, initialValues) {
  groups.push(Object.assign(
    { parallel: false, patterns: [] },
    initialValues || {}
  ))
}

/**
 * ArgumentSet is values of parsed CLI arguments.
 * This class provides the getter to get the last group.
 */
class ArgumentSet {
  /**
     * @param {object} initialValues - A key-value map for the default of new value.
     * @param {object} options - A key-value map for the options.
     */
  constructor (initialValues, options) {
    this.config = {}
    this.continueOnError = false
    this.groups = []
    this.maxParallel = 0
    this.npmPath = null
    this.packageConfig = createPackageConfig()
    this.printLabel = false
    this.printName = false
    this.race = false
    this.rest = []
    this.silent = process.env.npm_config_loglevel === 'silent'
    this.singleMode = Boolean(options && options.singleMode)

    addGroup(this.groups, initialValues)
  }

  /**
     * Gets the last group.
     */
  get lastGroup () {
    return this.groups[this.groups.length - 1]
  }

  /**
     * Gets "parallel" flag.
     */
  get parallel () {
    return this.groups.some(g => g.parallel)
  }
}

/**
 * Parses CLI arguments.
 *
 * @param {ArgumentSet} set - The parsed CLI arguments.
 * @param {string[]} args - CLI arguments.
 * @returns {ArgumentSet} set itself.
 */
function parseCLIArgsCore (set, args) {
  LOOP: // eslint-disable-line no-labels
  for (let i = 0; i < args.length; ++i) {
    const arg = args[i]

    switch (arg) {
      case '--':
        set.rest = args.slice(1 + i)
        break LOOP // eslint-disable-line no-labels

      case '--color':
      case '--no-color':
        // do nothing.
        break

      case '-c':
      case '--continue-on-error':
        set.continueOnError = true
        break

      case '-l':
      case '--print-label':
        set.printLabel = true
        break

      case '-n':
      case '--print-name':
        set.printName = true
        break

      case '-r':
      case '--race':
        set.race = true
        break

      case '--silent':
        set.silent = true
        break

      case '--max-parallel':
        set.maxParallel = parseInt(args[++i], 10)
        if (!Number.isFinite(set.maxParallel) || set.maxParallel <= 0) {
          throw new Error(`Invalid Option: --max-parallel ${args[i]}`)
        }
        break

      case '-s':
      case '--sequential':
      case '--serial':
        if (set.singleMode && arg === '-s') {
          set.silent = true
          break
        }
        if (set.singleMode) {
          throw new Error(`Invalid Option: ${arg}`)
        }
        addGroup(set.groups)
        break

      case '--aggregate-output':
        set.aggregateOutput = true
        break

      case '-p':
      case '--parallel':
        if (set.singleMode) {
          throw new Error(`Invalid Option: ${arg}`)
        }
        addGroup(set.groups, { parallel: true })
        break

      case '--npm-path':
        set.npmPath = args[++i] || null
        break

      default: {
        let matched = null
        if ((matched = OVERWRITE_OPTION.exec(arg))) {
          overwriteConfig(
            set.packageConfig,
            matched[1],
            matched[2],
            matched[3] || args[++i]
          )
        } else if ((matched = CONFIG_OPTION.exec(arg))) {
          set.config[matched[1]] = matched[2]
        } else if (CONCAT_OPTIONS.test(arg)) {
          parseCLIArgsCore(
            set,
            arg.slice(1).split('').map(c => `-${c}`)
          )
        } else if (arg[0] === '-') {
          throw new Error(`Invalid Option: ${arg}`)
        } else {
          set.lastGroup.patterns.push(arg)
        }

        break
      }
    }
  }

  if (!set.parallel && set.aggregateOutput) {
    throw new Error('Invalid Option: --aggregate-output (without parallel)')
  }
  if (!set.parallel && set.race) {
    const race = args.indexOf('--race') !== -1 ? '--race' : '-r'
    throw new Error(`Invalid Option: ${race} (without parallel)`)
  }
  if (!set.parallel && set.maxParallel !== 0) {
    throw new Error('Invalid Option: --max-parallel (without parallel)')
  }

  return set
}

/**
 * Parses CLI arguments.
 *
 * @param {string[]} args - CLI arguments.
 * @param {object} initialValues - A key-value map for the default of new value.
 * @param {object} options - A key-value map for the options.
 * @param {boolean} options.singleMode - The flag to be single group mode.
 * @returns {ArgumentSet} The parsed CLI arguments.
 */
module.exports = function parseCLIArgs (args, initialValues, options) {
  return parseCLIArgsCore(new ArgumentSet(initialValues, options), args)
}