rscel 1.0.7

Cel interpreter in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# rscel

RsCel is a CEL evaluator written in Rust. CEL is a Turing-incomplete
language that can be used to evaluate
a user-provided expression. The language specification can be found
[here](https://github.com/google/cel-spec/blob/master/doc/langdef.md).

The design goals of this project are as follows:
  * Isolated execution of CEL expressions
  * Flexible enough to allow for a user to bend the spec if needed
  * Can be used as a WASM depenedency (or other FFI)

The basic example of how to use:
```rust
use rscel::{CelContext, BindContext};

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()); // convert to CelValue

let res = ctx.exec("main", &exec_ctx).unwrap(); // CelValue::Int(6)
assert_eq!(res, 6.into());
```

As of 0.10.0, binding protobuf messages from the protobuf crate is now available! Given 
the following protobuf message:
```protobuf

message Point {
  int32 x = 1;
  int32 y = 2;
}
  
```
The following code can be used to evaluate a CEL expression on a Point message:

```rust
use rscel::{CelContext, BindContext};

// currently rscel requires protobuf messages to be in a box 
let p = Box::new(protos::Point::new());
p.x = 4;
p.y = 5;

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

ctx.add_program_str("main", "p.x + 3").unwrap();
exec_ctx.bind_protobuf_msg("p", p);

assert_eq!(ctx.exec("main", &exec_ctx), 7.into());
  
```

Build status: [![Rust](https://github.com/1BADragon/rscel/actions/workflows/rust.yml/badge.svg)](https://github.com/1BADragon/rscel/actions/workflows/rust.yml)