yargs 15.3.1 → 15.4.0

package/lib/completion.js

@@ -1,132 +0,0 @@
-'use strict'
-const path = require('path')
-
-// add bash completions to your
-//  yargs-powered applications.
-module.exports = function completion (yargs, usage, command) {
-  const self = {
-    completionKey: 'get-yargs-completions'
-  }
-
-  let aliases
-  self.setParsed = function setParsed (parsed) {
-    aliases = parsed.aliases
-  }
-
-  const zshShell = (process.env.SHELL && process.env.SHELL.indexOf('zsh') !== -1) ||
-    (process.env.ZSH_NAME && process.env.ZSH_NAME.indexOf('zsh') !== -1)
-  // get a list of completion commands.
-  // 'args' is the array of strings from the line to be completed
-  self.getCompletion = function getCompletion (args, done) {
-    const completions = []
-    const current = args.length ? args[args.length - 1] : ''
-    const argv = yargs.parse(args, true)
-    const parentCommands = yargs.getContext().commands
-
-    // a custom completion function can be provided
-    // to completion().
-    if (completionFunction) {
-      if (completionFunction.length < 3) {
-        const result = completionFunction(current, argv)
-
-        // promise based completion function.
-        if (typeof result.then === 'function') {
-          return result.then((list) => {
-            process.nextTick(() => { done(list) })
-          }).catch((err) => {
-            process.nextTick(() => { throw err })
-          })
-        }
-
-        // synchronous completion function.
-        return done(result)
-      } else {
-        // asynchronous completion function
-        return completionFunction(current, argv, (completions) => {
-          done(completions)
-        })
-      }
-    }
-
-    const handlers = command.getCommandHandlers()
-    for (let i = 0, ii = args.length; i < ii; ++i) {
-      if (handlers[args[i]] && handlers[args[i]].builder) {
-        const builder = handlers[args[i]].builder
-        if (typeof builder === 'function') {
-          const y = yargs.reset()
-          builder(y)
-          return y.argv
-        }
-      }
-    }
-
-    if (!current.match(/^-/) && parentCommands[parentCommands.length - 1] !== current) {
-      usage.getCommands().forEach((usageCommand) => {
-        const commandName = command.parseCommand(usageCommand[0]).cmd
-        if (args.indexOf(commandName) === -1) {
-          if (!zshShell) {
-            completions.push(commandName)
-          } else {
-            const desc = usageCommand[1] || ''
-            completions.push(commandName.replace(/:/g, '\\:') + ':' + desc)
-          }
-        }
-      })
-    }
-
-    if (current.match(/^-/) || (current === '' && completions.length === 0)) {
-      const descs = usage.getDescriptions()
-      const options = yargs.getOptions()
-      Object.keys(options.key).forEach((key) => {
-        const negable = !!options.configuration['boolean-negation'] && options.boolean.includes(key)
-        // If the key and its aliases aren't in 'args', add the key to 'completions'
-        let keyAndAliases = [key].concat(aliases[key] || [])
-        if (negable) keyAndAliases = keyAndAliases.concat(keyAndAliases.map(key => `no-${key}`))
-
-        function completeOptionKey (key) {
-          const notInArgs = keyAndAliases.every(val => args.indexOf(`--${val}`) === -1)
-          if (notInArgs) {
-            const startsByTwoDashes = s => /^--/.test(s)
-            const isShortOption = s => /^[^0-9]$/.test(s)
-            const dashes = !startsByTwoDashes(current) && isShortOption(key) ? '-' : '--'
-            if (!zshShell) {
-              completions.push(dashes + key)
-            } else {
-              const desc = descs[key] || ''
-              completions.push(dashes + `${key.replace(/:/g, '\\:')}:${desc.replace('__yargsString__:', '')}`)
-            }
-          }
-        }
-
-        completeOptionKey(key)
-        if (negable && !!options.default[key]) completeOptionKey(`no-${key}`)
-      })
-    }
-
-    done(completions)
-  }
-
-  // generate the completion script to add to your .bashrc.
-  self.generateCompletionScript = function generateCompletionScript ($0, cmd) {
-    const templates = require('./completion-templates')
-    let script = zshShell ? templates.completionZshTemplate : templates.completionShTemplate
-    const name = path.basename($0)
-
-    // add ./to applications not yet installed as bin.
-    if ($0.match(/\.js$/)) $0 = `./${$0}`
-
-    script = script.replace(/{{app_name}}/g, name)
-    script = script.replace(/{{completion_command}}/g, cmd)
-    return script.replace(/{{app_path}}/g, $0)
-  }
-
-  // register a function to perform your own custom
-  // completions., this function can be either
-  // synchrnous or asynchronous.
-  let completionFunction = null
-  self.registerFunction = (fn) => {
-    completionFunction = fn
-  }
-
-  return self
-}

