Enum ConfigError 

#[non_exhaustive]
pub enum ConfigError {
    UnsupportedExtension(String),
    NotFound(String),
    Read {
        path: String,
        source: Error,
    },
    Parse {
        path: String,
        source: Box<ConfigParseSource>,
        source_code: Option<NamedSource<String>>,
        span: Option<SourceSpan>,
    },
    Validation {
        path: String,
        value_path: String,
        message: String,
        source_code: Option<NamedSource<String>>,
        span: Option<SourceSpan>,
    },
    CssParse {
        path: String,
        message: String,
        source_code: Option<NamedSource<String>>,
        span: Option<SourceSpan>,
    },
    Schema(Error),
    DtcgParse {
        path: String,
        source_code: Option<NamedSource<String>>,
        span: Option<SourceSpan>,
        reason: String,
    },
    DtcgAlias {
        path: String,
        source_code: Option<NamedSource<String>>,
        cycle: Vec<String>,
        reason: String,
    },
    TailwindUnavailable {
        reason: String,
    },
    TailwindBadPath {
        path: String,
        reason: String,
    },
    TailwindEval {
        path: String,
        reason: String,
        stderr: String,
    },
}

Config-loading errors.

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.

UnsupportedExtension(String)

File extension isn’t one we recognize.

NotFound(String)

The file is missing.

Read

The file exists but could not be read.

Fields

path: String

Path that failed to read.

source: Error

Underlying I/O error.

Parse

The file exists but couldn’t be parsed or the content didn’t match the config schema.

The Display message intentionally omits {source} — the chained ConfigParseSource (transparent) prints the underlying toml / figment span block once via the standard Error::source() walk. Embedding {source} here would duplicate the span block in anyhow::Error::chain output.

Fields

path: String

Path that failed to parse.

source: Box<ConfigParseSource>

Underlying parse error.

source_code: Option<NamedSource<String>>

Source text for span-annotated diagnostics.

span: Option<SourceSpan>

Label pointing at the invalid config span, when available.

Validation

The file parsed structurally but failed semantic validation (e.g. a palette token whose value isn’t a hex color).

Fields

path: String

Path of the file that failed validation.

value_path: String

Dotted path of the offending value (e.g. color.tokens.bg).

message: String

Why the value is invalid.

source_code: Option<NamedSource<String>>

Source text for span-annotated diagnostics.

span: Option<SourceSpan>

Label pointing at the offending value, when the source format allows span recovery.

CssParse

A CSS source (e.g. a token sheet passed to scrape_css_properties) was malformed and could not be scanned.

Fields

path: String

Path of the file that failed to parse.

message: String

Human-readable description of the offending region.

source_code: Option<NamedSource<String>>

Source text for span-annotated diagnostics.

span: Option<SourceSpan>

Label pointing at the offending region.

Schema(Error)

Schema emission failed.

DtcgParse

A DTCG import failed at the parsing or value-conversion stage.

Fields

path: String

Path of the failing DTCG document.

source_code: Option<NamedSource<String>>

Source text for span-annotated diagnostics.

span: Option<SourceSpan>

Best-effort label location, when the parser could pin one.

reason: String

Human-readable explanation.

DtcgAlias

A DTCG alias either dangles or forms a cycle.

Fields

path: String

Path of the DTCG document where the alias error was raised.

source_code: Option<NamedSource<String>>

Source text for span-annotated diagnostics.

cycle: Vec<String>

Slash-joined token paths in the order the resolver visited them.

reason: String

Human-readable explanation.

TailwindUnavailable

The Tailwind adapter could not run because Node is missing or otherwise unavailable.

Fields

reason: String

Why the adapter couldn’t run (missing Node, missing override, …).

TailwindBadPath

The Tailwind config path is malformed or escapes the project tree.

Fields

path: String

User-supplied tailwind config path.

reason: String

Why we rejected it.

TailwindEval

Node ran but the Tailwind config evaluation failed.

Fields

path: String

User-supplied tailwind config path.

reason: String

Reason text — either the loader’s structured error or the shape of the subprocess failure.

stderr: String

Captured stderr from the Node subprocess. Empty when the child closed without writing diagnostics.

Trait Implementations

impl Debug for ConfigError

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

Formats the value using the given formatter.

impl Diagnostic for ConfigError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for ConfigError

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

Formats the value using the given formatter.

impl Error for ConfigError

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.