pydocstyle 1.0.0

Python docstring style checker

(formerly pep257)

pydocstyle is a static analysis tool for checking compliance with Python docstring conventions.

pydocstyle supports most of PEP 257 out of the box, but it should not be considered a reference implementation.

The framework for checking docstring style is flexible, and custom checks can be easily added, for example to cover NumPy docstring conventions.

pydocstyle supports Python 2.6, 2.7, 3.3, 3.4, 3.5, pypy and pypy3.

Quick Start

Install

pip install pydocstyle

Run

$ pydocstyle test.py
test.py:18 in private nested class `meta`:
        D101: Docstring missing
test.py:22 in public method `method`:
        D102: Docstring missing
...

Links

• Read the full documentation here.

• Fork pydocstyle on GitHub.

• PyPI project page.