commands.sh

pydocstyle

all

Statically check Python scripts for compliance with Python docstring conventions.

More info →

Options (2)

-e, --explainboolean

Show an explanation of each error

Example: pydocstyle {{[-e|--explain]}} {{file.py|path/to/directory}}
-d, --debugboolean

Show debug information

Example: pydocstyle {{[-d|--debug]}} {{file.py|path/to/directory}}

Examples (7)

Analyze a Python script or all the Python scripts in a specific directory

pydocstyle file.py|path/to/directory

Show an explanation of each error

pydocstyle [-e|--explain] file.py|path/to/directory

Show debug information

pydocstyle [-d|--debug] file.py|path/to/directory

Display the total number of errors

pydocstyle --count file.py|path/to/directory

Use a specific configuration file

pydocstyle --config path/to/config_file file.py|path/to/directory

Ignore one or more errors

pydocstyle --ignore D101,D2,D107,... file.py|path/to/directory

Check for errors from a specific convention

pydocstyle --convention pep257|numpy|google file.py|path/to/directory
made by @shridhargupta | data from tldr-pages