1.0.0 • Published 7 years ago

argv-options v1.0.0

Weekly downloads
2
License
MIT
Repository
github
Last release
7 years ago

argv-options

npm Travis

argv-options subjectively parses your argv options, i.e., it makes assumptions about how your CLI is designed to keep the API simple. It expects your argv object to be supplied in the format of -p foo --param bar, i.e., simple key-value arguments that may be aliased (using --).

API

parseOptions(argv, options)

This method will return the parsed options in a key-value based object, including all found options and their respective aliases. The following arugments are mandatory:

  • argv The arguments array, as space-split array of all parameters. In your average usage case, passing process.argv.slice(2) will do.
  • options The possible options, as object:
{
  "p": {
    "optional": false,
    "alias": "param"
  },

  "a": {
    "optional": true,
    "alias": "argument"
  }
}

Parameters are required (optional is false) by default. Alternatively, for more convenient use, aliases may be specified by using the key's value:

{
  "p": "param"
}

If any non-optional parameters are missing or undocumented parameters occur, parseOptions will throw an error.