pdoc definition¶
Contents
https://github.com/pdoc3/pdoc¶
Auto-generate API documentation for Python projects.
README.md pdoc¶
Auto-generate API documentation for Python projects.
Installation¶
$ pip install pdoc3
Usage¶
Pdoc will accept a Python module file, package directory or an import path.
$ pdoc your_project
See pdoc --help
for more command-line switches and the
documentation for more
usage examples.
Features¶
Simple usage. Generate sensible API (+ prose) documentation without any special configuration.
Support for common docstrings formats (Markdown, numpydoc, Google-style docstrings) and some reST directives.
pdoc respects
__all__
when present.Inheritance used as applicable for inferring docstrings for class members.
Support for documenting module, class, and instance variables by traversing ASTs.
Automatic cross-linking of referenced identifiers in HTML.
Overriding docstrings with special module-level
__pdoc__
dictionary.Built-in development web server for near instant preview of rendered docstrings.
The above features are explained in more detail in pdoc’s documentation (which was generated with pdoc).