eoapi-cdk 7.0.0 → 7.0.1

package/node_modules/module/node_modules/yargs/yargs.js

@@ -1,730 +0,0 @@
-var assert = require('assert')
-var assign = require('lodash.assign')
-var Command = require('./lib/command')
-var Completion = require('./lib/completion')
-var Parser = require('yargs-parser')
-var path = require('path')
-var Usage = require('./lib/usage')
-var Validation = require('./lib/validation')
-var Y18n = require('y18n')
-var readPkgUp = require('read-pkg-up')
-var pkgConf = require('pkg-conf')
-var requireMainFilename = require('require-main-filename')
-var objFilter = require('./lib/obj-filter')
-
-var exports = module.exports = Yargs
-function Yargs (processArgs, cwd, parentRequire) {
-  processArgs = processArgs || [] // handle calling yargs().
-
-  var self = {}
-  var command = null
-  var completion = null
-  var groups = {}
-  var preservedGroups = {}
-  var usage = null
-  var validation = null
-  var y18n = Y18n({
-    directory: path.resolve(__dirname, './locales'),
-    updateFiles: false
-  })
-
-  if (!cwd) cwd = process.cwd()
-
-  self.$0 = process.argv
-    .slice(0, 2)
-    .map(function (x, i) {
-      // ignore the node bin, specify this in your
-      // bin file with #!/usr/bin/env node
-      if (i === 0 && /\b(node|iojs)(\.exe)?$/.test(x)) return
-      var b = rebase(cwd, x)
-      return x.match(/^(\/|([a-zA-Z]:)?\\)/) && b.length < x.length ? b : x
-    })
-    .join(' ').trim()
-
-  if (process.env._ !== undefined && process.argv[1] === process.env._) {
-    self.$0 = process.env._.replace(
-      path.dirname(process.execPath) + '/', ''
-    )
-  }
-
-  // use context object to keep track of resets, subcommand execution, etc
-  // submodules should modify and check the state of context as necessary
-  var context = { resets: -1, commands: [] }
-  self.getContext = function () {
-    return context
-  }
-
-  // puts yargs back into an initial state. any keys
-  // that have been set to "global" will not be reset
-  // by this action.
-  var options
-  self.resetOptions = self.reset = function (aliases) {
-    context.resets++
-    aliases = aliases || {}
-    options = options || {}
-    // put yargs back into an initial state, this
-    // logic is used to build a nested command
-    // hierarchy.
-    var tmpOptions = {}
-    tmpOptions.global = options.global ? options.global : []
-
-    // if a key has been set as a global, we
-    // do not want to reset it or its aliases.
-    var globalLookup = {}
-    tmpOptions.global.forEach(function (g) {
-      globalLookup[g] = true
-      ;(aliases[g] || []).forEach(function (a) {
-        globalLookup[a] = true
-      })
-    })
-
-    // preserve groups containing global keys
-    preservedGroups = Object.keys(groups).reduce(function (acc, groupName) {
-      var keys = groups[groupName].filter(function (key) {
-        return key in globalLookup
-      })
-      if (keys.length > 0) {
-        acc[groupName] = keys
-      }
-      return acc
-    }, {})
-    // groups can now be reset
-    groups = {}
-
-    var arrayOptions = [
-      'array', 'boolean', 'string', 'requiresArg',
-      'count', 'normalize', 'number'
-    ]
-
-    var objectOptions = [
-      'narg', 'key', 'alias', 'default', 'defaultDescription',
-      'config', 'choices', 'demanded'
-    ]
-
-    arrayOptions.forEach(function (k) {
-      tmpOptions[k] = (options[k] || []).filter(function (k) {
-        return globalLookup[k]
-      })
-    })
-
-    objectOptions.forEach(function (k) {
-      tmpOptions[k] = objFilter(options[k], function (k, v) {
-        return globalLookup[k]
-      })
-    })
-
-    tmpOptions.envPrefix = undefined
-    options = tmpOptions
-
-    // if this is the first time being executed, create
-    // instances of all our helpers -- otherwise just reset.
-    usage = usage ? usage.reset(globalLookup) : Usage(self, y18n)
-    validation = validation ? validation.reset(globalLookup) : Validation(self, usage, y18n)
-    command = command ? command.reset() : Command(self, usage, validation)
-    if (!completion) completion = Completion(self, usage, command)
-
-    exitProcess = true
-    strict = false
-    completionCommand = null
-    self.parsed = false
-
-    return self
-  }
-  self.resetOptions()
-
-  self.boolean = function (bools) {
-    options.boolean.push.apply(options.boolean, [].concat(bools))
-    return self
-  }
-
-  self.array = function (arrays) {
-    options.array.push.apply(options.array, [].concat(arrays))
-    return self
-  }
-
-  self.nargs = function (key, n) {
-    if (typeof key === 'object') {
-      Object.keys(key).forEach(function (k) {
-        self.nargs(k, key[k])
-      })
-    } else {
-      options.narg[key] = n
-    }
-    return self
-  }
-
-  self.number = function (numbers) {
-    options.number.push.apply(options.number, [].concat(numbers))
-    return self
-  }
-
-  self.choices = function (key, values) {
-    if (typeof key === 'object') {
-      Object.keys(key).forEach(function (k) {
-        self.choices(k, key[k])
-      })
-    } else {
-      options.choices[key] = (options.choices[key] || []).concat(values)
-    }
-    return self
-  }
-
-  self.normalize = function (strings) {
-    options.normalize.push.apply(options.normalize, [].concat(strings))
-    return self
-  }
-
-  self.config = function (key, msg, parseFn) {
-    if (typeof msg === 'function') {
-      parseFn = msg
-      msg = null
-    }
-
-    key = key || 'config'
-    self.describe(key, msg || usage.deferY18nLookup('Path to JSON config file'))
-    ;(Array.isArray(key) ? key : [key]).forEach(function (k) {
-      options.config[k] = parseFn || true
-    })
-    return self
-  }
-
-  self.example = function (cmd, description) {
-    usage.example(cmd, description)
-    return self
-  }
-
-  self.command = function (cmd, description, builder, handler) {
-    command.addHandler(cmd, description, builder, handler)
-    return self
-  }
-
-  self.string = function (strings) {
-    options.string.push.apply(options.string, [].concat(strings))
-    return self
-  }
-
-  self.default = function (key, value, defaultDescription) {
-    if (typeof key === 'object') {
-      Object.keys(key).forEach(function (k) {
-        self.default(k, key[k])
-      })
-    } else {
-      if (defaultDescription) options.defaultDescription[key] = defaultDescription
-      if (typeof value === 'function') {
-        if (!options.defaultDescription[key]) options.defaultDescription[key] = usage.functionDescription(value)
-        value = value.call()
-      }
-      options.default[key] = value
-    }
-    return self
-  }
-
-  self.alias = function (x, y) {
-    if (typeof x === 'object') {
-      Object.keys(x).forEach(function (key) {
-        self.alias(key, x[key])
-      })
-    } else {
-      options.alias[x] = (options.alias[x] || []).concat(y)
-    }
-    return self
-  }
-
-  self.count = function (counts) {
-    options.count.push.apply(options.count, [].concat(counts))
-    return self
-  }
-
-  self.demand = self.required = self.require = function (keys, max, msg) {
-    // you can optionally provide a 'max' key,
-    // which will raise an exception if too many '_'
-    // options are provided.
-
-    if (Array.isArray(max)) {
-      max.forEach(function (key) {
-        self.demand(key, msg)
-      })
-      max = Infinity
-    } else if (typeof max !== 'number') {
-      msg = max
-      max = Infinity
-    }
-
-    if (typeof keys === 'number') {
-      if (!options.demanded._) options.demanded._ = { count: 0, msg: null, max: max }
-      options.demanded._.count = keys
-      options.demanded._.msg = msg
-    } else if (Array.isArray(keys)) {
-      keys.forEach(function (key) {
-        self.demand(key, msg)
-      })
-    } else {
-      if (typeof msg === 'string') {
-        options.demanded[keys] = { msg: msg }
-      } else if (msg === true || typeof msg === 'undefined') {
-        options.demanded[keys] = { msg: undefined }
-      }
-    }
-
-    return self
-  }
-
-  self.getDemanded = function () {
-    return options.demanded
-  }
-
-  self.requiresArg = function (requiresArgs) {
-    options.requiresArg.push.apply(options.requiresArg, [].concat(requiresArgs))
-    return self
-  }
-
-  self.implies = function (key, value) {
-    validation.implies(key, value)
-    return self
-  }
-
-  self.usage = function (msg, opts) {
-    if (!opts && typeof msg === 'object') {
-      opts = msg
-      msg = null
-    }
-
-    usage.usage(msg)
-
-    if (opts) self.options(opts)
-
-    return self
-  }
-
-  self.epilogue = self.epilog = function (msg) {
-    usage.epilog(msg)
-    return self
-  }
-
-  self.fail = function (f) {
-    usage.failFn(f)
-    return self
-  }
-
-  self.check = function (f) {
-    validation.check(f)
-    return self
-  }
-
-  self.defaults = self.default
-
-  self.describe = function (key, desc) {
-    options.key[key] = true
-    usage.describe(key, desc)
-    return self
-  }
-
-  self.global = function (globals) {
-    options.global.push.apply(options.global, [].concat(globals))
-    return self
-  }
-
-  self.pkgConf = function (key, path) {
-    var conf = null
-
-    var obj = readPkgUp.sync({
-      cwd: path || requireMainFilename(parentRequire || require)
-    })
-
-    if (obj.pkg && obj.pkg[key] && typeof obj.pkg[key] === 'object') {
-      conf = obj.pkg[key]
-      Object.keys(conf).forEach(function (k) {
-        self.default(k, conf[k])
-      })
-    }
-
-    return self
-  }
-
-  self.parse = function (args) {
-    return parseArgs(args)
-  }
-
-  self.option = self.options = function (key, opt) {
-    if (typeof key === 'object') {
-      Object.keys(key).forEach(function (k) {
-        self.options(k, key[k])
-      })
-    } else {
-      assert(typeof opt === 'object', 'second argument to option must be an object')
-
-      options.key[key] = true // track manually set keys.
-
-      if (opt.alias) self.alias(key, opt.alias)
-
-      var demand = opt.demand || opt.required || opt.require
-
-      if (demand) {
-        self.demand(key, demand)
-      } if ('config' in opt) {
-        self.config(key, opt.configParser)
-      } if ('default' in opt) {
-        self.default(key, opt.default)
-      } if ('nargs' in opt) {
-        self.nargs(key, opt.nargs)
-      } if ('normalize' in opt) {
-        self.normalize(key)
-      } if ('choices' in opt) {
-        self.choices(key, opt.choices)
-      } if ('group' in opt) {
-        self.group(key, opt.group)
-      } if (opt.global) {
-        self.global(key)
-      } if (opt.boolean || opt.type === 'boolean') {
-        self.boolean(key)
-        if (opt.alias) self.boolean(opt.alias)
-      } if (opt.array || opt.type === 'array') {
-        self.array(key)
-        if (opt.alias) self.array(opt.alias)
-      } if (opt.number || opt.type === 'number') {
-        self.number(key)
-        if (opt.alias) self.number(opt.alias)
-      } if (opt.string || opt.type === 'string') {
-        self.string(key)
-        if (opt.alias) self.string(opt.alias)
-      } if (opt.count || opt.type === 'count') {
-        self.count(key)
-      } if (opt.defaultDescription) {
-        options.defaultDescription[key] = opt.defaultDescription
-      }
-
-      var desc = opt.describe || opt.description || opt.desc
-      if (desc) {
-        self.describe(key, desc)
-      }
-
-      if (opt.requiresArg) {
-        self.requiresArg(key)
-      }
-    }
-
-    return self
-  }
-  self.getOptions = function () {
-    return options
-  }
-
-  self.group = function (opts, groupName) {
-    var existing = preservedGroups[groupName] || groups[groupName]
-    if (preservedGroups[groupName]) {
-      // the preserved group will be moved to the set of explicitly declared
-      // groups
-      delete preservedGroups[groupName]
-    }
-
-    var seen = {}
-    groups[groupName] = (existing || []).concat(opts).filter(function (key) {
-      if (seen[key]) return false
-      return (seen[key] = true)
-    })
-    return self
-  }
-  self.getGroups = function () {
-    // combine explicit and preserved groups. explicit groups should be first
-    return assign({}, groups, preservedGroups)
-  }
-
-  // as long as options.envPrefix is not undefined,
-  // parser will apply env vars matching prefix to argv
-  self.env = function (prefix) {
-    if (prefix === false) options.envPrefix = undefined
-    else options.envPrefix = prefix || ''
-    return self
-  }
-
-  self.wrap = function (cols) {
-    usage.wrap(cols)
-    return self
-  }
-
-  var strict = false
-  self.strict = function () {
-    strict = true
-    return self
-  }
-  self.getStrict = function () {
-    return strict
-  }
-
-  self.showHelp = function (level) {
-    if (!self.parsed) parseArgs(processArgs) // run parser, if it has not already been executed.
-    usage.showHelp(level)
-    return self
-  }
-
-  var versionOpt = null
-  self.version = function (opt, msg, ver) {
-    if (arguments.length === 0) {
-      ver = guessVersion()
-      opt = 'version'
-    } else if (arguments.length === 1) {
-      ver = opt
-      opt = 'version'
-    } else if (arguments.length === 2) {
-      ver = msg
-    }
-
-    versionOpt = opt
-    msg = msg || usage.deferY18nLookup('Show version number')
-
-    usage.version(ver || undefined)
-    self.boolean(versionOpt)
-    self.global(versionOpt)
-    self.describe(versionOpt, msg)
-    return self
-  }
-
-  function guessVersion () {
-    var obj = readPkgUp.sync({
-      cwd: requireMainFilename(parentRequire || require)
-    })
-
-    return obj.pkg ? obj.pkg.version : 'unknown'
-  }
-
-  var helpOpt = null
-  self.addHelpOpt = self.help = function (opt, msg) {
-    opt = opt || 'help'
-    helpOpt = opt
-    self.boolean(opt)
-    self.global(opt)
-    self.describe(opt, msg || usage.deferY18nLookup('Show help'))
-    return self
-  }
-
-  self.showHelpOnFail = function (enabled, message) {
-    usage.showHelpOnFail(enabled, message)
-    return self
-  }
-
-  var exitProcess = true
-  self.exitProcess = function (enabled) {
-    if (typeof enabled !== 'boolean') {
-      enabled = true
-    }
-    exitProcess = enabled
-    return self
-  }
-  self.getExitProcess = function () {
-    return exitProcess
-  }
-
-  var completionCommand = null
-  self.completion = function (cmd, desc, fn) {
-    // a function to execute when generating
-    // completions can be provided as the second
-    // or third argument to completion.
-    if (typeof desc === 'function') {
-      fn = desc
-      desc = null
-    }
-
-    // register the completion command.
-    completionCommand = cmd || 'completion'
-    if (!desc && desc !== false) {
-      desc = 'generate bash completion script'
-    }
-    self.command(completionCommand, desc)
-
-    // a function can be provided
-    if (fn) completion.registerFunction(fn)
-
-    return self
-  }
-
-  self.showCompletionScript = function ($0) {
-    $0 = $0 || self.$0
-    console.log(completion.generateCompletionScript($0))
-    return self
-  }
-
-  self.locale = function (locale) {
-    if (arguments.length === 0) {
-      guessLocale()
-      return y18n.getLocale()
-    }
-    detectLocale = false
-    y18n.setLocale(locale)
-    return self
-  }
-
-  self.updateStrings = self.updateLocale = function (obj) {
-    detectLocale = false
-    y18n.updateLocale(obj)
-    return self
-  }
-
-  var detectLocale = true
-  self.detectLocale = function (detect) {
-    detectLocale = detect
-    return self
-  }
-  self.getDetectLocale = function () {
-    return detectLocale
-  }
-
-  self.getUsageInstance = function () {
-    return usage
-  }
-
-  self.getValidationInstance = function () {
-    return validation
-  }
-
-  self.getCommandInstance = function () {
-    return command
-  }
-
-  self.terminalWidth = function () {
-    return require('window-size').width
-  }
-
-  Object.defineProperty(self, 'argv', {
-    get: function () {
-      var args = null
-
-      try {
-        args = parseArgs(processArgs)
-      } catch (err) {
-        usage.fail(err.message, err)
-      }
-
-      return args
-    },
-    enumerable: true
-  })
-
-  function parseArgs (args) {
-    options.__ = y18n.__
-    options.configuration = pkgConf.sync('yargs', {
-      defaults: {},
-      cwd: requireMainFilename(require)
-    })
-    var parsed = Parser.detailed(args, options)
-    var argv = parsed.argv
-    var aliases = parsed.aliases
-
-    argv.$0 = self.$0
-    self.parsed = parsed
-
-    guessLocale() // guess locale lazily, so that it can be turned off in chain.
-
-    // while building up the argv object, there
-    // are two passes through the parser. If completion
-    // is being performed short-circuit on the first pass.
-    if (completionCommand &&
-      (process.argv.join(' ')).indexOf(completion.completionKey) !== -1 &&
-      !argv[completion.completionKey]) {
-      return argv
-    }
-
-    // if there's a handler associated with a
-    // command defer processing to it.
-    var handlerKeys = command.getCommands()
-    for (var i = 0, cmd; (cmd = handlerKeys[i]) !== undefined; i++) {
-      if (~argv._.indexOf(cmd) && cmd !== completionCommand) {
-        setPlaceholderKeys(argv)
-        return command.runCommand(cmd, self, parsed)
-      }
-    }
-
-    // generate a completion script for adding to ~/.bashrc.
-    if (completionCommand && ~argv._.indexOf(completionCommand) && !argv[completion.completionKey]) {
-      self.showCompletionScript()
-      if (exitProcess) {
-        process.exit(0)
-      }
-    }
-
-    // we must run completions first, a user might
-    // want to complete the --help or --version option.
-    if (completion.completionKey in argv) {
-      // we allow for asynchronous completions,
-      // e.g., loading in a list of commands from an API.
-      completion.getCompletion(function (completions) {
-        ;(completions || []).forEach(function (completion) {
-          console.log(completion)
-        })
-
-        if (exitProcess) {
-          process.exit(0)
-        }
-      })
-      return
-    }
-
-    var helpOrVersion = false
-    Object.keys(argv).forEach(function (key) {
-      if (key === helpOpt && argv[key]) {
-        helpOrVersion = true
-        self.showHelp('log')
-        if (exitProcess) {
-          process.exit(0)
-        }
-      } else if (key === versionOpt && argv[key]) {
-        helpOrVersion = true
-        usage.showVersion()
-        if (exitProcess) {
-          process.exit(0)
-        }
-      }
-    })
-
-    // If the help or version options where used and exitProcess is false,
-    // we won't run validations
-    if (!helpOrVersion) {
-      if (parsed.error) throw parsed.error
-
-      // if we're executed via bash completion, don't
-      // bother with validation.
-      if (!argv[completion.completionKey]) {
-        validation.nonOptionCount(argv)
-        validation.missingArgumentValue(argv)
-        validation.requiredArguments(argv)
-        if (strict) validation.unknownArguments(argv, aliases)
-        validation.customChecks(argv, aliases)
-        validation.limitedChoices(argv)
-        validation.implications(argv)
-      }
-    }
-
-    setPlaceholderKeys(argv)
-
-    return argv
-  }
-
-  function guessLocale () {
-    if (!detectLocale) return
-
-    try {
-      var osLocale = require('os-locale')
-      self.locale(osLocale.sync({ spawn: false }))
-    } catch (err) {
-      // if we explode looking up locale just noop
-      // we'll keep using the default language 'en'.
-    }
-  }
-
-  function setPlaceholderKeys (argv) {
-    Object.keys(options.key).forEach(function (key) {
-      // don't set placeholder keys for dot
-      // notation options 'foo.bar'.
-      if (~key.indexOf('.')) return
-      if (typeof argv[key] === 'undefined') argv[key] = undefined
-    })
-  }
-
-  return self
-}
-
-// rebase an absolute path to a relative one with respect to a base directory
-// exported for tests
-exports.rebase = rebase
-function rebase (base, dir) {
-  return path.relative(base, dir)
-}