Enum Error 

pub enum Error {
    VaultNotFound,
    InvalidFileName,
    FileAlreadyExists(String),
    CreateTempFile {
        path: PathBuf,
        source: Error,
    },
    WriteChunkFailure {
        path: PathBuf,
        source: Error,
    },
    StreamReadError(Error),
    RenameError {
        path: PathBuf,
        source: Error,
    },
    InvalidPath {
        path: PathBuf,
    },
    Internal(Error),
    NotFound,
}

Errors that can occur in the storage layer.

These are filesystem and transaction-level failures. Most are internal and should never be exposed to the client in detail. The IntoResponse implementation handles sanitization automatically.

Variants

VaultNotFound

The vault directory does not exist on disk. This is a fatal misconfiguration and means the server was started with an invalid vault_path.

InvalidFileName

The provided filename contained illegal characters (/, \, or was empty). This protects against path traversal attacks.

FileAlreadyExists(String)

A file with this name already exists at the target path. This is returned when a duplicate upload is attempted for the exact same filename.

CreateTempFile

The server failed to create the temporary staging file before streaming begins.

Fields

path: PathBuf

source: Error

WriteChunkFailure

A write to disk failed mid-stream while appending a chunk to the temporary file.

Fields

path: PathBuf

source: Error

StreamReadError(Error)

Reading the next chunk from the incoming network stream failed.

RenameError

The atomic rename from the temporary staging file to the final CAS path failed.

Fields

path: PathBuf

source: Error

InvalidPath

The constructed path pointed outside the vault directory.

Fields

path: PathBuf

Internal(Error)

A low-level internal error, typically from integer or time conversions.

NotFound

The requested blob was not found in the vault.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SystemTimeError> for Error

fn from(e: SystemTimeError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for Error

fn from(e: TryFromIntError) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.

impl Loggable for Error

fn log_level(&self) -> Level

Returns the severity level that should be assigned to this error in the log.

fn log_module(&self) -> Module

Returns the server module responsible for this error.