OutcomeUnknownError

Part of Exceptions in the Python API reference.

Related guidance: reference/exceptions, how-to/troubleshooting.

Runnable examples: preflight.py.

from picogrid_ecn_client import OutcomeUnknownError

Report a mutation that may have reached the broker or downstream handler.

class OutcomeUnknownError(DeliveryError): ...

Source · exceptions.py

Hierarchy: ECNClientError → DeliveryError → OutcomeUnknownError

__init__

Initialize one delivery failure whose mutation outcome is unknown.

def __init__(
    message: object,
    *,
    delivery_phase: DeliveryPhase,
    operation: str,
    task_id: str | None = None,
    operation_id: UUID | None = None,
    code: str | None = None,
    status_code: int | None = None,
    details: Mapping[str, object] | None = None,
    secrets: tuple[str, ...] = (),
) -> None

Parameters

Name	Type	Default	Description
message	object	—	Failure message to redact and expose.
delivery_phase	DeliveryPhase	—	Uncertain delivery phase established at failure.
operation	str	—	Stable public operation name.
task_id	str | None	None	Generated task correlation identifier, when applicable.
operation_id	UUID | None	None	Generated publication operation identifier, when applicable.
code	str | None	None	Optional stable error-code override.
status_code	int | None	None	Optional status value associated with the failure.
details	Mapping[str, object] | None	None	Optional additional secret-safe structured details.
secrets	tuple[str, …]	()	Additional exact values to remove from public text.

Raises

Exception	Description
ValueError	If delivery_phase is not an uncertainty phase.

Source · exceptions.py