yargs-reference
A tool to generate a command line reference from a yargs powered cli
Last updated 2 years ago by dominicporteous .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install yargs-reference 
SYNC missed versions from official npm registry.

yargs-reference

A tool to generate a command line reference from a yargs powered cli

How to use

Its simple!


$ npm i yargs-reference -g
$ cd /my/app/path
$ yargs-reference

Writing out to ./docs/reference.md

# Command Reference
Note: This is not an exauhstive list, and entries may be missing or incomplete.

----

### Command
`command`

### Description
My command does...

### Options
| 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.

Non yargs tools?

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)

What does the output look like?

Check out our own reference file to see! Have a look at this file to see what it was generated from.

Current Tags

  • 1.0.3                                ...           latest (2 years ago)

4 Versions

  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 3
Dependencies (9)
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |