Sphinx extension for enhanced autodoc API entry styling (badges and cards)
Project description
sphinx-autodoc-api-style
Sphinx extension that adds type and modifier badges and card-style containers to standard Python domain autodoc entries (functions, classes, methods, properties, attributes, data, exceptions).
Internally it is now a thin metadata producer on top of the shared stack:
sphinx_ux_badges owns badge rendering and sphinx_ux_autodoc_layout owns
the api-* entry structure and type rendering.
Install
$ pip install sphinx-autodoc-api-style
Installing this package also installs sphinx-ux-badges and
sphinx-ux-autodoc-layout as declared dependencies.
Usage
extensions = ["sphinx_autodoc_api_style"]
No special directives are required — existing .. autofunction::,
.. autoclass::, and related directives receive badges automatically.
sphinx_autodoc_api_style automatically registers sphinx_ux_badges and
sphinx_ux_autodoc_layout via app.setup_extension(). You do not need to add
them separately to your extensions list.
Documentation
See the full documentation for demos and the badge reference.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sphinx_autodoc_api_style-0.0.1a24.tar.gz.
File metadata
- Download URL: sphinx_autodoc_api_style-0.0.1a24.tar.gz
- Upload date:
- Size: 9.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4798838fcdcade0dbf00e323b883d4dec4cd2e13a325befdce1e68d849858c0c
|
|
| MD5 |
1f6936d080a5f26615589734fea242a1
|
|
| BLAKE2b-256 |
e54236bef1bb9c2ef37d89a4ae01a61397297ec2c3e0af44e8ac905f87000495
|
Provenance
The following attestation bundles were made for sphinx_autodoc_api_style-0.0.1a24.tar.gz:
Publisher:
release.yml on git-pull/gp-sphinx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sphinx_autodoc_api_style-0.0.1a24.tar.gz -
Subject digest:
4798838fcdcade0dbf00e323b883d4dec4cd2e13a325befdce1e68d849858c0c - Sigstore transparency entry: 1629514594
- Sigstore integration time:
-
Permalink:
git-pull/gp-sphinx@8b81ddb733d79ff3b3b442a97232799b27f37452 -
Branch / Tag:
refs/tags/v0.0.1a24 - Owner: https://github.com/git-pull
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8b81ddb733d79ff3b3b442a97232799b27f37452 -
Trigger Event:
push
-
Statement type:
File details
Details for the file sphinx_autodoc_api_style-0.0.1a24-py3-none-any.whl.
File metadata
- Download URL: sphinx_autodoc_api_style-0.0.1a24-py3-none-any.whl
- Upload date:
- Size: 9.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
207f64f23fa349af943f5c538d4cbf618488c013bd1fc1563283b0f7600590df
|
|
| MD5 |
8dff865788b3a81e30eb5620b22fe672
|
|
| BLAKE2b-256 |
0996560a98a3736888b876efe1d69be25bb910f30f83090244ef4e99275e5c0e
|
Provenance
The following attestation bundles were made for sphinx_autodoc_api_style-0.0.1a24-py3-none-any.whl:
Publisher:
release.yml on git-pull/gp-sphinx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sphinx_autodoc_api_style-0.0.1a24-py3-none-any.whl -
Subject digest:
207f64f23fa349af943f5c538d4cbf618488c013bd1fc1563283b0f7600590df - Sigstore transparency entry: 1629515601
- Sigstore integration time:
-
Permalink:
git-pull/gp-sphinx@8b81ddb733d79ff3b3b442a97232799b27f37452 -
Branch / Tag:
refs/tags/v0.0.1a24 - Owner: https://github.com/git-pull
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8b81ddb733d79ff3b3b442a97232799b27f37452 -
Trigger Event:
push
-
Statement type: