jishushell 0.6.5 → 0.6.18

package/node_modules/isexe/test/basic.js

@@ -1,221 +0,0 @@
-var t = require('tap')
-var fs = require('fs')
-var path = require('path')
-var fixture = path.resolve(__dirname, 'fixtures')
-var meow = fixture + '/meow.cat'
-var mine = fixture + '/mine.cat'
-var ours = fixture + '/ours.cat'
-var fail = fixture + '/fail.false'
-var noent = fixture + '/enoent.exe'
-var mkdirp = require('mkdirp')
-var rimraf = require('rimraf')
-
-var isWindows = process.platform === 'win32'
-var hasAccess = typeof fs.access === 'function'
-var winSkip = isWindows && 'windows'
-var accessSkip = !hasAccess && 'no fs.access function'
-var hasPromise = typeof Promise === 'function'
-var promiseSkip = !hasPromise && 'no global Promise'
-
-function reset () {
-  delete require.cache[require.resolve('../')]
-  return require('../')
-}
-
-t.test('setup fixtures', function (t) {
-  rimraf.sync(fixture)
-  mkdirp.sync(fixture)
-  fs.writeFileSync(meow, '#!/usr/bin/env cat\nmeow\n')
-  fs.chmodSync(meow, parseInt('0755', 8))
-  fs.writeFileSync(fail, '#!/usr/bin/env false\n')
-  fs.chmodSync(fail, parseInt('0644', 8))
-  fs.writeFileSync(mine, '#!/usr/bin/env cat\nmine\n')
-  fs.chmodSync(mine, parseInt('0744', 8))
-  fs.writeFileSync(ours, '#!/usr/bin/env cat\nours\n')
-  fs.chmodSync(ours, parseInt('0754', 8))
-  t.end()
-})
-
-t.test('promise', { skip: promiseSkip }, function (t) {
-  var isexe = reset()
-  t.test('meow async', function (t) {
-    isexe(meow).then(function (is) {
-      t.ok(is)
-      t.end()
-    })
-  })
-  t.test('fail async', function (t) {
-    isexe(fail).then(function (is) {
-      t.notOk(is)
-      t.end()
-    })
-  })
-  t.test('noent async', function (t) {
-    isexe(noent).catch(function (er) {
-      t.ok(er)
-      t.end()
-    })
-  })
-  t.test('noent ignore async', function (t) {
-    isexe(noent, { ignoreErrors: true }).then(function (is) {
-      t.notOk(is)
-      t.end()
-    })
-  })
-  t.end()
-})
-
-t.test('no promise', function (t) {
-  global.Promise = null
-  var isexe = reset()
-  t.throws('try to meow a promise', function () {
-    isexe(meow)
-  })
-  t.end()
-})
-
-t.test('access', { skip: accessSkip || winSkip }, function (t) {
-  runTest(t)
-})
-
-t.test('mode', { skip: winSkip }, function (t) {
-  delete fs.access
-  delete fs.accessSync
-  var isexe = reset()
-  t.ok(isexe.sync(ours, { uid: 0, gid: 0 }))
-  t.ok(isexe.sync(mine, { uid: 0, gid: 0 }))
-  runTest(t)
-})
-
-t.test('windows', function (t) {
-  global.TESTING_WINDOWS = true
-  var pathExt = '.EXE;.CAT;.CMD;.COM'
-  t.test('pathExt option', function (t) {
-    runTest(t, { pathExt: '.EXE;.CAT;.CMD;.COM' })
-  })
-  t.test('pathExt env', function (t) {
-    process.env.PATHEXT = pathExt
-    runTest(t)
-  })
-  t.test('no pathExt', function (t) {
-    // with a pathExt of '', any filename is fine.
-    // so the "fail" one would still pass.
-    runTest(t, { pathExt: '', skipFail: true })
-  })
-  t.test('pathext with empty entry', function (t) {
-    // with a pathExt of '', any filename is fine.
-    // so the "fail" one would still pass.
-    runTest(t, { pathExt: ';' + pathExt, skipFail: true })
-  })
-  t.end()
-})
-
-t.test('cleanup', function (t) {
-  rimraf.sync(fixture)
-  t.end()
-})
-
-function runTest (t, options) {
-  var isexe = reset()
-
-  var optionsIgnore = Object.create(options || {})
-  optionsIgnore.ignoreErrors = true
-
-  if (!options || !options.skipFail) {
-    t.notOk(isexe.sync(fail, options))
-  }
-  t.notOk(isexe.sync(noent, optionsIgnore))
-  if (!options) {
-    t.ok(isexe.sync(meow))
-  } else {
-    t.ok(isexe.sync(meow, options))
-  }
-
-  t.ok(isexe.sync(mine, options))
-  t.ok(isexe.sync(ours, options))
-  t.throws(function () {
-    isexe.sync(noent, options)
-  })
-
-  t.test('meow async', function (t) {
-    if (!options) {
-      isexe(meow, function (er, is) {
-        if (er) {
-          throw er
-        }
-        t.ok(is)
-        t.end()
-      })
-    } else {
-      isexe(meow, options, function (er, is) {
-        if (er) {
-          throw er
-        }
-        t.ok(is)
-        t.end()
-      })
-    }
-  })
-
-  t.test('mine async', function (t) {
-    isexe(mine, options, function (er, is) {
-      if (er) {
-        throw er
-      }
-      t.ok(is)
-      t.end()
-    })
-  })
-
-  t.test('ours async', function (t) {
-    isexe(ours, options, function (er, is) {
-      if (er) {
-        throw er
-      }
-      t.ok(is)
-      t.end()
-    })
-  })
-
-  if (!options || !options.skipFail) {
-    t.test('fail async', function (t) {
-      isexe(fail, options, function (er, is) {
-        if (er) {
-          throw er
-        }
-        t.notOk(is)
-        t.end()
-      })
-    })
-  }
-
-  t.test('noent async', function (t) {
-    isexe(noent, options, function (er, is) {
-      t.ok(er)
-      t.notOk(is)
-      t.end()
-    })
-  })
-
-  t.test('noent ignore async', function (t) {
-    isexe(noent, optionsIgnore, function (er, is) {
-      if (er) {
-        throw er
-      }
-      t.notOk(is)
-      t.end()
-    })
-  })
-
-  t.test('directory is not executable', function (t) {
-    isexe(__dirname, options, function (er, is) {
-      if (er) {
-        throw er
-      }
-      t.notOk(is)
-      t.end()
-    })
-  })
-
-  t.end()
-}

