xtr_orm_messenger.exception ¶
Everything this library raises, each one an :class:OrmMessengerError.
InvalidOrmDsnError ¶
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 ¶
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.