Test if doctype types match signatures
Project description
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. If you get errors with modules not being found, try placing the pydoctest.json differently or executing inside the package.
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).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pydoctest-0.1.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8a11e540b9e3f52e6f264b7eb33486f307ebf75748367c9749000bacac2107c6 |
|
MD5 | 9aa96389915bbe6cce004df208fc61ce |
|
BLAKE2b-256 | 04adf2a9acf1538d3089a71d1bc8f8cdedfbe56fe024c560266d5748e618a85a |