A tool to generate a command line reference from a yargs powered cli
npm install yargs-referenceIts simple!
``
$ npm i yargs-reference -g
$ cd /my/app/path
$ yargs-reference
Writing out to ./docs/reference.md
----
$3
My command does...$3
| Option Name | Description | Type | Required | Default Value |
| :--- | :------------ | :---: | :---: | :---: |
| option | This option does... - (Choices: only,these,are,valid) | string | false | valid |----
`Please see the reference file for advanced information
Compatibility
The tool should be usable as-in, to generate a reference file for a command line tool built to the following spec.
The schema
`
// my-command.js
exports.command = 'command'exports.description = 'My command does...'
exports.builder = {
option: {
type: 'string',
description: 'This option does...'
default: 'valid',
choices: ['only','these','are','valid']
}
}
``If the modules which export your commands functionality conform to this, then it may well work. We dont offer any guarantee, so your milage may and probably will vary.
Please see this file for a working example.
If your tool wasn't written with yargs in mind, it may still work - the tool scans the source files for modules exposing the following fields;
| Field | Use |
|---------|-------|
| context | The context of the command |
| command | The actual command itself with any parameters |
| description | A short description of the command |
| builder | Options for your command (options schema) |
Check out our own reference file to see! Have a look at this file to see what it was generated from.