Enum Error 

pub enum Error {
    Parse {
        message: String,
        line: usize,
        column: usize,
        file: Option<String>,
    },
    UnknownFormat {
        format: String,
    },
    KeyNotFound {
        key: String,
        available: Vec<String>,
    },
    Type {
        value: String,
        expected_type: String,
        actual_type: String,
    },
    Io {
        path: String,
        source: Error,
    },
    Validation {
        message: String,
    },
    General {
        message: String,
    },
    FeatureNotEnabled {
        feature: String,
    },
    Concurrency {
        message: String,
    },
    Noml {
        source: NomlError,
    },
    Internal {
        message: String,
        context: Option<String>,
    },
}

Comprehensive error types for all config-lib operations.

This error system provides maximum clarity about what went wrong, where it happened, and how to fix it. Each variant includes enough context for both developers and end users to understand and resolve issues.

Variants

Parse

Parsing errors - when the input cannot be parsed due to syntax issues

Fields

message: String

Human-readable error message

line: usize

Line number where error occurred (1-indexed)

column: usize

Column number where error occurred (1-indexed)

file: Option<String>

File path where error occurred (if applicable)

UnknownFormat

Format detection errors

Fields

format: String

The format that couldn’t be detected/parsed

KeyNotFound

Key access errors - when requesting non-existent keys

Fields

key: String

The key that was requested

available: Vec<String>

Available keys at that level (for suggestions)

Type

Type conversion errors - when values cannot be converted to requested type

Fields

value: String

The value that couldn’t be converted

expected_type: String

The expected type

actual_type: String

The actual type found

Io

File I/O errors - wraps std::io::Error with additional context

Fields

path: String

Path to the file that caused the error

source: Error

The underlying I/O error

Validation

General validation errors

Fields

message: String

Description of the validation error

General

Generic error for other cases

Fields

message: String

Generic error message

FeatureNotEnabled

Feature not enabled errors

Fields

feature: String

The feature that needs to be enabled

Concurrency

Concurrency errors - lock failures, thread synchronization issues

Fields

message: String

Description of the concurrency error

Noml

NOML library errors (when using NOML format)

Fields

source: NomlError

The underlying NOML error

Internal

Internal errors - these should never happen in normal operation

Fields

message: String

Description of the internal error

context: Option<String>

Optional context about where this occurred

Implementations

impl Error

pub fn parse(message: impl Into<String>, line: usize, column: usize) -> Self

Create a parse error with position information

pub fn parse_with_file( message: impl Into<String>, line: usize, column: usize, file: impl Into<String>, ) -> Self

Create a parse error with file context

pub fn key_not_found(key: impl Into<String>) -> Self

Create a key not found error

pub fn key_not_found_with_suggestions( key: impl Into<String>, available: Vec<String>, ) -> Self

Create a key not found error with suggestions

pub fn type_error( value: impl Into<String>, expected: impl Into<String>, actual: impl Into<String>, ) -> Self

Create a type conversion error

pub fn io(path: impl Into<String>, source: Error) -> Self

Create an I/O error with file context

pub fn unknown_format(format: impl Into<String>) -> Self

Create an unknown format error

pub fn feature_not_enabled(feature: impl Into<String>) -> Self

Create a feature not enabled error

pub fn concurrency(message: impl Into<String>) -> Self

Create a concurrency error

pub fn serialize(message: impl Into<String>) -> Self

Create a serialization error

pub fn validation(message: impl Into<String>) -> Self

Create a validation error

pub fn general(message: impl Into<String>) -> Self

Create a general error

pub fn internal(message: impl Into<String>) -> Self

Create an internal error

pub fn internal_with_context( message: impl Into<String>, context: impl Into<String>, ) -> Self

Create an internal error with context

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

Convert from std::io::Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NomlError> for Error

fn from(source: NomlError) -> Self

Converts to this type from the input type.