3.6 KiB
3.6 KiB
command-line-tool
Some conventional operations used in command-line tools.
Example
const tool = require('command-line-tool')
tool.stop([message])
Print the supplied messages then stop the process (no exit code).
Kind: static method of command-line-tool
Param | Type | Description |
---|---|---|
[message] | string | Array.<string> |
One or more messages to be written to stderr before exiting. May contain ansi.format markup. |
tool.printError(message)
Prints one or more strings in red to stderr.
Kind: static method of command-line-tool
Param | Type | Description |
---|---|---|
message | string | Array.<string> |
input message(s) |
tool.printOutput(message)
Prints one or more strings to stdout. Catches unwanted EPIPE error.
Kind: static method of command-line-tool
Param | Type | Description |
---|---|---|
message | string | Array.<string> |
input message(s) |
tool.halt([err], [options])
Stop the process with an error message.
Kind: static method of command-line-tool
Param | Type | Description |
---|---|---|
[err] | Error |
the error instance |
[options] | object |
|
[options.exitCode] | number |
defaults to 1 |
[options.stack] | boolean |
defaults to false |
tool.getCli(definitions, [usageSections], [argv]) ⇒ object
Parse the command-line options.
Kind: static method of command-line-tool
Param | Type | Description |
---|---|---|
definitions | Array.<OptionDefinitions> |
to be passed to command-line-args |
[usageSections] | Array.<section> |
to be passed to command-line-usage |
[argv] | Array.<string> |
If supplied, this argv array is parsed instead of process.argv . |
© 2015-18 Lloyd Brookes <75pound@gmail.com>. Documented by jsdoc-to-markdown.