Enum Error 

#[non_exhaustive]
pub enum Error {
    FeatureDisabled {
        name: &'static str,
        needed_for: &'static str,
    },
    PlatformUnsupported {
        platform: &'static str,
    },
    UnknownPreset {
        name: String,
        known: &'static [&'static str],
    },
    WatchUnavailable {
        reason: &'static str,
    },
    NoVariant {
        mode: ColorMode,
    },
    Toml(Error),
    Io(Error),
    ResolutionIncomplete {
        missing: Vec<String>,
    },
    ResolutionInvalid {
        errors: Vec<RangeViolation>,
    },
    ReaderFailed {
        reader: &'static str,
        source: Box<dyn Error + Send + Sync>,
    },
}

Errors that can occur when reading or processing theme data.

This is a flat enum with 10 variants. Use Error::kind() for coarse dispatch without matching every variant.

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.

FeatureDisabled

The platform has a theme reader, but the Cargo feature that compiles it is not enabled (macos on macOS, windows on Windows).

Fields

name: &'static str

Feature name (e.g. "kde", "portal").

needed_for: &'static str

What the feature is needed for (e.g. "KDE theme detection").

PlatformUnsupported

The current platform is not supported.

Fields

platform: &'static str

Platform identifier (e.g. "wasm", "freebsd").

UnknownPreset

A preset name was not found in the bundled set.

Fields

name: String

The requested preset name.

known: &'static [&'static str]

Available preset names.

WatchUnavailable

Theme-change watching is not available: no backend for this desktop environment, or the platform’s feature is disabled.

Fields

reason: &'static str

Why watching is unavailable.

NoVariant

The theme has no variant for the requested color mode.

Returned by Theme::pick_variant() and Theme::into_variant() when the theme has neither a light nor a dark variant set.

Fields

mode: ColorMode

The color mode that was requested.

Toml(Error)

TOML parsing error. (Serialization errors from Theme::to_toml are ReaderFailed with reader "toml-serializer".)

Io(Error)

File I/O error.

ResolutionIncomplete

Theme resolution found missing fields that could not be inherited.

Fields

missing: Vec<String>

Dot-separated paths of fields still None after resolution.

ResolutionInvalid

Theme resolution found numeric values outside allowed ranges.

Fields

errors: Vec<RangeViolation>

One entry per out-of-range property.

ReaderFailed

A platform reader failed with a platform-specific error.

Fields

reader: &'static str

Reader name (e.g. "kde", "windows", "icon-theme").

source: Box<dyn Error + Send + Sync>

The underlying error.

Implementations

impl Error

pub fn kind(&self) -> ErrorKind

Returns the coarse ErrorKind for this error.

Useful for broad dispatch (e.g. “is this a platform problem or a parse problem?”) without matching every variant.

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, f: &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(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.