package/node_modules/isexe/windows.js

@@ -1,42 +0,0 @@
-module.exports = isexe
-isexe.sync = sync
-
-var fs = require('fs')
-
-function checkPathExt (path, options) {
-  var pathext = options.pathExt !== undefined ?
-    options.pathExt : process.env.PATHEXT
-
-  if (!pathext) {
-    return true
-  }
-
-  pathext = pathext.split(';')
-  if (pathext.indexOf('') !== -1) {
-    return true
-  }
-  for (var i = 0; i < pathext.length; i++) {
-    var p = pathext[i].toLowerCase()
-    if (p && path.substr(-p.length).toLowerCase() === p) {
-      return true
-    }
-  }
-  return false
-}
-
-function checkStat (stat, path, options) {
-  if (!stat.isSymbolicLink() && !stat.isFile()) {
-    return false
-  }
-  return checkPathExt(path, options)
-}
-
-function isexe (path, options, cb) {
-  fs.stat(path, function (er, stat) {
-    cb(er, er ? false : checkStat(stat, path, options))
-  })
-}
-
-function sync (path, options) {
-  return checkStat(fs.statSync(path), path, options)
-}

package/node_modules/jackspeak/LICENSE.md

@@ -1,55 +0,0 @@
-# Blue Oak Model License
-
-Version 1.0.0
-
-## Purpose
-
-This license gives everyone as much permission to work with
-this software as possible, while protecting contributors
-from liability.
-
-## Acceptance
-
-In order to receive this license, you must agree to its
-rules. The rules of this license are both obligations
-under that agreement and conditions to your license.
-You must not do anything with this software that triggers
-a rule that you cannot or will not follow.
-
-## Copyright
-
-Each contributor licenses you to do everything with this
-software that would otherwise infringe that contributor's
-copyright in it.
-
-## Notices
-
-You must ensure that everyone who gets a copy of
-any part of this software from you, with or without
-changes, also gets the text of this license or a link to
-<https://blueoakcouncil.org/license/1.0.0>.
-
-## Excuse
-
-If anyone notifies you in writing that you have not
-complied with [Notices](#notices), you can keep your
-license by taking all practical steps to comply within 30
-days after the notice. If you do not do so, your license
-ends immediately.
-
-## Patent
-
-Each contributor licenses you to do everything with this
-software that would otherwise infringe any patent claims
-they can license or become able to license.
-
-## Reliability
-
-No contributor can revoke this license.
-
-## No Liability
-
-**_As far as the law allows, this software comes as is,
-without any warranty or condition, and no contributor
-will be liable to anyone for any damages related to this
-software or this license, under any kind of legal claim._**

package/node_modules/jackspeak/README.md

@@ -1,394 +0,0 @@
-# jackspeak
-
-A very strict and proper argument parser.
-
-Validate string, boolean, and number options, from the command
-line and the environment.
-
-Call the `jack` method with a config object, and then chain
-methods off of it.
-
-At the end, call the `.parse()` method, and you'll get an object
-with `positionals` and `values` members.
-
-Any unrecognized configs or invalid values will throw an error.
-
-As long as you define configs using object literals, types will
-be properly inferred and TypeScript will know what kinds of
-things you got.
-
-If you give it a prefix for environment variables, then defaults
-will be read from the environment, and parsed values written back
-to it, so you can easily pass configs through to child processes.
-
-Automatically generates a `usage`/`help` banner by calling the
-`.usage()` method.
-
-Unless otherwise noted, all methods return the object itself.
-
-## USAGE
-
-```js
-// the minified version has no external deps, typically better
-// startup time for CLI tools that would use jackspeak.
-import { jack } from 'jackspeak/min'
-// this works too:
-// const { jack } = require('jackspeak/min')
-
-const { positionals, values } = jack({ envPrefix: 'FOO' })
-  .flag({
-    asdf: { description: 'sets the asfd flag', short: 'a', default: true },
-    'no-asdf': { description: 'unsets the asdf flag', short: 'A' },
-    foo: { description: 'another boolean', short: 'f' },
-  })
-  .optList({
-    'ip-addrs': {
-      description: 'addresses to ip things',
-      delim: ',', // defaults to '\n'
-      default: ['127.0.0.1'],
-    },
-  })
-  .parse([
-    'some',
-    'positional',
-    '--ip-addrs',
-    '192.168.0.1',
-    '--ip-addrs',
-    '1.1.1.1',
-    'args',
-    '--foo', // sets the foo flag
-    '-A', // short for --no-asdf, sets asdf flag to false
-  ])
-
-console.log(process.env.FOO_ASDF) // '0'
-console.log(process.env.FOO_FOO) // '1'
-console.log(values) // {
-//   'ip-addrs': ['192.168.0.1', '1.1.1.1'],
-//   foo: true,
-//   asdf: false,
-// }
-console.log(process.env.FOO_IP_ADDRS) // '192.168.0.1,1.1.1.1'
-console.log(positionals) // ['some', 'positional', 'args']
-```
-
-## `jack(options: JackOptions = {}) => Jack`
-
-Returns a `Jack` object that can be used to chain and add
-field definitions. The other methods (apart from `validate()`,
-`parse()`, and `usage()` obviously) return the same Jack object,
-updated with the new types, so they can be chained together as
-shown in the code examples.
-
-Options:
-
-- `allowPositionals` Defaults to true. Set to `false` to not
-  allow any positional arguments.
-
-- `envPrefix` Set to a string to write configs to and read
-  configs from the environment. For example, if set to `MY_APP`
-  then the `foo-bar` config will default based on the value of
-  `env.MY_APP_FOO_BAR` and will write back to that when parsed.
-
-  Boolean values are written as `'1'` and `'0'`, and will be
-  treated as `true` if they're `'1'` or false otherwise.
-
-  Number values are written with their `toString()`
-  representation.
-
-  Strings are just strings.
-
-  Any value with `multiple: true` will be represented in the
-  environment split by a delimiter, which defaults to `\n`.
-
-- `env` The place to read/write environment variables. Defaults
-  to `process.env`.
-
-- `usage` A short usage string to print at the top of the help
-  banner.
-
-- `stopAtPositional` Boolean, default false. Stop parsing opts
-  and flags at the first positional argument. This is useful if
-  you want to pass certain options to subcommands, like some
-  programs do, so you can stop parsing and pass the positionals
-  to the subcommand to parse.
-
-- `stopAtPositionalTest` Conditional `stopAtPositional`. Provide
-  a function that takes a positional argument string and returns
-  boolean. If it returns `true`, then parsing will stop. Useful
-  when _some_ subcommands should parse the rest of the command
-  line options, and others should not.
-
-### `Jack.heading(text: string, level?: 1 | 2 | 3 | 4 | 5 | 6)`
-
-Define a short string heading, used in the `usage()` output.
-
-Indentation of the heading and subsequent description/config
-usage entries (up until the next heading) is set by the heading
-level.
-
-If the first usage item defined is a heading, it is always
-treated as level 1, regardless of the argument provided.
-
-Headings level 1 and 2 will have a line of padding underneath
-them. Headings level 3 through 6 will not.
-
-### `Jack.description(text: string, { pre?: boolean } = {})`
-
-Define a long string description, used in the `usage()` output.
-
-If the `pre` option is set to `true`, then whitespace will not be
-normalized. However, if any line is too long for the width
-allotted, it will still be wrapped.
-
-## Option Definitions
-
-Configs are defined by calling the appropriate field definition
-method with an object where the keys are the long option name,
-and the value defines the config.
-
-Options:
-
-- `type` Only needed for the `addFields` method, as the others
-  set it implicitly. Can be `'string'`, `'boolean'`, or
-  `'number'`.
-- `multiple` Only needed for the `addFields` method, as the
-  others set it implicitly. Set to `true` to define an array
-  type. This means that it can be set on the CLI multiple times,
-  set as an array in the `values`
-  and it is represented in the environment as a delimited string.
-- `short` A one-character shorthand for the option.
-- `description` Some words to describe what this option is and
-  why you'd set it.
-- `hint` (Only relevant for non-boolean types) The thing to show
-  in the usage output, like `--option=<hint>`
-- `validate` A function that returns false (or throws) if an
-  option value is invalid.
-- `validOptions` An array of strings or numbers that define the
-  valid values that can be set. This is not allowed on `boolean`
-  (flag) options. May be used along with a `validate()` method.
-- `default` A default value for the field. Note that this may be
-  overridden by an environment variable, if present.
-
-### `Jack.flag({ [option: string]: definition, ... })`
-
-Define one or more boolean fields.
-
-Boolean options may be set to `false` by using a
-`--no-${optionName}` argument, which will be implicitly created
-if it's not defined to be something else.
-
-If a boolean option named `no-${optionName}` with the same
-`multiple` setting is in the configuration, then that will be
-treated as a negating flag.
-
-### `Jack.flagList({ [option: string]: definition, ... })`
-
-Define one or more boolean array fields.
-
-### `Jack.num({ [option: string]: definition, ... })`
-
-Define one or more number fields. These will be set in the
-environment as a stringified number, and included in the `values`
-object as a number.
-
-### `Jack.numList({ [option: string]: definition, ... })`
-
-Define one or more number list fields. These will be set in the
-environment as a delimited set of stringified numbers, and
-included in the `values` as a number array.
-
-### `Jack.opt({ [option: string]: definition, ... })`
-
-Define one or more string option fields.
-
-### `Jack.optList({ [option: string]: definition, ... })`
-
-Define one or more string list fields.
-
-### `Jack.addFields({ [option: string]: definition, ... })`
-
-Define one or more fields of any type. Note that `type` and
-`multiple` must be set explicitly on each definition when using
-this method.
-
-## Informative Getters
-
-Once you've defined several fields with the various methods
-described above, you can get at the definitions and such with
-these methods.
-
-This are primarily just informative, but can be useful in some
-advanced scenarios, such as providing "Did you mean?" type
-suggestions when someone misspells an option name.
-
-### `Jack.definitions`
-
-The set of config field definitions in no particular order. This
-is a data object suitable to passing to `util.parseArgs`, but
-with the addition of `short` and `description` fields, where
-appropriate.
-
-### `Jack.jackOptions`
-
-The options passed into the initial `jack()` function (or `new
-Jack()` constructor).
-
-### `Jack.shorts`
-
-The `{ <short>: <long> }` name record for all short options
-defined.
-
-### `Jack.usageFields`
-
-The array of fields that are used to generate `Jack.usage()` and
-`Jack.usageMarkdown()` content.
-
-## Actions
-
-Use these methods on a Jack object that's already had its config
-fields defined.
-
-### `Jack.parse(args: string[] = process.argv): { positionals: string[], values: OptionsResults }`
-
-Parse the arguments list, write to the environment if `envPrefix`
-is set, and returned the parsed values and remaining positional
-arguments.
-
-### `Jack.validate(o: unknown): asserts o is OptionsResults`
-
-Throws an error if the object provided is not a valid result set,
-for the configurations defined thusfar.
-
-### `Jack.usage(): string`
-
-Returns the compiled `usage` string, with all option descriptions
-and heading/description text, wrapped to the appropriate width
-for the terminal.
-
-### `Jack.setConfigValues(options: OptionsResults, src?: string)`
-
-Validate the `options` argument, and set the default value for
-each field that appears in the options.
-
-Values provided will be overridden by environment variables or
-command line arguments.
-
-### `Jack.usageMarkdown(): string`
-
-Returns the compiled `usage` string, with all option descriptions
-and heading/description text, but as markdown instead of
-formatted for a terminal, for generating HTML documentation for
-your CLI.
-
-## Some Example Code
-
-Also see [the examples
-folder](https://github.com/isaacs/jackspeak/tree/master/examples)
-
-```js
-// the minified version has no external deps, typically better
-// startup time for CLI tools that would use jackspeak.
-// but `import { jack } from 'jackspeak'` also works fine.
-import { jack } from 'jackspeak/min'
-
-const j = jack({
-  // Optional
-  // This will be auto-generated from the descriptions if not supplied
-  // top level usage line, printed by -h
-  // will be auto-generated if not specified
-  usage: 'foo [options] <files>',
-})
-  .heading('The best Foo that ever Fooed')
-  .description(
-    `
-    Executes all the files and interprets their output as
-    TAP formatted test result data.
-
-    To parse TAP data from stdin, specify "-" as a filename.
-  `,
-  )
-
-  // flags don't take a value, they're boolean on or off, and can be
-  // turned off by prefixing with `--no-`
-  // so this adds support for -b to mean --bail, or -B to mean --no-bail
-  .flag({
-    flag: {
-      // specify a short value if you like.  this must be a single char
-      short: 'f',
-      // description is optional as well.
-      description: `Make the flags wave`,
-      // default value for flags is 'false', unless you change it
-      default: true,
-    },
-    'no-flag': {
-      // you can can always negate a flag with `--no-flag`
-      // specifying a negate option will let you define a short
-      // single-char option for negation.
-      short: 'F',
-      description: `Do not wave the flags`,
-    },
-  })
-
-  // Options that take a value are specified with `opt()`
-  .opt({
-    reporter: {
-      short: 'R',
-      description: 'the style of report to display',
-    },
-  })
-
-  // if you want a number, say so, and jackspeak will enforce it
-  .num({
-    jobs: {
-      short: 'j',
-      description: 'how many jobs to run in parallel',
-      default: 1,
-    },
-  })
-
-  // A list is an option that can be specified multiple times,
-  // to expand into an array of all the settings.  Normal opts
-  // will just give you the last value specified.
-  .optList({
-    'node-arg': {},
-  })
-
-  // a flagList is an array of booleans, so `-ddd` is [true, true, true]
-  // count the `true` values to treat it as a counter.
-  .flagList({
-    debug: { short: 'd' },
-  })
-
-  // opts take a value, and is set to the string in the results
-  // you can combine multiple short-form flags together, but
-  // an opt will end the combine chain, posix-style.  So,
-  // -bofilename would be like --bail --output-file=filename
-  .opt({
-    'output-file': {
-      short: 'o',
-      // optional: make it -o<file> in the help output insead of -o<value>
-      hint: 'file',
-      description: `Send the raw output to the specified file.`,
-    },
-  })
-
-// now we can parse argv like this:
-const { values, positionals } = j.parse(process.argv)
-
-// or decide to show the usage banner
-console.log(j.usage())
-
-// or validate an object config we got from somewhere else
-try {
-  j.validate(someConfig)
-} catch (er) {
-  console.error('someConfig is not valid!', er)
-}
-```
-
-## Name
-
-The inspiration for this module is [yargs](http://npm.im/yargs), which
-is pirate talk themed. Yargs has all the features, and is infinitely
-flexible. "Jackspeak" is the slang of the royal navy. This module
-does not have all the features. It is declarative and rigid by design.