Struct SpanContext 

pub struct SpanContext { /* private fields */ }

A runtime error context carrying the source span of the failing operation.

Add this as anyhow context with .context(SpanContext::new(span)) when wrapping an op closure. Retrieve it from an anyhow::Error with e.downcast_ref::<SpanContext>().

Implementations

impl SpanContext

pub fn new(span: SourceSpan) -> Self

Creates a new span context for the given source region.

Examples

use cel_parser::{SourceSpan, SpanContext};

let span = SourceSpan::new(1, 0, 1, 5);
let ctx = SpanContext::new(span);
assert_eq!(ctx.span(), span);

pub fn span(&self) -> SourceSpan

Returns the source span.

Examples

use cel_parser::{SourceSpan, SpanContext};

let span = SourceSpan::new(2, 3, 2, 7);
let ctx = SpanContext::new(span);
assert_eq!(ctx.span(), span);

pub fn format_rustc_style( &self, message: &str, source_code: &str, filename: &str, start_line: u32, renderer: &Renderer, ) -> String

Formats a runtime error message with rustc-style source annotation.

Delegates to CELError::format_rustc_style using self.span and message.

Examples

use annotate_snippets::Renderer;
use cel_parser::{SourceSpan, SpanContext};

let source = "1i32 + 2i32";
let span = SourceSpan::new(1, 5, 1, 6);
let ctx = SpanContext::new(span);
let output = ctx.format_rustc_style("arithmetic overflow", source, "test.cel", 1, &Renderer::plain());
assert!(output.contains("arithmetic overflow"));

Trait Implementations

impl Debug for SpanContext

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

Formats the value using the given formatter.

impl Display for SpanContext

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

Formats the value using the given formatter.

impl Error for SpanContext

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.