Enum Error 

pub enum Error {
    FileNotFound(PathBuf),
    Io {
        path: PathBuf,
        source: Error,
    },
    Parse {
        path: String,
        source: Error,
    },
    Serialize(Error),
    Validation {
        context: String,
        reason: String,
    },
    Invalid(ValidationErrors),
}

Everything that can go wrong while loading, merging, or validating a TOML config.

Variants

FileNotFound(PathBuf)

No file matching the requested name was found by walking parent directories.

Io

OS-level I/O error (permissions, missing dir, etc.).

Fields

path: PathBuf

source: Error

Parse

The TOML text could not be parsed.

Fields

path: String

The file or description (“inline string”) where the error occurred.

source: Error

Serialize(Error)

A config value could not be serialized back to TOML.

Validation

A loaded config failed its own invariant checks (see crate::Validate).

Used for ad-hoc, single-message validation. For structured, path-precise, multi-error reports, see Error::Invalid.

Fields

context: String

Which file or config type was being validated.

reason: String

Human-readable description of the violation.

Invalid(ValidationErrors)

A loaded config failed structured validation — carries the full path-precise report of every failure (see crate::ValidationErrors).

Implementations

impl Error

pub fn validation(context: impl Into<String>, reason: impl Into<String>) -> Self

Construct a validation error.

pub fn io(path: impl Into<PathBuf>, source: Error) -> Self

Construct an I/O error with source path context.

pub fn parse(path: impl Into<String>, source: Error) -> Self

Construct a parse error with file/location context.

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, __formatter: &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(source: Error) -> Self

Converts to this type from the input type.

impl From<ValidationErrors> for Error

fn from(source: ValidationErrors) -> Self

Converts to this type from the input type.