Collector

Test result collector for pytest-agent-digest.

CLASS	DESCRIPTION
`ReportCollector`	Accumulates the `TestResult` objects while a pytest session runs.
`TestResult`	Represents a single test outcome captured during a pytest session.
`WarningRecord`	Represents a single warning captured during a pytest session.

FUNCTION	DESCRIPTION
`strip_ansi`	Remove ANSI escape sequences from text.

Classes¶

ReportCollector ¶

ReportCollector()

Accumulates the TestResult objects while a pytest session runs.

Wire this into pytest_configure (instantiate) and pytest_runtest_logreport (call add) so the renderer can consume a fully populated collector at the session end.

Initialize with empty result and warning lists.

METHOD	DESCRIPTION
`add`	Classify report and append a `TestResult` class if it is a call phase.
`add_warning`	Capture a pytest warning and append a `WarningRecord`.

ATTRIBUTE	DESCRIPTION
`counts`	Return a dict of `{outcome: count}` with zero-count keys omitted. TYPE: `dict[str, int]`
`has_failures`	Return `True` if any result is `"failed"` or `"xpassed"`. TYPE: `bool`

Attributes¶

counts `property` ¶

counts: dict[str, int]

Return a dict of {outcome: count} with zero-count keys omitted.

RETURNS	DESCRIPTION
`dict[str, int]`	Mapping from the outcome string to the number of results with that outcome.

has_failures `property` ¶

has_failures: bool

Return True if any result is "failed" or "xpassed".

RETURNS	DESCRIPTION
`bool`	`True` when there is at least one failure or unexpected pass.

Functions¶

add ¶

add(report: TestReport) -> None

Classify report and append a TestResult class if it is a call phase.

report.when == "call" reports are stored for normal outcomes. report.when == "setup" reports are stored only when skipped, because @pytest.mark.skip raises a Skipped exception during the setup phase and never produces a call-phase report.

PARAMETER	DESCRIPTION
`report`	The pytest test report to classify and store. TYPE: `TestReport`

add_warning ¶

add_warning(warning_message: WarningMessage, when: str, nodeid: str, location: Optional[tuple[str, int, str]]) -> None

Capture a pytest warning and append a WarningRecord.

PARAMETER	DESCRIPTION
`warning_message`	The `warnings.WarningMessage` instance from the hook. TYPE: `WarningMessage`
`when`	The phase when the warning was recorded (`"config"`, `"collect"`, or `"runtest"`). TYPE: `str`
`nodeid`	The node ID of the test that triggered the warning, or `""` for session-level warnings. TYPE: `str`
`location`	A `(filename, lineno, function)` tuple, or `None`. TYPE: `Optional[tuple[str, int, str]]`

TestResult `dataclass` ¶

TestResult(node_id: str, outcome: str, longrepr: Optional[str], duration: float, skip_reason: Optional[str])

Represents a single test outcome captured during a pytest session.

ATTRIBUTE	DESCRIPTION
`node_id`	The pytest node ID (e.g. `tests/test_foo.py::test_bar`). TYPE: `str`
`outcome`	One of `"passed"`, `"failed"`, `"skipped"`, `"xfailed"`, `"xpassed"`. TYPE: `str`
`longrepr`	Formatted traceback or reason string, stripped of ANSI codes. `None` when not applicable. TYPE: `Optional[str]`
`duration`	Test duration in seconds. TYPE: `float`
`skip_reason`	Human-readable skip reason for skipped tests; `None` otherwise. TYPE: `Optional[str]`

WarningRecord `dataclass` ¶

WarningRecord(message: str, category: str, nodeid: str, when: str, location: Optional[tuple[str, int, str]])

Represents a single warning captured during a pytest session.

ATTRIBUTE	DESCRIPTION
`message`	The warning message text. TYPE: `str`
`category`	The warning category class name (e.g. `"DeprecationWarning"`). TYPE: `str`
`nodeid`	The pytest node ID that triggered the warning, or `""` for session-level warnings. TYPE: `str`
`when`	The phase when the warning was recorded (`"config"`, `"collect"`, or `"runtest"`). TYPE: `str`
`location`	A `(filename, lineno, function)` tuple identifying the warning site, or `None`. TYPE: `Optional[tuple[str, int, str]]`

Functions¶

strip_ansi ¶

strip_ansi(text: str) -> str

Remove ANSI escape sequences from text.

PARAMETER	DESCRIPTION
`text`	The string that may contain ANSI escape sequences. TYPE: `str`

RETURNS	DESCRIPTION
`str`	The input string with all ANSI color/style codes removed.

Collector

Classes¶

ReportCollector ¶

Attributes¶

counts property ¶

has_failures property ¶

Functions¶

add ¶

add_warning ¶

TestResult dataclass ¶

WarningRecord dataclass ¶

Functions¶

strip_ansi ¶

counts `property` ¶

has_failures `property` ¶

TestResult `dataclass` ¶

WarningRecord `dataclass` ¶