Skip to main content

ganit_core/
lib.rs

1// ganit-core: spreadsheet formula parser and evaluator
2
3pub mod display;
4pub mod eval;
5pub mod parser;
6pub mod types;
7
8pub use display::display_number;
9pub use parser::{parse, validate, Expr};
10pub use types::{ErrorKind, ParseError, Value};
11
12use std::collections::HashMap;
13use eval::{evaluate_expr, Context, EvalCtx, Registry};
14
15/// Evaluate a formula string with named variables.
16///
17/// Returns `Value::Error(ErrorKind::Value)` on parse failure.
18///
19/// Note: constructs a fresh `Registry` on every call. For bulk evaluation
20/// across many formulas, consider reusing a `Registry` via the lower-level
21/// `eval::evaluate_expr` API.
22pub fn evaluate(formula: &str, variables: &HashMap<String, Value>) -> Value {
23    match parse(formula) {
24        Err(_) => Value::Error(ErrorKind::Value),
25        Ok(expr) => {
26            let ctx = Context::new(variables.clone());
27            let registry = Registry::new();
28            let mut eval_ctx = EvalCtx::new(ctx, &registry);
29            evaluate_expr(&expr, &mut eval_ctx)
30        }
31    }
32}