Struct RichError 

pub struct RichError {
    pub message: String,
    pub span: Span,
    pub context: Option<String>,
    pub children: Vec<RichError>,
    pub severity: ErrorSeverity,
}

A rich, tree-structured parse error

Fields

message: String

The error message

span: Span

Where the error occurred

context: Option<String>

What was being parsed (e.g., “expression”, “term”)

children: Vec<RichError>

Child errors (causes)

severity: ErrorSeverity

Error severity

Implementations

impl RichError

pub fn at(message: impl Into<String>, span: Span) -> Self

Create a new error at a position

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

Create an error at a single position

pub fn with_context(self, context: impl Into<String>) -> Self

Add context to the error

pub fn with_child(self, child: RichError) -> Self

Add a child error (cause)

pub fn with_severity(self, severity: ErrorSeverity) -> Self

Set severity

pub fn expected(expected: &str, span: Span) -> Self

Create an “expected” error

pub fn unexpected(found: &str, span: Span) -> Self

Create an “unexpected” error

pub fn failed_to_match(what: &str, span: Span) -> Self

Create a “failed to match” error

pub fn deepest_position(&self) -> Span

Get the deepest error position

pub fn deepest(&self) -> &RichError

Get the deepest error (the error that occurred at the furthest position)

pub fn leaves(&self) -> Vec<&RichError>

Get all leaf errors (errors with no children)

pub fn to_tree(&self) -> String

Alias for ascii_tree() for compatibility

pub fn ascii_tree(&self) -> String

Format as ASCII tree (like Parslet)

pub fn format_with_source(&self, source: &str) -> String

Format with source code context

pub fn format_with_source_and_captures( &self, source: &str, captures: &HashMap<&str, &str>, ) -> String

Format with source code context and captures

This method extends format_with_source to include captured values in the error message for better debugging.

Arguments

• source - The source input that was being parsed
• captures - A HashMap of capture names to their text values

Example

use parsanol::portable::{ParseError, RichError};
use std::collections::HashMap;

let error = ParseError::at_position(5);
let rich = error.into_rich("hello world");
let mut captures = HashMap::new();
captures.insert("greeting", "hello");
println!("{}", rich.format_with_source_and_captures("hello world", &captures));

Trait Implementations

impl Clone for RichError

fn clone(&self) -> RichError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RichError

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

Formats the value using the given formatter.

impl Display for RichError

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

Formats the value using the given formatter.

impl Error for RichError

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<ParseError> for RichError

fn from(error: ParseError) -> Self

Converts to this type from the input type.