API Reference
The API reference is auto-generated from docstrings using mkdocstrings. Every public class, method, and function is documented here.
Modules
Module |
Contents |
|---|---|
Top-level |
|
|
|
|
|
|
|
|
|
|
Docstring style
All public symbols use Google-style docstrings:
def my_function(x: int, y: float = 1.0) -> str:
"""One-line summary.
Longer description if needed. Multiple paragraphs are fine.
Args:
x: Description of x.
y: Description of y. Default ``1.0``.
Returns:
A string representation.
Raises:
ValueError: If ``x`` is negative.
Example:
>>> my_function(5)
'5.00'
"""
Enforcement
Docstring coverage is enforced by interrogate:
make doccheck # fails if coverage < 100 %
This runs in CI on every pull request. See Contributing for details.