Module

autodoc.models.python

Python-specific metadata dataclasses for autodoc system.

Provides typed metadata for:

  • Modules (PythonModuleMetadata)
  • Classes (PythonClassMetadata)
  • Functions/Methods (PythonFunctionMetadata)
  • Attributes (PythonAttributeMetadata)
  • Aliases (PythonAliasMetadata)
  • Parsed docstrings (ParsedDocstring)
  • Parameters (ParameterInfo)

Classes

ParameterInfo dataclass
Single function parameter information.
0

Single function parameter information.

Attributes

Name Type Description
name str

Parameter name

type_hint str | None

Type annotation as string (e.g., "str | None")

default str | None

Default value as string (e.g., "None", "'default'")

kind Literal['positional', 'keyword', 'var_positional', 'var_keyword', 'positional_or_keyword']

Parameter kind (positional, keyword, var_positional, var_keyword)

description str | None

Description from docstring

RaisesInfo dataclass
Exception information from docstring.
0

Exception information from docstring.

Attributes

Name Type Description
type_name str

Exception type name

description str

Description of when raised

ParsedDocstring dataclass
Parsed docstring information.
0

Parsed docstring information.

Attributes

Name Type Description
summary str

One-line summary

description str

Full description (may include summary)

params tuple[ParameterInfo, ...]

Parameter documentation

returns str | None

Return value description

raises tuple[RaisesInfo, ...]

Exception documentation

examples tuple[str, ...]

Code examples

PythonModuleMetadata dataclass
Metadata specific to Python modules.
0

Metadata specific to Python modules.

Attributes

Name Type Description
file_path str

Path to source file

is_package bool

Whether this is a package (init.py)

has_all bool

Whether module defines all

all_exports tuple[str, ...]

Contents of all if present

PythonClassMetadata dataclass
Metadata specific to Python classes.
0

Metadata specific to Python classes.

Attributes

Name Type Description
bases tuple[str, ...]

Base class names

decorators tuple[str, ...]

Decorator names

is_exception bool

Whether class inherits from Exception/BaseException

is_dataclass bool

Whether class has @dataclass decorator

is_abstract bool

Whether class inherits from ABC

parsed_doc ParsedDocstring | None

Parsed docstring

PythonFunctionMetadata dataclass
Metadata specific to Python functions/methods.
0

Metadata specific to Python functions/methods.

Attributes

Name Type Description
signature str

Full signature string (e.g., "def build(self, force: bool = False) -> None")

parameters tuple[ParameterInfo, ...]

Parameter information

return_type str | None

Return type annotation as string

is_async bool

Whether function is async

is_classmethod bool

Whether function has @classmethod decorator

is_staticmethod bool

Whether function has @staticmethod decorator

is_property bool

Whether function has @property decorator

is_generator bool

Whether function uses yield

decorators tuple[str, ...]

Decorator names

parsed_doc ParsedDocstring | None

Parsed docstring

PythonAttributeMetadata dataclass
Metadata specific to Python attributes/class variables.
0

Metadata specific to Python attributes/class variables.

Attributes

Name Type Description
annotation str | None

Type annotation as string

is_class_var bool

Whether this is a class variable

default_value str | None

Default value as string

PythonAliasMetadata dataclass
Metadata for import aliases.
0

Metadata for import aliases.

Attributes

Name Type Description
alias_of str

Qualified name of the aliased entity

alias_kind Literal['assignment', 'import']

Type of alias (assignment or import)