Enum ConfigError 

pub enum ConfigError {
    Path(PathsError),
    Read {
        path: PathBuf,
        source: Error,
    },
    Parse {
        path: PathBuf,
        source: Box<Error>,
    },
    ObsoleteField {
        path: PathBuf,
        field: String,
        version: u32,
    },
    Conflict {
        path: PathBuf,
    },
    Write {
        path: PathBuf,
        source: Error,
    },
    Serialize(Error),
    Edit {
        path: PathBuf,
        source: Box<TomlError>,
    },
    UnsupportedSchemaVersion {
        path: PathBuf,
        found: u32,
    },
}

Failure loading or persisting config.toml.

Variants

Path(PathsError)

The platform config directory could not be resolved.

Read

Reading the config file from disk failed.

Fields

path: PathBuf

The config file the read targeted.

source: Error

The underlying I/O error.

Parse

The file is not valid TOML for its declared schema.

Fields

path: PathBuf

The config file that failed to parse.

source: Box<Error>

The underlying TOML deserialization error, including line/column.

ObsoleteField

A field from an older schema was used with a version where it is invalid.

Fields

path: PathBuf

The config file containing the field.

field: String

Dotted path to the obsolete field.

version: u32

Schema version declared by the file.

Conflict

The file changed after it was loaded, so overwriting it would lose edits.

Fields

path: PathBuf

The concurrently modified config file.

Write

Writing the updated config back to disk failed.

Fields

path: PathBuf

The config file the write targeted.

source: Error

The underlying I/O error.

Serialize(Error)

The in-memory config could not be serialized to TOML.

Edit

A generated or previously parsed TOML document could not be edited.

Fields

path: PathBuf

The config file whose document was being updated.

source: Box<TomlError>

The TOML editing parser error.

UnsupportedSchemaVersion

The file declares a schema outside the supported version range.

Fields

path: PathBuf

The config file carrying the unsupported version.

found: u32

The schema version the file declared.

Trait Implementations

impl Debug for ConfigError

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

Formats the value using the given formatter.

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.

impl From<Error> for ConfigError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PathsError> for ConfigError

fn from(source: PathsError) -> Self

Converts to this type from the input type.