cayu.failure_evidence
Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.
FailureEvidence
Section titled “FailureEvidence”from cayu.workflows import FailureEvidenceBounded failure snapshot with flat, ordered parallel branch evidence.
Branches carry the same diagnostic fields but cannot recursively contain branches. Nested fan-outs are flattened in submission order, up to 16 leaves. Settlement is always unknown, including when a deadline is retained.
Bases: _FailureEvidenceFields.
Fields and attributes
Section titled “Fields and attributes”Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.
| Name | Type | Default |
|---|---|---|
classification |
Literal['deadline', 'timeout', 'interruption', 'failure', 'unknown'] |
'unknown' |
deadline |
ExecutionDeadline | None |
None |
deadline_phase |
Literal['admission', 'in_flight'] | None |
None |
exception_types |
tuple[Annotated[str, Field(max_length=128, pattern='^[A-Za-z_][A-Za-z0-9_]*$')], ...] |
Field(default=(), max_length=16) |
truncated |
bool |
False |
secondary_failures |
bool |
False |
session_id |
str | None |
Field(default=None, max_length=2048) |
run_epoch |
int | None |
Field(default=None, ge=0) |
terminal_event_id |
str | None |
Field(default=None, max_length=512) |
settlement |
Literal['unknown'] |
'unknown' |
branch_failures |
tuple[_FailureEvidenceFields, ...] |
Field(default=(), max_length=16, exclude_if=lambda value: not value) |
validate_deadline_evidence (method)
Section titled “validate_deadline_evidence (method)”FailureEvidence.validate_deadline_evidence() -> _FailureEvidenceFields