64 releases (34 breaking)
new 0.37.2 | Dec 11, 2024 |
---|---|
0.36.1 | Dec 6, 2024 |
0.35.0 | Nov 28, 2024 |
0.24.2 | Jul 17, 2024 |
0.8.0 | Jul 28, 2023 |
#93 in Date and time
1,794 downloads per month
Used in 2 crates
285KB
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–5MB
~88K SLoC