71 releases (39 breaking)

0.42.0 Apr 27, 2025
0.40.1 Apr 14, 2025
0.40.0 Feb 10, 2025
0.39.0 Dec 31, 2024
0.8.0 Jul 28, 2023

#168 in WebAssembly

Download history 257/week @ 2025-01-13 223/week @ 2025-01-20 192/week @ 2025-01-27 436/week @ 2025-02-03 732/week @ 2025-02-10 718/week @ 2025-02-17 891/week @ 2025-02-24 1029/week @ 2025-03-03 755/week @ 2025-03-10 683/week @ 2025-03-17 645/week @ 2025-03-24 656/week @ 2025-03-31 558/week @ 2025-04-07 1054/week @ 2025-04-14 276/week @ 2025-04-21 240/week @ 2025-04-28

2,146 downloads per month
Used in 2 crates

MIT license

290KB
7K SLoC

A lightweight expression language designed for the evaluation of expressions in various contexts.

Zen Expression is a versatile single-threaded expression language designed for simplicity high-performance. It's primarily used for evaluating and processing JSON data offers key components that empower developers in creating responsive and non-blocking I/O applications Out of the box, it comes with amazing benefits:

  • 🚀 Blazingly fast - Perform millions of evaluations per second
  • 🧠 Intuitive syntax - Minimalistic and expressive syntax
  • 💼 Portable - Can be compiled for all standard architectures including WASM

For a full list of language references, visit documentation.

Example

Evaluate expression using isolate:

use zen_expression::evaluate_expression;
use zen_expression::variable::Variable;
use rust_decimal_macros::dec;
use serde_json::json;

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

    assert_eq!(tax_amount, Variable::Number(dec!(5)));
}

High Performance

When evaluating a lot of expressions at once, you can use Isolate directly. Under the hood, Isolate will re-use allocated memory from previous evaluations, drastically improving performance.

use zen_expression::Isolate;
use zen_expression::variable::Variable;
use rust_decimal_macros::dec;
use serde_json::json;

fn main() {
    let context = json!({ "tax": { "percentage": 10 } });
    let mut isolate = Isolate::with_environment(context.into());

    // Fast 🚀
    for _ in 0..1_000 {
        let tax_amount = isolate.run_standard("50 * tax.percentage / 100").unwrap();
        assert_eq!(tax_amount, Variable::Number(dec!(5)));
    }
}

Feature flags

Name Description Default?
regex-deprecated Uses standard regex crate Yes
regex-lite Opts for usage of lightweight regex-lite crate. Useful for reducing build size, especially in WASM. No

Dependencies

~3.5–5.5MB
~90K SLoC