Enum ThumbnailError 

#[non_exhaustive]
pub enum ThumbnailError {
    #[non_exhaustive]
    InvalidUriIdentity {
        reason: &'static str,
    },
    #[non_exhaustive]
    InvalidNamespace {
        reason: &'static str,
    },
    #[non_exhaustive]
    CacheRootUnavailable {
        reason: &'static str,
    },
    #[non_exhaustive]
    InvalidCacheRoot {
        path: PathBuf,
        problem: CacheRootProblem,
    },
    #[non_exhaustive]
    InvalidCachePath {
        path: PathBuf,
        problem: CachePathProblem,
    },
    #[non_exhaustive]
    InsecureCacheDirectory {
        path: PathBuf,
        problem: CacheDirectoryProblem,
    },
    #[non_exhaustive]
    Io {
        context: &'static str,
        path: Option<PathBuf>,
        source: Error,
    },
    #[non_exhaustive]
    Png {
        message: String,
    },
    #[non_exhaustive]
    InvalidMetadata {
        reason: &'static str,
    },
    #[non_exhaustive]
    UnsupportedRenderedThumbnail {
        reason: &'static str,
    },
    #[non_exhaustive]
    ResourceLimitExceeded {
        reason: &'static str,
    },
    #[non_exhaustive]
    UnsafeRemoval {
        reason: &'static str,
    },
}

Errors returned by thumbnail cache identity and filesystem operations.

Reason strings carried by variants are diagnostic text for humans and logs. They are not stable machine-matchable API values; callers should use structured variants and typed validation problems for control flow.

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.

#[non_exhaustive]

InvalidUriIdentity

A URI or filename input is not valid for the requested thumbnail context.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

InvalidNamespace

A cache namespace is not valid for filesystem use.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

CacheRootUnavailable

The cache root could not be resolved from XDG environment variables.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

InvalidCacheRoot

An explicitly supplied cache root path is invalid.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

path: PathBuf

Invalid cache root path.

problem: CacheRootProblem

Typed root problem.

#[non_exhaustive]

InvalidCachePath

An explicitly computed cache entry path is invalid.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

path: PathBuf

Invalid cache entry path.

problem: CachePathProblem

Typed path problem.

#[non_exhaustive]

InsecureCacheDirectory

An existing cache directory violates thumbnail cache privacy requirements.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

path: PathBuf

Existing directory path.

problem: CacheDirectoryProblem

Typed directory problem.

#[non_exhaustive]

Io

Filesystem I/O failed.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

context: &'static str

Operation that failed.

path: Option<PathBuf>

Path involved in the operation, when available.

source: Error

Underlying I/O error.

#[non_exhaustive]

Png

PNG data could not be decoded or encoded.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

message: String

PNG diagnostic message.

#[non_exhaustive]

InvalidMetadata

Thumbnail metadata is invalid.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

UnsupportedRenderedThumbnail

Rendered thumbnail bytes are unsupported.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

ResourceLimitExceeded

PNG parsing or thumbnail normalization would exceed configured resource limits.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

#[non_exhaustive]

UnsafeRemoval

Cache entry removal was refused by safety checks.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: &'static str

Diagnostic reason.

Trait Implementations

impl Debug for ThumbnailError

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

Formats the value using the given formatter.

impl Display for ThumbnailError

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

Formats the value using the given formatter.

impl Error for ThumbnailError

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.