Enum ErrorCategory 

pub enum ErrorCategory {
    Io,
    UnknownFormat,
    Parse,
    Data,
    Output,
}

Coarse classification of an Error, for callers that map onto their own taxonomy (the Python layer’s exception subclasses, C ABI status codes, a CLI exit code). Distinguishing “the input file is bad” from “the operation can’t run on this otherwise-valid case” is the split callers actually branch on, and it’s a property of the error, not of the binding that surfaces it.

Unlike Error, this enum is not #[non_exhaustive]. Adding a category makes exhaustive matches fail to compile, which requires each binding to map the new category.

Variants

Io

Underlying I/O failure reading or writing a file.

UnknownFormat

The requested format is unknown or can’t be inferred from the path.

Parse

The input is malformed or unparseable.

Data

A well-formed case can’t satisfy the requested operation.

Output

An output serialization step (matrix-market, Parquet) failed.

Implementations

impl ErrorCategory

pub const TOKENS: [&'static str; 5]

Every category token, for a consumer that wants the closed set without hardcoding it. The C ABI reports errors as text and defines no error codes, so a binding that branches on the kind of failure matches these.

pub fn token(self) -> &'static str

The token for this category, as it appears in a C errbuf message and in pio_build_info.

Trait Implementations

impl Clone for ErrorCategory

fn clone(&self) -> ErrorCategory

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorCategory

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for ErrorCategory

fn eq(&self, other: &ErrorCategory) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ErrorCategory

impl Eq for ErrorCategory

impl StructuralPartialEq for ErrorCategory