Skip to content

griffe_typingdoc ¤

Griffe TypingDoc package.

Griffe extension for annotated-doc (originally PEP 727):

Document parameters, class attributes, return types, and variables inline, with Annotated.

Classes:

TypingDocExtension ¤

TypingDocExtension()

Bases: Extension

Griffe extension that reads documentation from typing.Doc.

Methods:

  • on_attribute_instance –

    Post-process Griffe attributes to create their docstring.

  • on_function_instance –

    Post-process Griffe functions to add a parameters section.

  • on_package –

    Post-process Griffe packages recursively (non-yet handled objects only).

Source code in src/griffe_typingdoc/_internal/extension.py 
22
23
def __init__(self) -> None:
    self._handled: set[str] = set()

on_attribute_instance ¤

on_attribute_instance(
    *,
    node: AST | ObjectNode,
    attr: Attribute,
    **kwargs: Any,
) -> None

Post-process Griffe attributes to create their docstring.

It applies only for dynamic analysis.

Source code in src/griffe_typingdoc/_internal/extension.py 
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
def on_attribute_instance(
    self,
    *,
    node: Annotated[
        ast.AST | ObjectNode,
        Doc("The object/AST node describing the attribute or its definition."),
    ],
    attr: Annotated[
        Attribute,
        Doc("The Griffe attribute just instantiated."),
    ],
    **kwargs: Any,  # noqa: ARG002
) -> None:
    """Post-process Griffe attributes to create their docstring.

    It applies only for dynamic analysis.
    """
    if isinstance(node, ObjectNode):
        self._handle_attribute(attr, node=node)

on_function_instance ¤

on_function_instance(
    *, node: AST | ObjectNode, func: Function, **kwargs: Any
) -> None

Post-process Griffe functions to add a parameters section.

It applies only for dynamic analysis.

Source code in src/griffe_typingdoc/_internal/extension.py 
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
def on_function_instance(
    self,
    *,
    node: Annotated[
        ast.AST | ObjectNode,
        Doc("The object/AST node describing the function or its definition."),
    ],
    func: Annotated[
        Function,
        Doc("""The Griffe function just instantiated."""),
    ],
    **kwargs: Any,  # noqa: ARG002
) -> None:
    """Post-process Griffe functions to add a parameters section.

    It applies only for dynamic analysis.
    """
    if isinstance(node, ObjectNode):
        self._handle_function(func, node=node)

on_package ¤

on_package(*, pkg: Module, **kwargs: Any) -> None

Post-process Griffe packages recursively (non-yet handled objects only).

Source code in src/griffe_typingdoc/_internal/extension.py 
119
120
121
122
123
124
125
126
127
128
129
def on_package(
    self,
    *,
    pkg: Annotated[
        Module,
        Doc("The top-level module representing a package."),
    ],
    **kwargs: Any,  # noqa: ARG002
) -> None:
    """Post-process Griffe packages recursively (non-yet handled objects only)."""
    self._handle_object(pkg)