Enum ArtifactError 

pub enum ArtifactError {
    NotFound(String),
    BadMagic,
    BadVersion(u32),
    BadHmac,
    HashMismatch {
        expected: String,
        actual: String,
    },
    Decompression(String),
    Metadata(String),
    TooLarge {
        actual: usize,
        limit: usize,
    },
    Io,
}

Errors returned by ArtifactStore implementations.

Io deliberately collapses the inner std::io::Error into a unit-variant so the type stays PartialEq-able by callers that match on it; the underlying error is logged at the call site. The JIT L2 cache uses the same “log + swallow” convention for I/O failures and treats them as a miss.

Variants

NotFound(String)

BadMagic

BadVersion(u32)

BadHmac

HashMismatch

Fields

expected: String

actual: String

Decompression(String)

Metadata(String)

(De)serialisation of an ArtifactMetadata sidecar failed. Carries the serde error rendered to a string so the variant stays PartialEq-compatible with the rest of ArtifactError (which deliberately avoids embedding non-Eq inner error types). Only reachable through the metadata-aware paths (DiskArtifactStore::put_with_metadata / DiskArtifactStore::metadata); the plain put/get round-trip never touches a sidecar.

TooLarge

Either the payload handed to put exceeded MAX_PAYLOAD_LEN, or the body handed to get decompressed to more than MAX_DECOMPRESSED_LEN bytes. Carries the offending size and the cap that was tripped so operators can tell which side of the round-trip refused the request. Both fields are usize (i.e. Eq) so this variant stays compatible with any future PartialEq derive on ArtifactError.

Fields

actual: usize

limit: usize

Io

Trait Implementations

impl Debug for ArtifactError

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

Formats the value using the given formatter.

impl Display for ArtifactError

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

Formats the value using the given formatter.

impl Error for ArtifactError

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.