Enum RouterConfigError 

pub enum RouterConfigError {
    NoConfigDir,
    Read {
        path: PathBuf,
        source: Error,
    },
    Parse {
        path: PathBuf,
        source: Error,
    },
    BadSourceName {
        name: String,
        reason: String,
    },
    DuplicateSource {
        name: String,
    },
    UndefinedDefaultSource {
        name: String,
    },
    UndefinedFallbackSource {
        name: String,
    },
    UndefinedRouteSource {
        prefix: String,
        name: String,
    },
    UndefinedSecretSource {
        path: String,
        name: String,
    },
    BadRoutePrefix {
        prefix: String,
    },
    DuplicateRoutePrefix {
        prefix: String,
    },
    BadSecretPath {
        path: String,
        source: PathError,
    },
}

Failure modes when loading or validating a RouterConfig.

Variants

NoConfigDir

dirs::config_dir() returned None — extremely unusual on supported platforms but worth a typed variant rather than a panic.

Read

I/O error reading the config file.

Fields

path: PathBuf

Path the loader tried to read.

source: Error

Underlying I/O error.

Parse

TOML deserialization error.

Fields

path: PathBuf

Path the loader tried to parse.

source: Error

Underlying parse error.

BadSourceName

Source name failed the identifier regex (kebab-case allowed).

Fields

name: String

The offending name.

reason: String

Human-readable detail.

DuplicateSource

Two [[source]] blocks share a name.

Fields

name: String

The duplicated name.

UndefinedDefaultSource

[default].source references an undefined source.

Fields

name: String

The unresolved source name.

UndefinedFallbackSource

[default].fallback references an undefined source.

Fields

name: String

The unresolved source name.

UndefinedRouteSource

[[route]].source references an undefined source.

Fields

prefix: String

Prefix of the route in question.

name: String

The unresolved source name.

UndefinedSecretSource

[secret."<path>"].source references an undefined source.

Fields

path: String

Path key of the override.

name: String

The unresolved source name.

BadRoutePrefix

[[route]].prefix does not end with /.

Fields

prefix: String

The offending prefix.

DuplicateRoutePrefix

Two [[route]] blocks share a prefix.

Fields

prefix: String

The duplicated prefix.

BadSecretPath

[secret."<path>"] key is not a valid ADR-020 path.

Fields

path: String

The offending key.

source: PathError

Underlying path-validation error.

Trait Implementations

impl Debug for RouterConfigError

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

Formats the value using the given formatter.

impl Display for RouterConfigError

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

Formats the value using the given formatter.

impl Error for RouterConfigError

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.