Enum FileError 

#[non_exhaustive]
pub enum FileError {
    TooLarge {
        size: usize,
        max: usize,
    },
    InvalidType {
        got: String,
        allowed: Vec<String>,
    },
    MimeMismatch {
        declared: String,
        detected: String,
    },
    Storage {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Processing {
        message: String,
    },
    NotFound {
        id: String,
    },
    VirusDetected {
        details: String,
    },
    QuotaExceeded,
}

Errors that occur during file upload, validation, storage, or retrieval.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

TooLarge

The uploaded file exceeds the configured maximum size.

Fields

size: usize

Actual size of the uploaded file in bytes.

max: usize

Maximum allowed file size in bytes.

InvalidType

The file’s extension or declared MIME type is not on the allow-list.

Fields

got: String

The MIME type or extension that was supplied.

allowed: Vec<String>

The set of allowed MIME types or extensions.

MimeMismatch

The file’s declared MIME type does not match its detected MIME type.

This can indicate a spoofed Content-Type header.

Fields

declared: String

The MIME type stated by the client.

detected: String

The MIME type detected by content inspection.

Storage

An error occurred while writing to or reading from the backing storage system (e.g. local disk, object store).

Fields

message: String

Description of the storage failure.

source: Option<Box<dyn Error + Send + Sync>>

Optional chained error from the storage backend.

Processing

An error occurred while processing the file contents (e.g. image resizing, format conversion).

Fields

message: String

Description of the processing failure.

NotFound

The requested file does not exist in the storage backend.

Fields

id: String

Identifier of the file that was not found.

VirusDetected

A virus or malware scanner flagged the uploaded file.

Fields

details: String

Scanner-provided details about the detected threat (server-side only).

QuotaExceeded

The user or tenant has exhausted their file storage quota.

Implementations

impl FileError

pub const fn error_code(&self) -> &'static str

Returns a short, stable error code string suitable for API responses and structured logging.

Trait Implementations

impl Debug for FileError

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

Formats the value using the given formatter.

impl Display for FileError

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

Formats the value using the given formatter.

impl Error for FileError

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<FileError> for RuntimeError

fn from(source: FileError) -> Self

Converts to this type from the input type.