pydoctest 0.1.8

Test if doctype types match signatures

pydoctest: docstring signature verification

File issues here: Issues tracker

Motivation

Pydoctest helps you verify that your docstrings match your function signatures. As a codebase evolves, you can some times forget to update the docstrings.

Installation

Install pydoctest with pip:

$ python3 -m pip install pydoctest

Usage

Navigate to your project location, and execute pydoctest

$ pydoctest

With no pydoctest.json configuration file, it will by default validate all *.py files in the current directory. See the configuration section for options.

Output

Pydoctest supports outputting results either as JSON or Text with different verbosity options. By default, Text is returned. To specify the output, invoke with --reporter argument:

$ pydoctest --reporter [json | text]

For Text-output, --verbosity can be provided with a value of 0 (quiet), 1 (show failed) or 2 (show all).

$ pydoctest --reporter text --verbosity 1

Configuration

Pydoctest can be configured with a config JSON file. By default, it will search for pydoctest.json in the directory pydoctest is executed. A path can also be provided when executing:

$ pydoctest --config /path/to/pydoctest.json

Example pydoctest.json:

{
    "include_paths": [ "server/*.py" ],
    "fail_on_missing_docstring": true,
    "parser": "google",
}

Docstring format can be specified with the --parser argument:

$ pydoctest --parser google

Currently, only google is supported.

License

Pydoctest is licensed under the terms of the MIT License (see the LICENSE file).