routie dev init since i didn't adhere to any proper guidance up until now

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

@@ -0,0 +1,243 @@
+/**
+ * @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)
+}