Enum VariantError 

#[non_exhaustive]
pub enum VariantError {
    UnsupportedMimeType(String),
    SourceTooLarge {
        byte_size: u64,
        max_bytes: u64,
    },
    SourceDimensionsTooLarge {
        width: u32,
        height: u32,
        max_width: u32,
        max_height: u32,
    },
    DecodeError(String),
    Storage(BlobStoreError),
}

Errors returned by variant operations.

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.

UnsupportedMimeType(String)

The source blob’s content type is not a supported image format. Only image/jpeg, image/png, and image/webp are accepted.

SourceTooLarge

The source blob exceeds VariantBudget::max_source_bytes.

Fields

byte_size: u64

max_bytes: u64

SourceDimensionsTooLarge

The decoded source image exceeds the pixel budget.

Fields

width: u32

Actual source width.

height: u32

Actual source height.

max_width: u32

Configured maximum width.

max_height: u32

Configured maximum height.

DecodeError(String)

The source bytes could not be decoded as the claimed image format.

Storage(BlobStoreError)

A storage operation failed while checking for or writing the variant.

Implementations

impl VariantError

pub const fn status(&self) -> StatusCode

HTTP status code that best represents this error.

Routes using ? on VariantHandle::url or VariantHandle::ensure_generated get 500 by default via the blanket impl From<E: Error> for AutumnError; call VariantError::into_autumn_error instead to preserve the precise status.

pub fn into_autumn_error(self) -> AutumnError

Promote into an AutumnError carrying the status from VariantError::status.

Use this instead of ? when the route needs accurate HTTP status codes for variant failures (e.g. 422 for a corrupt image, 413 for an oversized source):

let url = handle.url(&*store, &budget, expires)
    .await
    .map_err(VariantError::into_autumn_error)?;

Trait Implementations

impl Debug for VariantError

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

Formats the value using the given formatter.

impl Display for VariantError

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

Formats the value using the given formatter.

impl Error for VariantError

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<BlobStoreError> for VariantError

fn from(source: BlobStoreError) -> Self

Converts to this type from the input type.