Enum StorageError 

pub enum StorageError {
    Io(Error),
    Mmap(MmapIoError),
    InvalidRange {
        start: u64,
        end: u64,
    },
    Failed(String),
    TmpClaimed(PathBuf),
    NotReadable,
    Cancelled,
}

Errors produced by storage primitives.

Notes:

• We intentionally keep this error type fairly small at this stage.
• Higher-level crates may wrap this error to add domain context (resource key, URL, etc.).

Variants

Io(Error)

Mmap(MmapIoError)

InvalidRange

Fields

start: u64

end: u64

Failed(String)

TmpClaimed(PathBuf)

The atomic-chunked temp path is already claimed by another writer (different AssetStore instance, possibly cross-process). The caller should either wait for the holder to release (commit or drop) and retry, or fall through to a read-only / passthrough view of the canonical path once committed.

Reported by crate::AtomicChunked::open when the sibling temp file already exists on disk. Filesystem-level signal — no in-process registry involved.

NotReadable

A read targeted a resource whose processing pipeline has not yet committed (e.g. AES-128 segment reactivated for re-fetch). The underlying bytes either still hold ciphertext or are stale; the caller should treat this as transient and retry once the writer completes its commit.

Cancelled

Trait Implementations

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

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 StorageError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<MmapIoError> for StorageError

fn from(source: MmapIoError) -> Self

Converts to this type from the input type.