command-line-tool

command-line-tool

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
command-line-tool
0.8.06 years ago8 years agoMinified + gzip package size for command-line-tool in KB

Readme

view on npm npm module downloads Build Status Dependency Status js-standard-style

command-line-tool

Some conventional operations used in command-line tools.
Example
const tool = require('command-line-tool')

* [.stop([message])](#module_command-line-tool.stop)
* [.printError(message)](#module_command-line-tool.printError)
* [.printOutput(message)](#module_command-line-tool.printOutput)
* [.halt([err], [options])](#module_command-line-tool.halt)
* [.getCli(definitions, [usageSections], [argv])](#module_command-line-tool.getCli) ⇒ <code>object</code>

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.