Enum ConfigError 

#[non_exhaustive]
pub enum ConfigError {
    NotFound,
    ReadError {
        path: PathBuf,
        source: Error,
    },
    ParseError {
        source: Error,
    },
    ValidationError {
        field: String,
        message: String,
    },
    MissingEnvVar {
        name: String,
    },
    MultipleErrors {
        errors: Vec<ConfigError>,
    },
}

Errors that occur while loading or validating FraiseQL 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

No configuration file was found at the expected location(s).

ReadError

The configuration file was found but could not be read from disk.

Fields

path: PathBuf

Path to the file that could not be read.

source: Error

Underlying I/O error.

ParseError

The configuration file was read successfully but contains invalid TOML or does not conform to the expected schema.

Fields

source: Error

The TOML deserialisation error.

ValidationError

A configuration value failed a semantic validation rule (e.g. a port number that is out of range, or conflicting options).

Fields

field: String

Dot-separated path to the invalid configuration field.

message: String

Human-readable description of why the value is invalid.

MissingEnvVar

A required environment variable was not set at startup.

Fields

name: String

Name of the missing environment variable.

MultipleErrors

Several configuration errors were collected together (e.g. during a full-file validation pass) and are reported as a single error.

Fields

errors: Vec<ConfigError>

All individual errors that were encountered.

Implementations

impl ConfigError

pub const fn error_code(&self) -> &'static str

Returns a short, stable error code string suitable for API responses and structured logging.

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<ConfigError> for RuntimeError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for ConfigError

fn from(source: Error) -> Self

Converts to this type from the input type.