cala-cel-parser 0.13.17

A parser for the Common Expression Language (CEL)
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

#![cfg_attr(feature = "fail-on-warnings", deny(warnings))]
#![cfg_attr(feature = "fail-on-warnings", deny(clippy::all))]

use cached::proc_macro::cached;
use lalrpop_util::lalrpop_mod;
use tracing::instrument;

pub mod ast;

pub use ast::*;

// Private module - use parse_expression() instead
lalrpop_mod!(
    #[allow(clippy::all)]
    parser,
    "/cel.rs"
);

/// Error type for batch parsing
#[derive(Debug)]
pub struct ParseErrors(pub Vec<(usize, String)>);

impl std::fmt::Display for ParseErrors {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{} parse error(s)", self.0.len())
    }
}

impl std::error::Error for ParseErrors {}

/// Instrumented wrapper for parsing CEL expressions with caching
///
/// This provides visibility into parsing operations while using the
/// LALRPOP-generated parser internally. Parsing results are cached
/// to avoid re-parsing the same expression multiple times.
#[cached(size = 10000)]
#[instrument(name = "cel.parse", skip(source), fields(expression = %source), err)]
pub fn parse_expression(source: String) -> Result<Expression, String> {
    parser::ExpressionParser::new()
        .parse(&source)
        .map_err(|e| e.to_string())
}