Skip to content

errors

etrack.infra.errors

infra/errors: the one root of every error — each layer imports its exceptions from here, none defines its own.

CoreError is the root. One branch per kind of module: ProviderError (a provider failed at its border), ProcessorError, LogicError and OpsError. A provider fails as a driver (DriverError: a system outside the process) or as an adapter (AdapterError: a library inside it). A sink is met on both natures — the OTLP exporter over the wire, the live buffer in memory — so SinkError is honestly both.

AdapterError

AdapterError(message: str)

Bases: ProviderError

A library inside the process failed: it refused its input, or the provider it wraps is not open.

AuthError

AuthError(message: str)

Bases: DriverError

Credentials that cannot be found or refreshed: a driver cannot sign what it sends.

BusError

BusError(message: str)

Bases: AdapterError

The bus is not open, or was asked to deliver through a closed stream.

ChannelError

ChannelError(message: str)

Bases: LogicError, ValueError

An event the channel cannot validate against its model: a reserved key missing or of the wrong type.

CoreError

CoreError(message: str)

Bases: Exception

All etrack exceptions inherit from this root.

DriverError

DriverError(message: str)

Bases: ProviderError

A system outside the process failed: unreachable, refusing, slow, or answering outside its contract.

FactError

FactError(message: str)

Bases: LogicError, TypeError

A fact that does not meet its own class: a field of the wrong type, or a label that is no closed set.

FileError

FileError(message: str)

Bases: OpsError, TypeError

A discovery target of a kind the finder does not sweep.

LayoutError

LayoutError(message: str)

Bases: ProcessorError, ValueError

A topology that cannot be placed: an edge to a node it does not declare.

LogicError

LogicError(message: str)

Bases: CoreError

The library's core refused a call.

OpsError

OpsError(message: str)

Bases: CoreError

An agnostic tool refused its input.

ProcessorError

ProcessorError(message: str)

Bases: CoreError

A transformation refused its input.

ProviderError

ProviderError(message: str)

Bases: CoreError

A provider failed at its border: what a third-party library raised, or a call on a provider that is not open.

ServerError

ServerError(message: str)

Bases: AdapterError

A server that did not answer on its address, or stopped before it did.

SinkError

SinkError(message: str)

Bases: DriverError, AdapterError

A sink that is not open, or refused what it was sent.

SourceError

SourceError(message: str)

Bases: AdapterError

A source that cannot bind a run: the host's config is not of the shape its framework takes.