Enum PersistError 

pub enum PersistError {
    Io(Error),
    Serialize(Error),
    Deserialize(String),
    VersionMismatch {
        expected: u32,
        found: u32,
    },
    BadPath(String),
    Permission(String),
}

Available on crate feature client only.

Errors produced by the persistence layer.

Every IO failure from a Persister implementation is mapped to a variant here rather than panicked on; loaders tolerate corrupt/missing files (see FilePersister) by degrading to an empty snapshot.

Variants

Io(Error)

An underlying IO error (read or write) failed.

Serialize(Error)

Serializing the snapshot (or an entry) to the persister’s format failed.

Deserialize(String)

The on-disk snapshot could not be parsed / deserialized.

Reserved for persister implementations that surface (rather than tolerate) deserialization failures; the shipped FilePersister degrades corrupt stores to an empty snapshot instead, so core never constructs this variant. It is retained on the public API for backends that prefer to propagate parse errors.

VersionMismatch

The on-disk snapshot’s version does not match PERSIST_VERSION.

Treated as a typed error (rather than silent empty-snapshot) so callers can distinguish “file was corrupt” from “file was written by a newer/older format we cannot read”.

Fields

expected: u32

The version this loader understands (PERSIST_VERSION).

found: u32

The version actually found on disk.

BadPath(String)

The requested path was unusable (e.g. the OS returned no cache dir).

Permission(String)

The persister could not acquire a required resource (e.g. file lock).

Trait Implementations

impl Debug for PersistError

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

Formats the value using the given formatter.

impl Display for PersistError

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

Formats the value using the given formatter.

impl Error for PersistError

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 PersistError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PersistError

fn from(source: Error) -> Self

Converts to this type from the input type.