pelt error hierarchy.
A single rooted tree (PeltError) carrying a stable code, an actionable
hint, and a docs anchor — matching the Bengal-stack error-design convention
(cf. pounce_errors.py). While pelt lives in-tree the root also subclasses
DataError, so existing except DataErrorhandlers and the
Database facade keep working unchanged; on extraction to a standalone bengal-pelt
theDataError base is dropped and PeltErrorbecomes the sole root.
Every error carries a literalPELT_*code; a catalog test (epic E7) asserts each code
has a troubleshooting heading. Errors survive pickling across process/thread boundaries via
__reduce__() so they can cross a worker boundary intact.
data.drivers._pelt.errors
| Name | Type | Default | Description |
|---|---|---|---|
type
|
|
— | |
qualified_name
|
|
— | |
element_type
|
|
— | |
description
|
|
— | |
source_file
|
|
— | |
line_number
|
|
— | |
is_autodoc
|
|
— | |
autodoc_element
|
|
— | |
_autodoc_template
|
|
— | |
_autodoc_url_path
|
|
— | |
_autodoc_page_type
|
|
— | |
title
|
|
— | |
doc_content_hash
|
|
— |
Symbols on this page
Root of pelt's error tree.
Carries a stablecode (PELT_*), an optional actionable hint, and a docs anchor that derives from…
A TCP/Unix connection could not be established, or an open one was lost.
A pool checkout, connect, or query exceeded its deadline.
The backend sent a message pelt could not parse, or the stream desynced.
A desync is unrecoverable on that connection: the connection is discarded…
Authentication failed (SCRAM-SHA-256 / MD5 / cleartext) or used an unsupported method.
TLS negotiation failed, or the server refused an SSL connection a mode required.
A server-sideErrorResponse.
Carries the 5-character SQLSTATE as the stable code (the PG analog of pounce's semantic error codes); the server's non-localized severity…
PeltError
class
Root of pelt's error tree.
Carries a stablecode (PELT_*), an optional actionable hint, and a docs
anchor that derives from the code unless overridden.
PeltConnectionError
class
A TCP/Unix connection could not be established, or an open one was lost.
PeltTimeoutError
class
A pool checkout, connect, or query exceeded its deadline.
ProtocolError
class
The backend sent a message pelt could not parse, or the stream desynced.
A desync is unrecoverable on that connection: the connection is discarded rather than handing back a possibly-corrupt result.
AuthenticationError
class
Authentication failed (SCRAM-SHA-256 / MD5 / cleartext) or used an unsupported method.
TLSError
class
TLS negotiation failed, or the server refused an SSL connection a mode required.
PostgresError
class
A server-sideErrorResponse.
Carries the 5-character SQLSTATE as the stable code (the PG analog of pounce's semantic
error codes); the server's non-localized severity and optionalDetailride alongside,
and the serverHint field maps onto hint.
View source · /home/runner/work/chirp/chirp/site/../src/chirp/data/drivers/_pelt/errors.py:1