Struct SchemaError 

pub struct SchemaError { /* private fields */ }

A schema error, identified by which file it came from (cratestack#916).

file/source_text start out empty: every constructor below (new, span_error) fires deep inside parsing/validation, dozens of call sites that have no path in scope and share one property — every error a single parse produces always belongs to the one file that parse was given. Rather than thread a path through every one of those call sites for no behavioral gain, SchemaError::with_file is applied exactly once, at the boundary where a path is known (parse_schema_named, parse_schema_diagnostics, parse_schema_file, parse_schema_unvalidated in entry.rs). Entry points that take no path tag the error with [crate::ANONYMOUS_SCHEMA] and the real source, so a rendered diagnostic always has a code frame — but only the *_named/*_file paths can name the actual file. Prefer those.

Implementations

impl SchemaError

pub fn message(&self) -> &str

pub fn span(&self) -> Range<usize>

pub fn line(&self) -> usize

pub fn file(&self) -> &str

The file this error belongs to. Errors from the *_named/*_file entry points carry the real path; those from the path-less entry points carry [crate::ANONYMOUS_SCHEMA]. Empty only for an error constructed internally and never passed through Self::with_file, which no public entry point returns.

pub fn render(&self) -> String

Render this error as a human-readable diagnostic.

Takes no arguments: the error already knows both its file (self.file) and that file’s source (self.source_text), attached once at the parse/diagnostics boundary. Before cratestack#916 this took a (path, source) pair supplied by the caller, which had to happen to match the file the error actually came from — nothing enforced that once more than one file was involved.

Trait Implementations

impl Clone for SchemaError

fn clone(&self) -> SchemaError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaError

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

Deliberately omits source_text. A derived Debug prints the entire schema file, so every .unwrap() panic on a Result<_, SchemaError> and every {:?} log line would dump the whole .cstack — a silent regression with no compile error to catch it. The byte length is enough to tell “source attached” from “source missing”.

impl Display for SchemaError

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

Formats the value using the given formatter.

impl Error for SchemaError

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.