pydocstyle’s documentation
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.
pydocstyle supports Python 3.7 through 3.11.
Although pydocstyle is tries to be compatible with Python 3.6, it is not tested.
Quick Start
Install
pip install pydocstyle
Run
$ pydocstyle test.py test.py:18 in private nested class `meta`: D101: Docstring missing test.py:27 in public function `get_user`: D300: Use """triple double quotes""" (found '''-quotes) test:75 in public function `init_database`: D201: No blank lines allowed before function docstring (found 1) ...
Fix your code :)
Contents:
- Usage
- Error Codes
- Release Notes
- 6.3.0 - January 17th, 2023
- 6.2.3 - January 8th, 2023
- 6.2.2 - January 3rd, 2023
- 6.2.1 - January 3rd, 2023
- 6.2.0 - January 2nd, 2023
- 6.1.1 - May 17th, 2021
- 6.1.0 - May 17th, 2021
- 6.0.0 - March 18th, 2021
- 5.1.2 - September 13th, 2020
- 5.1.1 - August 29th, 2020
- 5.1.0 - August 22nd, 2020
- 5.0.2 - January 8th, 2020
- 5.0.1 - December 9th, 2019
- 5.0.0 - December 9th, 2019
- 4.0.1 - August 14th, 2019
- 4.0.0 - July 6th, 2019
- 3.0.0 - October 14th, 2018
- 2.1.1 - October 9th, 2017
- 2.1.0 - October 8th, 2017
- 2.0.0 - April 18th, 2017
- 1.1.1 - October 4th, 2016
- 1.1.0 - September 29th, 2016
- 1.0.0 - January 30th, 2016
- Older Versions
- License
Credits
pydocstyle is a rename and continuation of pep257, a project created by Vladimir Keleshev.
Maintained by Amir Rachum and Sambhav Kothari.