Enum Error 

#[non_exhaustive]
pub enum Error {
    FileRead {
        path: PathBuf,
        source: Error,
    },
    FileWrite {
        path: PathBuf,
        source: Error,
    },
    DirectoryCreate {
        path: PathBuf,
        source: Error,
    },
    PathTraversal {
        path: PathBuf,
    },
    InvalidWireFormat {
        offset: usize,
        details: String,
    },
    VarintDecode {
        offset: usize,
    },
    DescriptorParse(DecodeError),
    DescriptorBuild(String),
    NoDescriptorsFound,
    InvalidFieldNumber {
        number: u32,
        max: u32,
    },
    UnsupportedSyntax {
        syntax: String,
    },
    Internal(String),
}

Comprehensive error type for all zarja operations

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

FileRead

Failed to read input file

Fields

path: PathBuf

Path to the file that failed to read

source: Error

Underlying I/O error

FileWrite

Failed to write output file

Fields

path: PathBuf

Path to the file that failed to write

source: Error

Underlying I/O error

DirectoryCreate

Failed to create output directory

Fields

path: PathBuf

Path to the directory that failed to create

source: Error

Underlying I/O error

PathTraversal

Path traversal attempt detected (security error)

Fields

path: PathBuf

The suspicious path

InvalidWireFormat

Invalid protobuf wire format

Fields

offset: usize

Byte offset where the error occurred

details: String

Detailed description of the issue

VarintDecode

Failed to decode varint

Fields

offset: usize

Byte offset where the error occurred

DescriptorParse(DecodeError)

Failed to parse FileDescriptorProto

DescriptorBuild(String)

Failed to build file descriptor with prost-reflect

NoDescriptorsFound

No descriptors found in input

InvalidFieldNumber

Invalid field number in descriptor

Fields

number: u32

The invalid field number

max: u32

Maximum valid field number

UnsupportedSyntax

Unsupported proto syntax version

Fields

syntax: String

The unsupported syntax string

Internal(String)

Generic internal error

Implementations

impl Error

pub fn file_read(path: impl Into<PathBuf>, source: Error) -> Self

Creates a new file read error

pub fn file_write(path: impl Into<PathBuf>, source: Error) -> Self

Creates a new file write error

pub fn directory_create(path: impl Into<PathBuf>, source: Error) -> Self

Creates a new directory creation error

pub fn path_traversal(path: impl Into<PathBuf>) -> Self

Creates a new path traversal error

pub fn invalid_wire_format(offset: usize, details: impl Into<String>) -> Self

Creates a new wire format error

pub fn varint_decode(offset: usize) -> Self

Creates a new varint decode error

pub fn descriptor_build(msg: impl Into<String>) -> Self

Creates a new descriptor build error

pub fn internal(msg: impl Into<String>) -> Self

Creates a new internal error

pub fn is_recoverable(&self) -> bool

Returns true if this is a recoverable error that should be skipped

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DecodeError> for Error

fn from(source: DecodeError) -> Self

Converts to this type from the input type.