pub enum ErrorClass {
Show 30 variants
Io,
Usage,
InvalidContainer,
UnsupportedVersion,
UnsupportedFeature,
IntegrityMismatch,
ResourceLimit,
InvalidGraph,
InvalidModel,
EntropyDecode,
InvalidPdfStructure,
CodecReplay,
MissingExternalObject,
CoverageViolation,
ReconstructionMismatch,
Cancelled,
InvalidZipStructure,
InvalidXmlStructure,
InvalidPackageStructure,
InvalidJsonStructure,
InvalidYamlStructure,
InvalidCsvStructure,
InvalidMarkdownStructure,
InvalidHtmlStructure,
InvalidTomlStructure,
InvalidJsonlStructure,
InvalidEmlStructure,
InvalidParquetStructure,
InvalidArrowStructure,
InternalInvariant,
}Expand description
Stable error classes. These distinguish failure kinds rather than prose.
Variants§
Io
Host I/O failure (read/write/rename/fsync).
Usage
Command-line or API misuse.
InvalidContainer
The container framing/header is malformed.
UnsupportedVersion
The container declares a version this build does not implement.
UnsupportedFeature
The container declares a mandatory feature this build does not support.
IntegrityMismatch
A digest, length, or checksum disagreed with the declared value.
ResourceLimit
A declared or configured resource bound was exceeded.
InvalidGraph
The reconstruction graph is malformed (cycles, bad references, gaps).
InvalidModel
An entropy model descriptor is malformed.
EntropyDecode
An entropy channel failed to decode.
InvalidPdfStructure
A PDF physical/lexical structure error (Phase 3+).
CodecReplay
An exact codec-replay candidate failed (Phase 6+).
MissingExternalObject
A referenced external store object is missing (Phase 9+).
CoverageViolation
The coverage certificate is invalid (gaps or overlapping authorities).
ReconstructionMismatch
Materialization completed but did not equal the source.
Cancelled
The operation was cooperatively cancelled.
InvalidZipStructure
A ZIP container structure error (Phase 12+): malformed or contradictory local/central/ZIP64 records, an ambiguous byte cover, a broken descriptor, multi-disk layout, or a hostile member name.
InvalidXmlStructure
An XML part structure error (Phase 12+, reserved): malformed or forbidden constructs (DOCTYPE/XXE, encoding tricks) in a package part.
InvalidPackageStructure
An OPC/OCF package structure error (Phase 12+, reserved): a missing or
ambiguous main part, content-type abuse, mimetype trick, or an ambiguous
part-name identity.
InvalidJsonStructure
A JSON structured-tree structure error (Phase 21.5+): a malformed token, an unterminated string/container, a bad escape, or a trailing byte after the single top-level value.
InvalidYamlStructure
A YAML structured-tree structure error (Phase 21.6+): a malformed or unsupported construct (a bad indentation, an unterminated quoted scalar, a declined directive/explicit key/flow-context block scalar).
InvalidCsvStructure
A CSV/TSV tabular structure error (Phase 21.7+): an unterminated quoted field, a byte after a closing quote that is neither a delimiter nor an end of record, or an input that is not a table under either delimiter.
InvalidMarkdownStructure
A Markdown prose structure error (Phase 21.8+): a malformed or declined construct (an unterminated fenced code block close, a bad reference definition, or an input that carries no structural mark).
InvalidHtmlStructure
An HTML document structure error (Phase 21.10+): a forbidden construct (a DOCTYPE with an internal subset), a non-UTF-8/UTF-16/NUL byte string, or an input that carries no HTML structure. Malformed HTML is otherwise recovered by the adapter, never a panic.
InvalidTomlStructure
A TOML structure error (Phase 21.11+): a malformed token, an unterminated string/array/inline table, an invalid number or escape, or a violation of TOML’s duplicate-key/redefinition rules (which this adapter enforces).
InvalidJsonlStructure
A JSONL/NDJSON structure error (Phase 21.12+): a non-blank line that is not exactly one JSON value, too few record lines to distinguish the source from a single JSON value, or a non-newline-separated bag of JSON values.
InvalidEmlStructure
An EML/MIME message structure error (Phase 21.13+): no RFC 5322 header block,
a malformed header line, a multipart/* without a boundary, or an invalid
quoted-printable/base64 escape.
InvalidParquetStructure
An Apache Parquet structure error (Phase 21.14+): missing/inconsistent PAR1
magic, an inconsistent footer length, a truncated Thrift-Compact footer, a
page or column-chunk span outside the file, or a value count that disagrees
with the page layout.
InvalidArrowStructure
An Apache Arrow IPC structure error (Phase 21.16+): missing/inconsistent
ARROW1 magic, a truncated or out-of-bounds Flatbuffers metadata table, an
invalid message framing, or a buffer span outside the message body.
InternalInvariant
A bug in this implementation; never a description of malformed input.