This sphinx extension helps you document Python code that uses async/await, or abstract methods, or context managers, or generators, or … you get the idea. It works by making sphinx’s regular directives for documenting Python functions and methods smarter and more powerful. The name is because it was originally written for the Trio project, and I’m not very creative. But don’t be put off – there’s nothing Trio- or async-specific about this extension; any Python project can benefit. (Though projects using async/await probably benefit the most, since sphinx’s built-in tools are especially inadequate in this case.)
Vital statistics
Requirements: This extension currently assumes you’re using Python 3.5+ to build your docs. This could be relaxed if anyone wants to send a patch.
Documentation: https://sphinxcontrib-trio.readthedocs.io
Bug tracker and source code: https://github.com/python-trio/sphinxcontrib-trio
License: MIT or Apache 2, your choice.
Usage: pip install -U sphinxcontrib-trio in the same environment where you installed sphinx, and then add "sphinxcontrib_trio" to the list of extensions in your project’s conf.py. (Notice that "sphinxcontrib_trio" has an underscore in it, NOT a dot. This is because I don’t understand namespace packages, and I fear things that I don’t understand.)
Code of conduct: Contributors are requested to follow our code of conduct in all project spaces.
Release files for sphinxcontrib-trio 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinxcontrib-trio-1.0.2.tar.gz | 22.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinxcontrib_trio-1.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.9 kB
Release files / sphinxcontrib-trio-1.0.2.tar.gz
| Download URL | sphinxcontrib-trio-1.0.2.tar.gz |
|---|---|
| Size | 22.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fccb369ae1e2ef6fd397e1e2b1d777113ae88e5737955019b8524df7fc093e5f
|
|
BLAKE2b-256 checksum How to use checksums |
df8998f12fee9f805eeb1741c6e6b144261e879e9793aeea80770d339e1b911f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.5
|
Release files / sphinxcontrib_trio-1.0.2-py3-none-any.whl
| Download URL | sphinxcontrib_trio-1.0.2-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
92fd88a6ead8d385f1c69fa8a51a4032fd3f6ac5535382b6f4dc9975f1de4ee5
|
|
BLAKE2b-256 checksum How to use checksums |
cd590704bdea863bf5967650aa7d7fdc1109e989e8c8fdb9198d5e833b959c85
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.5
|
