apidocs-cli

3.0.3 • Public • Published

apidocs-cli npmjs.com The MIT License

Command-line app for generating API docs from code comments. Can be used as API of helper-apidocs package.

code climate standard code style travis build status coverage status dependency status

Install

npm i apidocs-cli --global

or use it as module, not as cli

npm i apidocs-cli --save

Usage

For more use-cases see the tests

apidocsCli

Generate API docs from code comments in the JavaScript files that match the given patterns. Only code comments with @api public are rendered.

Params

  • <files> {String} filepath(s) or glob pattern(s)
  • [options] {Object} options to pass to [helper-apidocs][apidocs] or callback
  • <callback> {Function} node-style callback function (err, res)

Example

const apidocsCli = require('apidocs-cli')
 
apidocsCli('./*.js', function (err, res) {
  if (err) {
    console.error(err.message)
    return
  }
  console.log(res)
  //=> markdown formatted documentation of
  // all .js files in repo root (index.js and test.js)
})

.sync

Synchronous generating API Docs.

Params

  • <files> {String} filepath(s) or glob pattern(s)
  • [options] {Object} options to pass to [helper-apidocs][apidocs]

Example

const apidocsCli = require('apidocs-cli')
const docs = apidocsCli.sync('./*.js')
 
console.log(docs)
//=> markdown formatted documentation of
// all .js files in repo root (index.js and test.js)

CLI

run apidocs --help

Command-line app for generating API docs from code comments.
Can be used as API of `helper-apidocs` package.

  Options (plus any options introduced in helper-apidocs)
    --help        show this help
    --version     current version

  Usage
    apidocs <FILES...> [flags]

  Example
    apidocs index.js
    apidocs ./lib/*.js

  Issues: https://github.com/tunnckoCore/apidocs-cli/issues
  Readme: https://github.com/tunnckoCore/apidocs-cli
  Helper: https://github.com/helpers/helper-apidocs

Related

  • gitclone-cli: Git clone github repository with pattern like user/repo#branch
  • helper-apidocs: Template helper for automatically generating API docs from code comments. Should work with any template engine.
  • is-installed: Checks that given package is installed on the system - globally or locally.
  • is-missing: Check that given name or user/repo exists in npm registry or in github as user repository.
  • parse-function: Parse a function, arrow function or string to object with name, args, params and body properties.
  • parse-github-short-url: Parse a github/npm shorthand (user/repo#branch or user/repo@version) URL into an object.
  • parse-github-url: Parse a github URL into an object.

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
But before doing anything, please read the CONTRIBUTING.md guidelines.

Charlike Make Reagent new message to charlike freenode #charlike

tunnckocore.tk keybase tunnckocore tunnckoCore npm tunnckoCore twitter tunnckoCore github

Package Sidebar

Install

npm i apidocs-cli

Weekly Downloads

10

Version

3.0.3

License

MIT

Last publish

Collaborators

  • vanchoy
  • tunnckocore