Mochadoc NPM | npm.io

Mochadoc

The dead simple way to create docs from Mocha BDD & TDD, Jasmine and Jest tests.

Find me online:

Setup

First install Mochadoc globally from NPM:

npm install -g mochadoc

After installation, open a console/terminal in your project root directory and set up a new mochadoc configuration with the following command:

mochadoc --init

If you would prefer to have your configuration in your package file, you can create it by hand. The format is detailed below.

Add configuration to your package.json like this:

{
    "scripts": {
        ...
    },
    "mochadoc": {
        "projectName": "My Amazing Project",
        "files": "./test/**/*.js",
        "dest": "./docs/api"
    }
}

Create a standalone configuration by creating a .mochadocrc file like this:

{
    "projectName": "My Amazing Project",
    "files": "./test/**/*.js",
    "dest": "./docs/api"
}

The config file can be stored elsewhere and referenced with the --config flag.

Running Mochadoc

Mochadoc has a rich CLI option set. By default, verbose mode is enabled, and file writing is the core behavior. Mochadoc will automatically search for a config file in the directory it is called from. Basic execution is as follows:

mochadoc

For a list of the entire set of options, run mochadoc with the help option:

mochadoc --help

The option which is most likely to be useful is the alternate configuration option:

mochadoc --config path/to/config/file

Mochadoc Help Output

Mochadoc - the fast, easy test to document utility

Generates documents from Mocha BDD, Jasmine and Jest test files.

Synopsis

Examples of use:

$ mochadoc --init
$ mochadoc --help
$ mochadoc [--silent] [--json] [--config path/to/file]

Options

Switch	Input Type	Description
-c, --config	filePath	Alternate location for config file
--dryrun		Does everything except write to file system
-h, --help		Outputs command docs
--init		Generates a new mochadocrc file
--json		Outputs title raw JSON to stdout
-s, --silent		Turns off all logging