Enum BackendError 

pub enum BackendError {
    Io(Error),
    IoWithContext {
        operation: &'static str,
        path: PathBuf,
        source: Error,
    },
    Serialization(String),
    Connection(String),
    Unavailable(String),
    DigestMismatch {
        expected: String,
        actual: String,
    },
    BlobNotFound {
        digest: String,
    },
    ActionNotFound {
        digest: String,
    },
}

Error types for cache backend operations

Variants

Io(Error)

IO error during cache operations (generic, for #[from] compatibility)

IoWithContext

IO error with path context for better diagnostics

Fields

operation: &'static str

path: PathBuf

source: Error

Serialization(String)

Serialization error

Connection(String)

Remote connection error

Unavailable(String)

Remote cache unavailable (gracefully degradable)

This error indicates the cache is temporarily unavailable but execution should continue without caching. Callers should handle this gracefully.

DigestMismatch

Digest mismatch during download

Fields

expected: String

actual: String

BlobNotFound

Blob not found in CAS

Fields

digest: String

ActionNotFound

Action result not found

Fields

digest: String

Implementations

impl BackendError

pub fn is_gracefully_degradable(&self) -> bool

Returns true if this error indicates the cache is unavailable but execution should continue without caching (graceful degradation).

pub fn io_with_context( operation: &'static str, path: impl Into<PathBuf>, source: Error, ) -> Self

Create an IO error with path context

Trait Implementations

impl Debug for BackendError

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

Formats the value using the given formatter.

impl Display for BackendError

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

Formats the value using the given formatter.

impl Error for BackendError

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<BackendError> for CacheError

fn from(source: BackendError) -> Self

Converts to this type from the input type.

impl From<Error> for BackendError

fn from(source: Error) -> Self

Converts to this type from the input type.