Enum config::ConfigError

pub enum ConfigError {
    Frozen,
    NotFound(String),
    PathParse(ErrorKind),
    FileParse {
        uri: Option<String>,
        cause: Box<Error + Send + Sync>,
    },
    Type {
        origin: Option<String>,
        unexpected: Unexpected,
        expected: &'static str,
        key: Option<String>,
    },
    Message(String),
    Foreign(Box<Error + Send + Sync>),
}

Represents all possible errors that can occur when working with configuration.

Variants

Frozen

Configuration is frozen and no further mutations can be made.

NotFound(String)

Configuration property was not found

PathParse(ErrorKind)

Configuration path could not be parsed.

FileParse

Configuration could not be parsed from file.

Fields of FileParse

uri: Option<String>	The URI used to access the file (if not loaded from a string). Example: /path/to/config.json
cause: Box<Error + Send + Sync>	The captured error from attempting to parse the file in its desired format. This is the actual error object from the library used for the parsing.

Type

Value could not be converted into the requested type.

Fields of Type

origin: Option<String>	The URI that references the source that the value came from. Example: /path/to/config.json or Environment or etcd://localhost
unexpected: Unexpected	What we found when parsing the value
expected: &'static str	What was expected when parsing the value
key: Option<String>	The key in the configuration hash of this value (if available where the error is generated).

Message(String)

Custom message

Foreign(Box<Error + Send + Sync>)

Unadorned error from a foreign origin.

Trait Implementations

impl Display for ConfigError

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

Formats the value using the given formatter.

impl Debug for ConfigError

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

Formats the value using the given formatter.

impl Error for ConfigError

fn description(&self) -> &str

This method is soft-deprecated.

fn cause(&self) -> Option<&Error>

Deprecating in 1.33.0

: replaced by Error::source, which can support downcasting

The lower-level cause of this error, if any.

fn source(&self) -> Option<&(Error + 'static)>

The lower-level source of this error, if any.

impl Error for ConfigError

fn custom<T: Display>(msg: T) -> Self

Raised when there is general error when deserializing a type.

fn invalid_type(unexp: Unexpected, exp: &Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

fn invalid_value(unexp: Unexpected, exp: &Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

fn invalid_length(len: usize, exp: &Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.