Skip to content

xtr_orm_messenger.exception

Everything this library raises, each one an :class:OrmMessengerError.

InvalidOrmDsnError

InvalidOrmDsnError(transport: str, connection: str, known: tuple[str, ...])

Bases: OrmMessengerError, LookupError

An orm:// DSN names a connection the application does not configure.

Also a :class:LookupError, as a missing key in any other mapping is.

Attributes:

  • transport (str) –

    The transport whose DSN names it.

  • connection (str) –

    The connection named.

  • known (tuple[str, ...]) –

    Every connection that is configured.

Record the transport, the connection it named and the ones that exist.

OrmMessengerError

Bases: MessageBusError

Base class for every error raised by this library.

Also a :class:~xtr_messenger.MessageBusError, so code catching what the bus can go wrong with catches this transport's failures too.

TransportError

TransportError(transport: str, operation: str, reason: str)

Bases: OrmMessengerError

The database refused what a transport asked of it.

Raised from the driver's own error, which stays the cause, so nothing it said is lost. The message names the transport and the operation, never the connection's URL, whose credentials a traceback would otherwise carry.

Attributes:

  • transport (str) –

    The transport the operation was for.

  • operation (str) –

    What was asked — send, get, ack, ...

  • reason (str) –

    What went wrong.

Record which transport failed, at what, and why.