Enum Error 

pub enum Error {
    Parse {
        message: String,
        line: usize,
        col: usize,
        snippet: Option<String>,
        help: Option<String>,
    },
    UnexpectedEof {
        expected: String,
        line: usize,
    },
    InvalidDirective {
        name: String,
        reason: Option<String>,
        suggestion: Option<String>,
    },
    InvalidArgument {
        directive: String,
        message: String,
        expected: Option<String>,
    },
    Syntax {
        message: String,
        line: usize,
        col: usize,
        expected: Option<String>,
        found: Option<String>,
    },
    Io(Error),
    System(String),
    Serialization(String),
    Include(String),
    Custom(String),
}

Main error type with enhanced diagnostics

Variants

Parse

Error during parsing with detailed context

Fields

message: String

Error message

line: usize

Line number (1-indexed)

col: usize

Column number (1-indexed)

snippet: Option<String>

Source snippet if available

help: Option<String>

Helpful suggestion to fix the error

UnexpectedEof

Unexpected end of input while parsing

Fields

expected: String

What was expected

line: usize

Location where EOF occurred

InvalidDirective

Invalid directive name or usage

Fields

name: String

Directive name

reason: Option<String>

Reason why it’s invalid

suggestion: Option<String>

Suggestion for valid alternative

InvalidArgument

Invalid argument for a directive

Fields

directive: String

Directive name

message: String

Error message

expected: Option<String>

Expected format

Syntax

Syntax error with context

Fields

message: String

Error message

line: usize

Location

col: usize

Column

expected: Option<String>

What was expected

found: Option<String>

What was found

Io(Error)

IO error

System(String)

Available on crate feature system only.

System error (nginx not found, etc.)

Serialization(String)

Available on crate feature serde only.

Serialization error

Include(String)

Available on crate feature includes only.

Include resolution error

Custom(String)

Custom error

Implementations

impl Error

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

Create a new parse error with helpful context

pub fn parse_with_context( message: impl Into<String>, line: usize, col: usize, snippet: impl Into<String>, help: impl Into<String>, ) -> Self

Create a parse error with source snippet and help text

pub fn unexpected_eof(expected: impl Into<String>, line: usize) -> Self

Create an unexpected EOF error

pub fn syntax( message: impl Into<String>, line: usize, col: usize, expected: Option<String>, found: Option<String>, ) -> Self

Create a syntax error with expected/found information

pub fn invalid_directive( name: impl Into<String>, reason: Option<String>, suggestion: Option<String>, ) -> Self

Create an invalid directive error with suggestion

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

Create a custom error

pub fn message(&self) -> String

Get the error message for display

pub fn detailed(&self) -> String

Get detailed error information with formatted output

This provides a beautiful, colorized error display with:

• Error location and message
• Source code snippet
• Visual pointer to the error
• Helpful suggestions

pub fn short(&self) -> String

Get a short, one-line description

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature serde only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature serde only.

fn from(err: Error) -> Self

Converts to this type from the input type.