Struct Error

Source

pub struct Error { /* private fields */ }

Expand description

Unified crate error used by stable public APIs.

§Examples

let err = async_jsonata_rust::Error::new("D3040", "Sqrt domain error");
assert_eq!(err.code(), "D3040");

Implementations§

Source §

impl Error

Source

pub fn new(code: impl Into<String>, message: impl Into<String>) -> Self

Creates a new error with JSONata-compatible code.

§Examples

let err = async_jsonata_rust::Error::new("S0201", "Unexpected token");
assert_eq!(err.code(), "S0201");

Source

pub fn parser(err: ParserError) -> Self

Creates a parser error from parser internals.

§Examples

let parse_error = async_jsonata_rust::parse_expression("1+", false).unwrap_err();
let err = async_jsonata_rust::Error::from(parse_error);
assert!(!err.code().is_empty());

Source

pub fn runtime(err: JsonError) -> Self

Creates a runtime error from evaluator/function internals.

§Examples

let runtime = async_jsonata_rust::JsonError::new("D3040", "Sqrt domain error");
let err = async_jsonata_rust::Error::from(runtime);
assert_eq!(err.code(), "D3040");

Source

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

Creates a not-implemented error for incomplete features.

§Examples

let err = async_jsonata_rust::Error::not_implemented("evaluator pending");
assert_eq!(err.code(), "E0001");

Source

pub fn with_context(self, key: impl Into<String>, value: Value) -> Self

Adds named context field.

§Examples

let err = async_jsonata_rust::Error::new("E1", "oops")
    .with_context("field", serde_json::Value::String("value".into()));
assert!(err.context().contains_key("field"));

Source

pub fn code(&self) -> &str

Returns JSONata error code (D3040, S0201, …).

Examples found in repository ?

examples/basic_eval.rs (line 11)

3fn main() {
4    let parser = Parser::new();
5    match parser.parse("Account.Order[0].Product") {
6        Ok(expr) => {
7            println!("Source: {}", expr.source());
8            println!("AST type: {}", expr.ast()["type"]);
9        }
10        Err(err) => {
11            eprintln!("{}: {}", err.code(), err.message());
12            std::process::exit(1);
13        }
14    }
15}

More examples

Hide additional examples

examples/error_handling.rs (line 7)

4fn main() {
5    match Parser::new().parse("1+") {
6        Ok(_) => println!("Unexpected parse success"),
7        Err(err) => println!("Parse error: {} at {:?}", err.code(), err.position()),
8    }
9
10    match math::sqrt(Some(-1.0)) {
11        Ok(value) => println!("Unexpected sqrt result: {:?}", value),
12        Err(err) => println!("Runtime error: {}: {}", err.code, err.message),
13    }
14}

Source

pub fn message(&self) -> &str

Returns human-readable message.

Examples found in repository ?

examples/basic_eval.rs (line 11)

3fn main() {
4    let parser = Parser::new();
5    match parser.parse("Account.Order[0].Product") {
6        Ok(expr) => {
7            println!("Source: {}", expr.source());
8            println!("AST type: {}", expr.ast()["type"]);
9        }
10        Err(err) => {
11            eprintln!("{}: {}", err.code(), err.message());
12            std::process::exit(1);
13        }
14    }
15}

Source

pub fn position(&self) -> Option<usize>

Returns parser position if known.

Examples found in repository ?

examples/error_handling.rs (line 7)

4fn main() {
5    match Parser::new().parse("1+") {
6        Ok(_) => println!("Unexpected parse success"),
7        Err(err) => println!("Parse error: {} at {:?}", err.code(), err.position()),
8    }
9
10    match math::sqrt(Some(-1.0)) {
11        Ok(value) => println!("Unexpected sqrt result: {:?}", value),
12        Err(err) => println!("Runtime error: {}: {}", err.code, err.message),
13    }
14}