sphinxcontrib-typer
A Sphinx directive for auto generating docs for Typer applications using the rich console formatting available in Typer. This package generates concise command documentation in text, html or svg formats out of the box. If you need to document a standalone Click command, or want to greatly customize the generated documentation, sphinx-click may be more appropriate and will also work for Typer commands.
Installation
Install with pip::
pip install sphinxcontrib-typer
Add sphinxcontrib.typer to your conf.py file:
# be sure that the commands you want to document are importable
# from the python path when building the docs
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parent / '../path/to/your/commands'))
extensions = [
...
'sphinxcontrib.typer',
...
]
Usage
Say you have a command in the file examples/example.py that looks like
this:
import typer
import typing as t
app = typer.Typer(add_completion=False)
@app.callback()
def callback(
flag1: bool = typer.Option(False, help="Flag 1."),
flag2: bool = typer.Option(False, help="Flag 2."),
):
"""This is the callback function."""
pass
@app.command()
def foo(name: str = typer.Option(..., help="The name of the item to foo.")):
"""This is the foo command."""
pass
@app.command()
def bar(
names: t.List[str] = typer.Option(..., help="The names of the items to bar."),
):
"""This is the bar command."""
pass
if __name__ == "__main__":
app()
You can generate documentation for this command using the typer directive
like so:
.. typer:: examples.example.app
:prog: example1
:width: 70
:preferred: html
This would generate html that looks like this:
You could change :preferred: to svg, to generate svg instead:
|
Or to text
Usage: example [OPTIONS] COMMAND [ARGS]...
This is the callback function.
╭─ Options ──────────────────────────────────────────────────────────╮
│ --flag1 --no-flag1 Flag 1. [default: no-flag1] │
│ --flag2 --no-flag2 Flag 2. [default: no-flag2] │
│ --help Show this message and exit. │
╰────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────╮
│ bar This is the bar command. │
│ foo This is the foo command. │
╰────────────────────────────────────────────────────────────────────╯
The typer directive has options for generating docs for all subcommands as well
and optionally generating independent sections for each. There are also mechanisms
for passing options to the underlying console and svg generation functions. See the
official documentation for more information.
1 maintainer
Metadata
1 maintainer
Release files for sphinxcontrib-typer 0.9.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_typer-0.9.2.tar.gz | 169.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinxcontrib_typer-0.9.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 184.7 kB
Release files / sphinxcontrib_typer-0.9.2.tar.gz
| Download URL | sphinxcontrib_typer-0.9.2.tar.gz |
|---|---|
| Size | 169.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9afa791810f193d22fbd85e7158ec3740b34c4e46364bb2ca5bfc3794783eec5
|
|
BLAKE2b-256 checksum How to use checksums |
ce8eb52c126263205753d8523ed059c512898bf8431d4b4490d8063130851c22
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / sphinxcontrib_typer-0.9.2-py3-none-any.whl
| Download URL | sphinxcontrib_typer-0.9.2-py3-none-any.whl |
|---|---|
| Size | 15.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d7eae60aea8e14e17b0f7bfda2c16e3f29ddb4b0bc6542951345e2f285abcc58
|
|
BLAKE2b-256 checksum How to use checksums |
27893d4fc0c74735cb498625ca92ffcea73f8b3eec650235af57eb006dce7c2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency log
