API Documentation for Python Projects.
Examplepdoc -o ./html pdoc
generates this website: pdoc.dev/docs.
pip install pdoc
pdoc is compatible with Python 3.9 and newer.
Usagepdoc your_python_module # or pdoc ./my_project.py
Run pdoc pdoc
to see pdoc's own documentation, run pdoc --help
to view the command line flags, or check our hosted copy of the documentation.
pdoc's main feature is a focus on simplicity: pdoc aims to do one thing and do it well.
Under the hood...
pdoc
will automatically link identifiers in your docstrings to their corresponding documentation.pdoc
respects your __all__
variable when present.pdoc
will traverse the abstract syntax tree to extract type annotations and docstrings from constructors as well.pdoc
will automatically try to resolve type annotation string literals as forward references.pdoc
will use inheritance to resolve type annotations and docstrings for class members.If you have substantially more complex documentation needs, we recommend using Sphinx!
ContributingAs an open source project, pdoc welcomes contributions of all forms.
pdoc vs. pdoc3This project is not associated with "pdoc3", which often falsely assumes our name. Quoting @BurntSushi, the original author of pdoc:
I'm pretty disgusted that someone has taken a project I built, relicensed it, attempted to erase its entry on the Python Wiki, released it under effectively the same name and, worst of all, associated it with Nazi symbols.
In contrast, the pdoc project strives to uphold a healthy community where everyone is treated with respect. Everyone is welcome to contribute as long as they adhere to basic civility. We expressly distance ourselves from the use of Nazi symbols and ideology.
The pdoc project was originally created by Andrew Gallant and is currently maintained by Maximilian Hils.
Download filesDownload the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution Built Distribution File detailsDetails for the file pdoc-15.0.4.tar.gz
.
cf9680f10f5b4863381f44ef084b1903f8f356acb0d4cc6b64576ba9fb712c82
MD5 f9d4eb41815c730bd22002a72a9e64d2
BLAKE2b-256 915ce94c1ab4aa2f8a9cc29d81e1c513c6216946cb3a90957ef7115b12e9363d
See more details on using hashes here.
File detailsDetails for the file pdoc-15.0.4-py3-none-any.whl
.
f9028e85e7bb8475b054e69bde1f6d26fc4693d25d9fa1b1ce9009bec7f7a5c4
MD5 e6ece5140a802f8272c8b59163408d1e
BLAKE2b-256 fd2c87250ac73ca8730b2c4e0185b573585f0b42e09562132e6c29d00b3a9bb9
See more details on using hashes here.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4