Wondering what‚Äôs next for npm?Check out our public roadmap! ¬Ľ

    @opt/parse

    0.2.0¬†‚Äʬ†Public¬†‚Äʬ†Published

    @opt/parse

    Build Status Dependency Status npm version Coverage Status

    Modular options parser allowing plugins to provide everything.

    This package doesn't do parsing, it provides the target for plugins to add their stuff.

    The expectations are:

    1. You will use plugins. If you weren't, you'd just require() your favorite parser.
    2. So, you will call parse.use() at least once to load at least one plugin.
    3. So, you can specify the plugin providing the options parser as the first param, like: parser.use('some-parser-plugin', 'another-plugin'). For example, use @opt/nopt to use nopt to parse.

    The above expectations mean this package doesn't do parsing itself. It has no dependency on a parser package. So, no baggage when requiring different parsers.

    Install

    npm install @opt/parse --save

    Usage

    var parse = require('@opt/parse')
     
    // Must provide a plugin with parse implementation. This uses @opt/nopt.
    // other plugins are optional. May specify them in separate use() calls.
    parse.use('@opt/nopt', '@opt/words', '@opt/require')
     
    // then use parse as you would use `nopt`,
    // plus any changes made possible by the plugins added
    options = parse({}, {}, process.argv, 2)

    Usage: Plugins

    See @use/core to understand how the use() function behaves.

    See real plugins:

    1. @opt/nopt
    2. @opt/words
    3. @opt/require

    TODO: Make a plugin to handle type def stuff. It could be parser implementation agnostic. Then, the parser implementation plugins could grab all additional type defs from a standard format.

    Example of writing a plugin for @opt/parse:

    module.exports = function (options, opt) {
      // use `options` to help configure what you're going to do
      // change `nopt` for your plugin's interests...
      // for example, add to typeDefs like @opt/words does:
      var nopt = require('nopt')
     
      nopt.typeDefs.someNewType = {
        type: theTypeKey, // used in options spec
        validate: function validateThisType(data, key, value) {
          // either return false for invalid
          // or, return true and optionally change data[key]
        }
      }
    }

    MIT License

    Install

    npm i @opt/parse

    DownloadsWeekly Downloads

    1

    Version

    0.2.0

    License

    MIT

    Last publish

    Collaborators

    • avatar
    • avatar