Python documentation annotation metadata

Document symbols via annotation metadata, as described by PEP 727.

This will become an alias to the same functionality in typing_extensions if and when it is implemented.

Installation

pip install docannometa

Usage

from typing import Annotated

from docannometa import Doc

def repeat(
    text: Annotated[str, Doc("String to repeat")],
    n: Annotated[int, Doc("Number of times to repeat")],
) -> Annotated[str, Doc("Result string of length `n * len(text)`")]:
    """Repeat a string multiple times then concatenate."""
    return text * n