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 |
Changelog
v0.9.0
- Added collapsible describe content
v0.8.0
- Refactored code for maintenance ease
- Updated test capture code to capture Mocha TDD test suites
v0.7.0
- Added code sample collapsing in generated docs for easier scanning
v0.6.0
- Added init behavior
- Improved tests around internal code
- Updated error messaging when mochadoc config is missing
v0.5.0
- Added CLI options
v0.4.1
- Alphabetized results on index page
- Fixed underline bug in header
v0.3.0
- Added styles and formatting
- Updated config handler to use projectName property
v0.2.1
- Updated to handle cases where describe blocks are not used
- Added support for Jest "test" syntax instead of "it"
- Improved description argument handling for non-string values
v0.1.1
- Initial release of mochadoc
- Reads tests using glob syntax
- Writes raw (unstyled) HTML docs to specified destination