Enum Error 

#[non_exhaustive]
pub enum Error {
    NotFound {
        path: PathBuf,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    UnknownExtension {
        path: PathBuf,
    },
    FeatureDisabled {
        format: Format,
        feature: &'static str,
    },
    Parse {
        origin: Option<PathBuf>,
        format: Format,
        message: String,
    },
    Deserialize(Error),
    Defaults(Error),
    Watch(Error),
}

All errors that can occur while loading or watching configuration.

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.

NotFound

A required configuration file does not exist.

Fields

path: PathBuf

Path of the missing file.

Io

Reading a configuration file failed for I/O reasons other than absence.

Fields

path: PathBuf

Path of the file that could not be read.

source: Error

Underlying I/O error.

UnknownExtension

The file extension does not map to any known configuration format.

Fields

path: PathBuf

Path whose extension could not be recognized.

FeatureDisabled

The format is recognized but its cargo feature is not enabled.

Fields

format: Format

The requested format.

feature: &'static str

Name of the cargo feature that must be enabled.

Parse

The content is not valid for its format.

Fields

origin: Option<PathBuf>

Path of the offending file, or None when parsing from a string.

format: Format

The format that was being parsed.

message: String

Parser error message, including position info when available.

Deserialize(Error)

The merged configuration does not match the target type.

Defaults(Error)

Serializing the defaults layer failed.

Watch(Error)

Setting up the file watcher failed.

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.