zen-expression 0.55.0

Zen Expression Language
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use crate::expression::{Standard, Unary};
use crate::variable::Variable;
use crate::{Expression, Isolate, IsolateError};

/// Evaluates a standard expression
pub fn evaluate_expression(expression: &str, context: Variable) -> Result<Variable, IsolateError> {
    Isolate::with_environment(context).run_standard(expression)
}

/// Evaluates a unary expression; Required: context must be an object with "$" key.
pub fn evaluate_unary_expression(
    expression: &str,
    context: Variable,
) -> Result<bool, IsolateError> {
    let Some(context_object_ref) = context.as_object() else {
        return Err(IsolateError::MissingContextReference);
    };

    let context_object = context_object_ref.borrow();
    if !context_object.contains_key("$") {
        return Err(IsolateError::MissingContextReference);
    }

    Isolate::with_environment(context).run_unary(expression)
}

/// Compiles a standard expression
pub fn compile_expression(expression: &str) -> Result<Expression<Standard>, IsolateError> {
    Isolate::new().compile_standard(expression)
}

/// Compiles an unary expression
pub fn compile_unary_expression(expression: &str) -> Result<Expression<Unary>, IsolateError> {
    Isolate::new().compile_unary(expression)
}

#[cfg(test)]
mod test {
    use crate::evaluate_expression;
    use serde_json::json;

    #[test]
    fn example() {
        let context = json!({ "tax": { "percentage": 10 } });
        let tax_amount = evaluate_expression("50 * tax.percentage / 100", context.into()).unwrap();

        assert_eq!(tax_amount, json!(5).into());
    }
}