Enum VaultError 

pub enum VaultError {
    NotFound {
        path: String,
    },
    NotDownloaded {
        path: String,
    },
    PermissionDenied {
        path: String,
    },
    OutsideRoot {
        path: String,
    },
    ReadOnly {
        path: String,
    },
    InvalidPath(VaultPathError),
    Io {
        path: String,
        source: Error,
    },
}

Storage failures, classified so callers can map them without inspecting io::ErrorKinds themselves.

Variants

NotFound

Fields

path: String

NotDownloaded

The file is listed but its content is not on this device (see Availability::NotDownloaded).

Fields

path: String

PermissionDenied

Fields

path: String

OutsideRoot

The path resolves (through a symlink) to somewhere outside the vault. path names the resolved target.

Fields

path: String

ReadOnly

The path is inside a read-only part of the vault — a symlink mount (Vault::is_read_only) — and the operation would write there.

Fields

path: String

InvalidPath(VaultPathError)

Io

Fields

path: String

source: Error

Implementations

impl VaultError

pub fn from_io(path: impl Display, source: Error) -> Self

Classifies an io::Error raised for path.

ErrorKind::Deadlock is EDEADLK, which is what a read of a dataless file returns on Apple platforms when the reading thread has opted out of materializing it — so it means “not downloaded” wherever it occurs. The mapping needs no platform cfg: no other read returns it.

pub fn is_not_found(&self) -> bool

pub fn not_found(path: impl Display) -> Self

Trait Implementations

impl Debug for VaultError

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

Formats the value using the given formatter.

impl Display for VaultError

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

Formats the value using the given formatter.

impl Error for VaultError

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

Lossy but kind-preserving: handlers that answer with an HTTP status derived from io::ErrorKind (404 for NotFound, 403 for PermissionDenied) keep answering the same status.

fn from(error: VaultError) -> Self

Converts to this type from the input type.

impl From<VaultPathError> for VaultError

fn from(source: VaultPathError) -> Self

Converts to this type from the input type.