Crate rscel

RsCel is a CEL evaluator written in Rust. CEL is a google project that describes a turing-incomplete language that can be used to evaluate a user provdided expression. The language specification can be found here.

The design goals of this project were are as follows:

• Flexible enough to allow for a user to bend the spec if needed
• Sandbox’ed in such a way that only specific values can be bound
• Can be used as a wasm depenedency (or other ffi)

While Google’s CEL spec was designed around the protobuf message, I decided to focus on using the JSON message instead (CEL spec specifies how to convert from JSON to CEL types).

The basic example of how to use:

use rscel::{CelContext, BindContext, serde_json};

let mut ctx = CelContext::new();
let mut exec_ctx = BindContext::new();

ctx.add_program_str("main", "foo + 3").unwrap();
exec_ctx.bind_param("foo", 3.into()); // 3 converted to CelValue

let res = ctx.exec("main", &exec_ctx).unwrap(); // CelValue::Int(6)
assert!(TryInto::<i64>::try_into(res).unwrap() == 6);

Re-exports

• pub use serde;
• pub use serde_json;

Modules

• utils

Structs

• BindContext
  Bindings context for a cel evaluation.
• CelCompiler
• CelContext
  The CelContext is the core context in RsCel. This context contains Program information as well as the primary entry point for evaluating an expression.
• Program
• StringTokenizer

Enums

• ByteCode
• CelError
• CelValue
  The basic value of the CEL interpreter.

Traits

• Tokenizer

Type Aliases

• CelResult
• RsCelFunction
  Prototype for a function binding.
• RsCelMacro
  Prototype for a macro binding.