package/lib/is-promise.js

@@ -1,3 +0,0 @@
-module.exports = function isPromise (maybePromise) {
-  return !!maybePromise && !!maybePromise.then && (typeof maybePromise.then === 'function')
-}

package/lib/middleware.js

@@ -1,64 +0,0 @@
-'use strict'
-
-// hoisted due to circular dependency on command.
-module.exports = {
-  applyMiddleware,
-  commandMiddlewareFactory,
-  globalMiddlewareFactory
-}
-const isPromise = require('./is-promise')
-const argsert = require('./argsert')
-
-function globalMiddlewareFactory (globalMiddleware, context) {
-  return function (callback, applyBeforeValidation = false) {
-    argsert('<array|function> [boolean]', [callback, applyBeforeValidation], arguments.length)
-    if (Array.isArray(callback)) {
-      for (let i = 0; i < callback.length; i++) {
-        if (typeof callback[i] !== 'function') {
-          throw Error('middleware must be a function')
-        }
-        callback[i].applyBeforeValidation = applyBeforeValidation
-      }
-      Array.prototype.push.apply(globalMiddleware, callback)
-    } else if (typeof callback === 'function') {
-      callback.applyBeforeValidation = applyBeforeValidation
-      globalMiddleware.push(callback)
-    }
-    return context
-  }
-}
-
-function commandMiddlewareFactory (commandMiddleware) {
-  if (!commandMiddleware) return []
-  return commandMiddleware.map(middleware => {
-    middleware.applyBeforeValidation = false
-    return middleware
-  })
-}
-
-function applyMiddleware (argv, yargs, middlewares, beforeValidation) {
-  const beforeValidationError = new Error('middleware cannot return a promise when applyBeforeValidation is true')
-  return middlewares
-    .reduce((accumulation, middleware) => {
-      if (middleware.applyBeforeValidation !== beforeValidation) {
-        return accumulation
-      }
-
-      if (isPromise(accumulation)) {
-        return accumulation
-          .then(initialObj =>
-            Promise.all([initialObj, middleware(initialObj, yargs)])
-          )
-          .then(([initialObj, middlewareObj]) =>
-            Object.assign(initialObj, middlewareObj)
-          )
-      } else {
-        const result = middleware(argv, yargs)
-        if (beforeValidation && isPromise(result)) throw beforeValidationError
-
-        return isPromise(result)
-          ? result.then(middlewareObj => Object.assign(accumulation, middlewareObj))
-          : Object.assign(accumulation, result)
-      }
-    }, argv)
-}

package/lib/obj-filter.js

@@ -1,11 +0,0 @@
-'use strict'
-module.exports = function objFilter (original, filter) {
-  const obj = {}
-  filter = filter || ((k, v) => true)
-  Object.keys(original || {}).forEach((key) => {
-    if (filter(key, original[key])) {
-      obj[key] = original[key]
-    }
-  })
-  return obj
-}

package/lib/process-argv.js

@@ -1,34 +0,0 @@
-function getProcessArgvBinIndex () {
-  // The binary name is the first command line argument for:
-  // - bundled Electron apps: bin argv1 argv2 ... argvn
-  if (isBundledElectronApp()) return 0
-  // or the second one (default) for:
-  // - standard node apps: node bin.js argv1 argv2 ... argvn
-  // - unbundled Electron apps: electron bin.js argv1 arg2 ... argvn
-  return 1
-}
-
-function isBundledElectronApp () {
-  // process.defaultApp is either set by electron in an electron unbundled app, or undefined
-  // see https://github.com/electron/electron/blob/master/docs/api/process.md#processdefaultapp-readonly
-  return isElectronApp() && !process.defaultApp
-}
-
-function isElectronApp () {
-  // process.versions.electron is either set by electron, or undefined
-  // see https://github.com/electron/electron/blob/master/docs/api/process.md#processversionselectron-readonly
-  return !!process.versions.electron
-}
-
-function getProcessArgvWithoutBin () {
-  return process.argv.slice(getProcessArgvBinIndex() + 1)
-}
-
-function getProcessArgvBin () {
-  return process.argv[getProcessArgvBinIndex()]
-}
-
-module.exports = {
-  getProcessArgvBin,
-  getProcessArgvWithoutBin
-}