josh-tracey/exprimo

Exprimo is a JavaScript expression evaluator written in Rust.

Exprimo

CAUTION: Beware of Sneaky Bugs in the Early Project Stages! There will be bug, probably alot at first :D

Exprimo is a JavaScript evaluator written in Rust, inspired by the functionality of angular-expressions. Designed to be simple and blazingly fast.

Description

Exprimo parses and evaluates JavaScript expressions efficiently and securely. It utilizes the power of Rust and its excellent memory safety guarantees to provide a reliable and fast JavaScript expression evaluator.

Installation

Before you can use Exprimo, you need to have Rust installed on your system. If you don't have it installed, you can download Rust from the official website here.

Once Rust is installed, you can install Exprimo by running:

cargo add exprimo

Trace logging to console can be added to the package, it is by default disabled as probably don't need it unless working on it, or need to debug AST error if required.

This will install Scribe Rust and will need LOG_LEVEL=TRACE in environment variables for logs to output.

exprimo = { version = "*", features = ["logging"]

Usage

First, you need to import Exprimo and create an instance of Evaluator:

use exprimo::Evaluator;
use std::collections::HashMap;

let mut context = HashMap::new();
context.insert("a".to_string(), serde_json::Value::Bool(true));        
context.insert("b".to_string(), serde_json::Value::Bool(false));

let evaluator = Evaluator::new(context);

Then, you can evaluate JavaScript expressions:

let result = evaluator.evaluate("a && b").unwrap();
println!("The result is {}", result);

//--outputs
// >The result is false

Examples

Running examples

LOG_LEVEL=TRACE cargo run --features "logging" --example basic

Contributing

Contributions to Exprimo are welcome! Please submit a pull request on GitHub.

License

Exprimo is licensed under the MIT license. Please see the LICENSE file in the GitHub repository for more information.