Enum Error 

pub enum Error {
    InvalidArchive(ZipError),
    Json(Error),
    Io(Error),
    MissingFile {
        path: String,
    },
    InvalidManifest {
        reason: String,
    },
    UnsupportedVersion {
        version: String,
    },
    HashMismatch {
        path: String,
        expected: String,
        actual: String,
    },
    DocumentIdMismatch {
        expected: String,
        actual: String,
    },
    InvalidStateTransition {
        from: DocumentState,
        to: DocumentState,
    },
    StateRequirementNotMet {
        state: DocumentState,
        requirement: String,
    },
    PathTraversal {
        path: String,
    },
    UnsupportedHashAlgorithm {
        algorithm: String,
    },
    InvalidHashFormat {
        value: String,
    },
    FileNotFound {
        path: PathBuf,
    },
    InvalidCertificate {
        reason: String,
    },
    Network {
        message: String,
    },
    NotImplemented {
        feature: String,
    },
    ImmutableDocument {
        action: String,
        state: DocumentState,
    },
    ExtensionNotAvailable {
        extension: String,
    },
    ValidationFailed {
        reason: String,
    },
    SignatureError {
        reason: String,
    },
    EncryptionError {
        reason: String,
    },
    FileTooLarge {
        path: String,
        size: u64,
        limit: u64,
    },
    InvalidArchiveStructure {
        reason: String,
    },
}

Errors that can occur when working with Codex documents.

Variants

InvalidArchive(ZipError)

The file is not a valid ZIP archive.

Json(Error)

JSON parsing or serialization failed.

Io(Error)

I/O operation failed.

MissingFile

A required file is missing from the archive.

Fields

path: String

Path of the missing file.

InvalidManifest

The manifest is invalid.

Fields

reason: String

Description of the validation failure.

UnsupportedVersion

The document’s Codex version is not supported.

Fields

version: String

The unsupported version string.

HashMismatch

Hash verification failed.

Fields

path: String

Path of the file with mismatched hash.

expected: String

Expected hash value.

actual: String

Actual computed hash value.

DocumentIdMismatch

Document ID verification failed.

Fields

expected: String

Expected document ID.

actual: String

Actual computed document ID.

InvalidStateTransition

Invalid document state transition.

Fields

from: DocumentState

Current state.

to: DocumentState

Attempted target state.

StateRequirementNotMet

State requirements not met.

Fields

state: DocumentState

The document state with unmet requirements.

requirement: String

Description of the unmet requirement.

PathTraversal

Path traversal attempt detected (security).

Fields

path: String

The suspicious path.

UnsupportedHashAlgorithm

Hash algorithm is not supported.

Fields

algorithm: String

The unsupported algorithm identifier.

InvalidHashFormat

Invalid hash format.

Fields

value: String

The invalid hash string.

FileNotFound

File not found.

Fields

path: PathBuf

Path to the missing file.

InvalidCertificate

Invalid certificate.

Fields

reason: String

Description of the certificate issue.

Network

Network operation failed.

Fields

message: String

Description of the network error.

NotImplemented

Feature not implemented.

Fields

feature: String

Description of the unimplemented feature.

ImmutableDocument

Cannot modify document in immutable state.

Fields

action: String

The action that was attempted.

state: DocumentState

Current document state.

ExtensionNotAvailable

Extension not found or not loaded.

Fields

extension: String

Name of the missing extension.

ValidationFailed

Content validation failed.

Fields

reason: String

Description of the validation failure.

SignatureError

Signature operation failed.

Fields

reason: String

Description of the signature issue.

EncryptionError

Encryption operation failed.

Fields

reason: String

Description of the encryption issue.

FileTooLarge

File exceeds the maximum allowed size (decompression bomb protection).

Fields

path: String

Path of the oversized file.

size: u64

Actual or declared size in bytes.

limit: u64

Maximum allowed size in bytes.

InvalidArchiveStructure

Archive structure is invalid.

Fields

reason: String

Description of the structural issue.

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ZipError> for Error

fn from(source: ZipError) -> Self

Converts to this type from the input type.