Package com.google.mu.cel

package com.google.mu.cel

Cel Parser (requires dot-cel artifact)

A modern, light-weight parser for the Common Expression Language:

• Parses to AST of sealed interfaces and records so that you can use pattern matching.
• 2x faster than the ANTLR-based cel-java.
• Tiny foot-print.

Package Specification

The code is developed and tested under Java 21.

Class	Description
CelExpr	Abstract representation of a parsed Common Expression Language (CEL) expression.
CelExpr.Add	Addition: x + y.
CelExpr.And	Logical AND comparison: x && y.
CelExpr.Binary	An expression composed by a binary operator.
CelExpr.BoolValue	Boolean literal.
CelExpr.BytesValue	Byte sequence literal.
CelExpr.Divide	Division: x / y.
CelExpr.DoubleValue	Double-precision floating point literal.
CelExpr.Element	An element in a list, map, or message, which can optionally be marked as optional.
CelExpr.EqualTo	Equality comparison: x == y.
CelExpr.FunctionCall	Global function calls f(args).
CelExpr.GreaterThan	Greater than relational comparison: x > y.
CelExpr.GreaterThanOrEqualTo	Greater than or equal to relational comparison: x >= y.
CelExpr.Ident	Variable or symbol lookup, such as request.
CelExpr.IfElse	Ternary conditional, such as condition ? trueExpr : falseExpr.
CelExpr.In	Containment comparison: x in y.
CelExpr.Index	Subscript/indexing, such as operand[index].
CelExpr.KeyedBy<K>	An entry/field representing a key-value or field-value mapping in map or struct literals.
CelExpr.LessThan	Less than relational comparison: x < y.
CelExpr.LessThanOrEqualTo	Less than or equal to relational comparison: x <= y.
CelExpr.ListOf	List creation, such as [1, ?optional_var].
CelExpr.LongValue	Signed 64-bit integer literal.
CelExpr.Macro	Abstract representation of a CEL macro expression.
CelExpr.Macro.All	The target.all(var, condition) macro.
CelExpr.Macro.Exists	The target.exists(var, condition) macro.
CelExpr.Macro.ExistsOne	The target.exists_one(var, condition) macro.
CelExpr.Macro.Filter	The target.filter(var, expr) macro.
CelExpr.Macro.FilterMap	The target.map(var, filter, transform) macro (synthesized from three-argument map macro).
CelExpr.Macro.Has	The has(member) macro.
CelExpr.Macro.Map	The target.map(var, expr) macro.
CelExpr.MapOf	Map creation, such as {"key": value, ? "opt_key": value}.
CelExpr.MemberCall	Member calls target.f(args).
CelExpr.Modulo	Modulo/remainder: x % y.
CelExpr.Multiply	Multiplication: x * y.
CelExpr.Negative	Unary sign negation: -x.
CelExpr.Not	Logical negation: !x.
CelExpr.NotEqualTo	Inequality comparison: x != y.
CelExpr.NullValue	Null literal.
CelExpr.OptionalIndex	Optional subscript/indexing, such as operand[?index].
CelExpr.OptionalSelect	Optional field selection, such as operand.?field.
CelExpr.Or	Logical OR comparison: x || y.
CelExpr.Select	Field selection, such as operand.field.
CelExpr.StringValue	UTF-8 string literal.
CelExpr.Struct	Struct/message creation, such as Type{field: value, ?opt_field: value}.
CelExpr.Subtract	Subtraction: x - y.
CelExpr.UintValue	Unsigned 64-bit integer literal.
CelExpr.Unary	An expression composed by a unary operator.
CelParser	Parser for Common Expression Language (CEL) syntax, producing CelExpr AST records.