Package Exports

nopt-usage

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (nopt-usage) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Show usage

This module generates a usage string for nopt options. It's based on this PR from Filirom1.

var noptUsage = require('nopt-usage');
noptUsage(knownOpts, shortHands, description1, description2, ...)

install

npm install nopt-usage

example

You could pass as many description objects as you want. Take a look at the following example to understand how it could be used.

#!/usr/bin/env node

var nopt = require("nopt")
  , noptUsage = require("nopt-usage")
  , Stream = require("stream").Stream
  , path = require("path")
  , knownOpts = { "foo" : [String, null]
                , "bar" : [Stream, Number]
                , "baz" : path
                , "bloo" : [ "big", "medium", "small" ]
                , "flag" : Boolean
                , "pick" : Boolean
                }
  , shortHands = { "foofoo" : ["--foo", "Mr. Foo"]
                 , "b7" : ["--bar", "7"]
                 , "m" : ["--bloo", "medium"]
                 , "p" : ["--pick"]
                 , "f" : ["--flag", "true"]
                 , "g" : ["--flag"]
                 , "s" : "--flag"
                 }
  , description = { "foo" : "Something really foooooooo"
                  , "bar" : "A bar thing"
                  , "baz" : "More or less baz"
                  , "flag" : "Flag it as well"
                  , "pick" : "Or pick something"
                  }
  , defaults = { "foo" : null
               , "bar" : 42
               , "baz" : "/etc/passwd"
               , "bloo" : "small"
               , "pick" : false
               }
             // everything is optional.
             // knownOpts and shorthands default to {}
             // arg list defaults to process.argv
             // slice defaults to 2
  , parsed = nopt(knownOpts, shortHands, process.argv, 2)
  , usage = noptUsage(knownOpts, shortHands, description, defaults)

console.log('Usage: ')
console.log(usage)

The output is:

Usage:
    --foo, -foofoo        Something really foooooooo    null           
    --bar, -b7            A bar thing                   42             
    --baz                 More or less baz              /etc/passwd    
    --bloo, -m                                          small          
    --flag, -f, -g, -s    Flag it as well                              
    --pick, -p            Or pick something             false