cel

package

Go to main page

Versions in this module

v0

v0.30.0

Jul 31, 2026

Changes in this version

+ func AlphaProtoAsValue(adapter types.Adapter, v *exprpb.Value) (ref.Val, error)

+ func ExprToString(e ast.Expr, info *ast.SourceInfo) (string, error)

+ func ExprValueAsAlphaProto(res ref.Val) (*exprpb.ExprValue, error)

+ func ExprValueAsProto(res ref.Val) (*celpb.ExprValue, error)

+ func ProtoAsValue(adapter types.Adapter, v *celpb.Value) (ref.Val, error)

+ func RefValToExprValue(res ref.Val) (*exprpb.ExprValue, error)

+ func ValueAsAlphaProto(res ref.Val) (*exprpb.Value, error)

+ func ValueAsProto(res ref.Val) (*celpb.Value, error)

type ASTValidator

+ func ValidateBindNestingLimit(limit int) ASTValidator

+ type ASTValidatorFactory func(*env.Validator) (ASTValidator, error)

+ type Activation = interpreter.Activation

+ func NewActivation(bindings any) (Activation, error)

+ type AttributePatternType = interpreter.AttributePattern

+ type ConfigOptionFactory func(any) (EnvOption, bool)

+ type ConfigurableASTValidator interface

+ ToConfig func() *env.Validator

type ConstantFoldingOption

+ func FoldKnownValues(knownValues Activation) ConstantFoldingOption

type Env

+ func (e *Env) Functions() map[string]*decls.FunctionDecl

+ func (e *Env) HasFunction(functionName string) bool

+ func (e *Env) Macros() []Macro

+ func (e *Env) PlanProgram(a *celast.AST, opts ...ProgramOption) (Program, error)

+ func (e *Env) ToConfig(name string) (*env.Config, error)

+ func (e *Env) Validators() []ASTValidator

+ func (e *Env) Variables() []*decls.VariableDecl

type EnvOption

+ func AlphaProtoAsDeclaration(d *exprpb.Decl) (EnvOption, error)

+ func EnableHiddenAccumulatorName(enabled bool) EnvOption

+ func EnableIdentifierEscapeSyntax() EnvOption

+ func ExpressionNestingDepthLimit(limit int) EnvOption

+ func ExpressionNodeLimit(limit int) EnvOption

+ func FromConfig(config *env.Config, optFactories ...ConfigOptionFactory) EnvOption

+ func FunctionDecls(funcs ...*decls.FunctionDecl) EnvOption

+ func JSONFieldNames(enabled bool) EnvOption

+ func ParserErrorRecoveryLimit(limit int) EnvOption

+ func ProtoAsDeclaration(d *celpb.Decl) (EnvOption, error)

+ func VariableDecls(vars ...*decls.VariableDecl) EnvOption

+ func VariableWithDoc(name string, t *Type, doc string) EnvOption

+ type EvalResult struct

+ Err error

+ EvalDetails *EvalDetails

+ Val ref.Val

type FunctionOpt

+ func FunctionDocs(docs ...string) FunctionOpt

+ func SingletonAsyncBinding(fn functions.BlockingAsyncOp, traits ...int) FunctionOpt

type Issues

+ func ErrorAsIssues(err error) *Issues

+ type LibraryAliaser interface

+ LibraryAlias func() string

+ type LibrarySubsetter interface

+ LibrarySubset func() *env.LibrarySubset

+ type LibraryVersioner interface

+ LibraryVersion func() uint32

+ type MacroOpt = parser.MacroOpt

+ func MacroDocs(docs ...string) MacroOpt

+ func MacroExamples(examples ...string) MacroOpt

type OptimizerContext

+ func (opt *OptimizerContext) ExtendEnv(opts ...EnvOption) error

+ func (opt OptimizerContext) MacroCalls() map[int64]ast.Expr

+ type OptimizerOption func(*StaticOptimizer) (*StaticOptimizer, error)

+ func OptimizeWithSource(source Source) OptimizerOption

type OverloadOpt

+ func AsyncBinding(fn functions.BlockingAsyncOp) OverloadOpt

+ func LateFunctionBinding() OverloadOpt

+ func OverloadExamples(docs ...string) OverloadOpt

+ type OverloadSelector = decls.OverloadSelector

+ func ExcludeOverloads(overloadIDs ...string) OverloadSelector

+ func IncludeOverloads(overloadIDs ...string) OverloadSelector

+ type PartialActivation = interpreter.PartialActivation

type Program

+ func Compile(expression string, opts ...EnvOption) (Program, error)

+ ConcurrentEval func(context.Context, any) <-chan EvalResult

type ProgramOption

+ func AsyncCallObserver(observer async.Observer) ProgramOption

+ func AsyncCompletionBufferSize(size int) ProgramOption

+ func AsyncMaxConcurrency(maxConcurrency int) ProgramOption

+ func ConcurrentDrainStrategy(strategy async.DrainStrategy) ProgramOption

+ func CustomDecoratorV2(dec interpreter.InterpretableDecoratorV2) ProgramOption

+ type Prompt struct

+ FormatRules string

+ GeneralUsage string

+ Persona string

+ func AuthoringPrompt(env *Env) (*Prompt, error)

+ func AuthoringPromptWithFieldPaths(env *Env) (*Prompt, error)

+ func (p *Prompt) Render(userPrompt string) string

+ type StdLibOption func(*stdLibrary) *stdLibrary

+ func StdLibSubset(subset *env.LibrarySubset) StdLibOption

v0.20.2

May 2, 2024

Changes in this version

+ type ASTOptimizer interface

+ Optimize func(*OptimizerContext, *ast.AST) *ast.AST

+ func NewConstantFoldingOptimizer(opts ...ConstantFoldingOption) (ASTOptimizer, error)

+ func NewInliningOptimizer(inlineVars ...*InlineVariable) ASTOptimizer

type Ast

+ func (ast *Ast) NativeRep() *celast.AST

+ type ConstantFoldingOption func(opt *constantFoldingOptimizer) (*constantFoldingOptimizer, error)

+ func MaxConstantFoldIterations(limit int) ConstantFoldingOption

type Env

+ func (e *Env) Libraries() []string

type EnvOption

+ func CostEstimatorOptions(costOpts ...checker.CostOption) EnvOption

+ func EnableErrorOnBadPresenceTest(value bool) EnvOption

+ type InlineVariable struct

+ func NewInlineVariable(name string, definition *Ast) *InlineVariable

+ func NewInlineVariableWithAlias(name, alias string, definition *Ast) *InlineVariable

+ func (v *InlineVariable) Alias() string

+ func (v *InlineVariable) Expr() ast.Expr

+ func (v *InlineVariable) Name() string

+ func (v *InlineVariable) Type() *Type

+ type OptimizerContext struct

+ func (opt OptimizerContext) ClearMacroCall(id int64)

+ func (opt OptimizerContext) CopyAST(a *ast.AST) (ast.Expr, *ast.SourceInfo)

+ func (opt OptimizerContext) CopyASTAndMetadata(a *ast.AST) ast.Expr

+ func (opt OptimizerContext) NewAST(expr ast.Expr) *ast.AST

+ func (opt OptimizerContext) NewBindMacro(macroID int64, varName string, varInit, remaining ast.Expr) (astExpr, macroExpr ast.Expr)

+ func (opt OptimizerContext) NewCall(function string, args ...ast.Expr) ast.Expr

+ func (opt OptimizerContext) NewHasMacro(macroID int64, s ast.Expr) (astExpr, macroExpr ast.Expr)

+ func (opt OptimizerContext) NewIdent(name string) ast.Expr

+ func (opt OptimizerContext) NewList(elems []ast.Expr, optIndices []int32) ast.Expr

+ func (opt OptimizerContext) NewLiteral(value ref.Val) ast.Expr

+ func (opt OptimizerContext) NewMap(entries []ast.EntryExpr) ast.Expr

+ func (opt OptimizerContext) NewMapEntry(key, value ast.Expr, isOptional bool) ast.EntryExpr

+ func (opt OptimizerContext) NewMemberCall(function string, target ast.Expr, args ...ast.Expr) ast.Expr

+ func (opt OptimizerContext) NewSelect(operand ast.Expr, field string) ast.Expr

+ func (opt OptimizerContext) NewStruct(typeName string, fields []ast.EntryExpr) ast.Expr

+ func (opt OptimizerContext) NewStructField(field string, value ast.Expr, isOptional bool) ast.EntryExpr

+ func (opt OptimizerContext) SetMacroCall(id int64, expr ast.Expr)

+ func (opt OptimizerContext) UpdateExpr(target, updated ast.Expr)

type ProgramOption

+ func CostTrackerOptions(costOpts ...interpreter.CostTrackerOption) ProgramOption

+ type StaticOptimizer struct

+ func NewStaticOptimizer(optimizers ...ASTOptimizer) *StaticOptimizer

+ func (opt *StaticOptimizer) Optimize(env *Env, a *Ast) (*Ast, *Issues)

v0.17.5

Aug 21, 2023

v0.17.4

Aug 21, 2023

v0.17.3

Aug 21, 2023

Changes in this version

+ const AnyKind

+ const BoolKind

+ const BytesKind

+ const DoubleKind

+ const DurationKind

+ const DynKind

+ const HomogeneousAggregateLiteralExemptFunctions

+ const IntKind

+ const ListKind

+ const MapKind

+ const NullTypeKind

+ const OpaqueKind

+ const StringKind

+ const StructKind

+ const TimestampKind

+ const TypeKind

+ const TypeParamKind

+ const UintKind

+ var AllMacro = parser.AllMacro

+ var AnyType = types.AnyType

+ var BoolType = types.BoolType

+ var BytesType = types.BytesType

+ var DoubleType = types.DoubleType

+ var DurationType = types.DurationType

+ var DynType = types.DynType

+ var ExistsMacro = parser.ExistsMacro

+ var ExistsOneMacro = parser.ExistsOneMacro

+ var FilterMacro = parser.FilterMacro

+ var HasMacro = parser.HasMacro

+ var IntType = types.IntType

+ var ListType = types.NewListType

+ var MapFilterMacro = parser.MapFilterMacro

+ var MapMacro = parser.MapMacro

+ var MapType = types.NewMapType

+ var NoMacros = []Macro

+ var NullType = types.NullType

+ var NullableType = types.NewNullableType

+ var ObjectType = types.NewObjectType

+ var OpaqueType = types.NewOpaqueType

+ var OptionalType = types.NewOptionalType

+ var StandardMacros = []Macro

+ var StringType = types.StringType

+ var TimestampType = types.TimestampType

+ var TypeParamType = types.NewTypeParamType

+ var TypeType = types.TypeType

+ var UintType = types.UintType

+ func AstToString(a *Ast) (string, error)

+ func AttributePattern(varName string) *interpreter.AttributePattern

+ func ContextProtoVars(ctx proto.Message) (interpreter.Activation, error)

+ func FormatCELType(t *Type) string

+ func FormatType(t *exprpb.Type) string

+ func PartialVars(vars any, unknowns ...*interpreter.AttributePattern) (interpreter.PartialActivation, error)

+ func RefValueToValue(res ref.Val) (*exprpb.Value, error)

+ func TypeToExprType(t *Type) (*exprpb.Type, error)

+ func ValueToRefValue(adapter types.Adapter, v *exprpb.Value) (ref.Val, error)

+ type ASTValidator interface

+ Name func() string

+ Validate func(*Env, ValidatorConfig, *ast.AST, *Issues)

+ func ValidateComprehensionNestingLimit(limit int) ASTValidator

+ func ValidateDurationLiterals() ASTValidator

+ func ValidateHomogeneousAggregateLiterals() ASTValidator

+ func ValidateRegexLiterals() ASTValidator

+ func ValidateTimestampLiterals() ASTValidator

+ type ASTValidatorConfigurer interface

+ Configure func(MutableValidatorConfig) error

type Ast

+ func CheckedExprToAstWithSource(checkedExpr *exprpb.CheckedExpr, src Source) (*Ast, error)

+ func ParsedExprToAstWithSource(parsedExpr *exprpb.ParsedExpr, src Source) *Ast

+ func (ast *Ast) OutputType() *Type

type Env

+ Container *containers.Container

+ func NewCustomEnv(opts ...EnvOption) (*Env, error)

+ func (e *Env) CELTypeAdapter() types.Adapter

+ func (e *Env) CELTypeProvider() types.Provider

+ func (e *Env) Compile(txt string) (*Ast, *Issues)

+ func (e *Env) CompileSource(src Source) (*Ast, *Issues)

+ func (e *Env) EstimateCost(ast *Ast, estimator checker.CostEstimator, opts ...checker.CostOption) (checker.CostEstimate, error)

+ func (e *Env) Extend(opts ...EnvOption) (*Env, error)

+ func (e *Env) HasFeature(flag int) bool

+ func (e *Env) HasLibrary(libName string) bool

+ func (e *Env) HasValidator(name string) bool

+ func (e *Env) ParseSource(src Source) (*Ast, *Issues)

+ func (e *Env) PartialVars(vars any) (interpreter.PartialActivation, error)

+ func (e *Env) ResidualAst(a *Ast, details *EvalDetails) (*Ast, error)

+ func (e *Env) TypeAdapter() ref.TypeAdapter

+ func (e *Env) TypeProvider() ref.TypeProvider

+ func (e *Env) UnknownVars() interpreter.PartialActivation

type EnvOption

+ func ASTValidators(validators ...ASTValidator) EnvOption

+ func Abbrevs(qualifiedNames ...string) EnvOption

+ func Constant(name string, t *Type, v ref.Val) EnvOption

+ func CrossTypeNumericComparisons(enabled bool) EnvOption

+ func CustomTypeAdapter(adapter types.Adapter) EnvOption

+ func DeclareContextProto(descriptor protoreflect.MessageDescriptor) EnvOption

+ func DefaultUTCTimeZone(enabled bool) EnvOption

+ func EagerlyValidateDeclarations(enabled bool) EnvOption

+ func EnableMacroCallTracking() EnvOption

+ func ExprDeclToDeclaration(d *exprpb.Decl) (EnvOption, error)

+ func ExtendedValidations() EnvOption

+ func Function(name string, opts ...FunctionOpt) EnvOption

+ func HomogeneousAggregateLiterals() EnvOption

+ func Lib(l Library) EnvOption

+ func OptionalTypes(opts ...OptionalTypesOption) EnvOption

+ func ParserExpressionSizeLimit(limit int) EnvOption

+ func ParserRecursionLimit(limit int) EnvOption

+ func StdLib() EnvOption

+ func TypeDescs(descs ...any) EnvOption

+ func Variable(name string, t *Type) EnvOption

+ type Error = common.Error

+ func ExistsMacroExpander(meh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

+ func ExistsOneMacroExpander(meh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

+ func FilterMacroExpander(meh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

+ func HasMacroExpander(meh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

+ func MapMacroExpander(meh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

type EvalDetails

+ func (ed *EvalDetails) ActualCost() *uint64

type EvalOption

+ const OptCheckStringFormat

+ const OptOptimize

+ const OptPartialEval

+ const OptTrackCost

+ type FunctionOpt = decls.FunctionOpt

+ func DisableDeclaration(value bool) FunctionOpt

+ func MemberOverload(overloadID string, args []*Type, resultType *Type, opts ...OverloadOpt) FunctionOpt

+ func Overload(overloadID string, args []*Type, resultType *Type, opts ...OverloadOpt) FunctionOpt

+ func SingletonBinaryBinding(fn functions.BinaryOp, traits ...int) FunctionOpt

+ func SingletonBinaryImpl(fn functions.BinaryOp, traits ...int) FunctionOpt

+ func SingletonFunctionBinding(fn functions.FunctionOp, traits ...int) FunctionOpt

+ func SingletonFunctionImpl(fn functions.FunctionOp, traits ...int) FunctionOpt

+ func SingletonUnaryBinding(fn functions.UnaryOp, traits ...int) FunctionOpt

type Issues

+ func NewIssues(errs *common.Errors) *Issues

+ func NewIssuesWithSourceInfo(errs *common.Errors, info *celast.SourceInfo) *Issues

+ func (i *Issues) Append(other *Issues) *Issues

+ func (i *Issues) ReportErrorAtID(id int64, message string, args ...any)

+ func (i *Issues) String() string

+ type Kind = types.Kind

+ type Library interface

+ CompileOptions func() []EnvOption

+ ProgramOptions func() []ProgramOption

+ type Macro = parser.Macro

+ func GlobalMacro(function string, argCount int, factory MacroFactory) Macro

+ func GlobalVarArgMacro(function string, factory MacroFactory) Macro

+ func NewGlobalMacro(function string, argCount int, expander MacroExpander) Macro

+ func NewGlobalVarArgMacro(function string, expander MacroExpander) Macro

+ func NewReceiverMacro(function string, argCount int, expander MacroExpander) Macro

+ func NewReceiverVarArgMacro(function string, expander MacroExpander) Macro

+ func ReceiverMacro(function string, argCount int, factory MacroFactory) Macro

+ func ReceiverVarArgMacro(function string, factory MacroFactory) Macro

+ type MacroExpander func(eh MacroExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *Error)

+ type MacroExprFactory = parser.ExprHelper

+ type MacroExprHelper interface

+ AccuIdent func() *exprpb.Expr

+ Copy func(*exprpb.Expr) *exprpb.Expr

+ Fold func(iterVar string, iterRange *exprpb.Expr, accuVar string, accuInit *exprpb.Expr, ...) *exprpb.Expr

+ GlobalCall func(function string, args ...*exprpb.Expr) *exprpb.Expr

+ Ident func(name string) *exprpb.Expr

+ LiteralBool func(value bool) *exprpb.Expr

+ LiteralBytes func(value []byte) *exprpb.Expr

+ LiteralDouble func(value float64) *exprpb.Expr

+ LiteralInt func(value int64) *exprpb.Expr

+ LiteralString func(value string) *exprpb.Expr

+ LiteralUint func(value uint64) *exprpb.Expr

+ NewError func(exprID int64, message string) *Error

+ NewList func(elems ...*exprpb.Expr) *exprpb.Expr

+ NewMap func(entries ...*exprpb.Expr_CreateStruct_Entry) *exprpb.Expr

+ NewMapEntry func(key *exprpb.Expr, val *exprpb.Expr, optional bool) *exprpb.Expr_CreateStruct_Entry

+ NewObject func(typeName string, fieldInits ...*exprpb.Expr_CreateStruct_Entry) *exprpb.Expr

+ NewObjectFieldInit func(field string, init *exprpb.Expr, optional bool) *exprpb.Expr_CreateStruct_Entry

+ OffsetLocation func(exprID int64) common.Location

+ PresenceTest func(operand *exprpb.Expr, field string) *exprpb.Expr

+ ReceiverCall func(function string, target *exprpb.Expr, args ...*exprpb.Expr) *exprpb.Expr

+ Select func(operand *exprpb.Expr, field string) *exprpb.Expr

+ type MacroFactory = parser.MacroExpander

+ type MutableValidatorConfig interface

+ Set func(name string, value any) error

+ type OptionalTypesOption func(*optionalLib) *optionalLib

+ func OptionalTypesVersion(version uint32) OptionalTypesOption

+ type OverloadOpt = decls.OverloadOpt

+ func BinaryBinding(binding functions.BinaryOp) OverloadOpt

+ func FunctionBinding(binding functions.FunctionOp) OverloadOpt

+ func OverloadIsNonStrict() OverloadOpt

+ func OverloadOperandTrait(trait int) OverloadOpt

+ func UnaryBinding(binding functions.UnaryOp) OverloadOpt

type Program

+ ContextEval func(context.Context, any) (ref.Val, *EvalDetails, error)

type ProgramOption

+ func CostLimit(costLimit uint64) ProgramOption

+ func CostTracking(costEstimator interpreter.ActualCostEstimator) ProgramOption

+ func CustomDecorator(dec interpreter.InterpretableDecorator) ProgramOption

+ func InterruptCheckFrequency(checkFrequency uint) ProgramOption

+ func OptimizeRegex(regexOptimizations ...*interpreter.RegexOptimization) ProgramOption

+ type SingletonLibrary interface

+ LibraryName func() string

+ type Type = types.Type

+ func ExprTypeToType(t *exprpb.Type) (*Type, error)

+ type ValidatorConfig interface

+ GetOrDefault func(name string, value any) any

v0.1.0

Feb 5, 2019

Changes in this version

+ func AstToCheckedExpr(a Ast) (*exprpb.CheckedExpr, error)

+ func AstToParsedExpr(a Ast) (*exprpb.ParsedExpr, error)

+ func NoVars() interpreter.Activation

+ func Vars(vars map[string]interface{}) interpreter.Activation

+ type Ast interface

+ Expr func() *exprpb.Expr

+ IsChecked func() bool

+ ResultType func() *exprpb.Type

+ Source func() Source

+ SourceInfo func() *exprpb.SourceInfo

+ func CheckedExprToAst(checkedExpr *exprpb.CheckedExpr) Ast

+ func ParsedExprToAst(parsedExpr *exprpb.ParsedExpr) Ast

+ type Env interface

+ Check func(ast Ast) (Ast, Issues)

+ Parse func(txt string) (Ast, Issues)

+ Program func(ast Ast, opts ...ProgramOption) (Program, error)

+ func NewEnv(opts ...EnvOption) (Env, error)

+ type EnvOption func(e *env) (*env, error)

+ func ClearBuiltIns() EnvOption

+ func ClearMacros() EnvOption

+ func Container(pkg string) EnvOption

+ func CustomTypeProvider(provider ref.TypeProvider) EnvOption

+ func Declarations(decls ...*exprpb.Decl) EnvOption

+ func Macros(macros ...parser.Macro) EnvOption

+ func Types(addTypes ...interface{}) EnvOption

+ type EvalDetails interface

+ State func() interpreter.EvalState

+ type EvalOption int

+ const OptExhaustiveEval

+ const OptFoldConstants

+ const OptTrackState

+ type Issues interface

+ Err func() error

+ Errors func() []common.Error

+ type Program interface

+ Eval func(vars interpreter.Activation) (ref.Val, EvalDetails, error)

+ type ProgramOption func(p *prog) (*prog, error)

+ func EvalOptions(opts ...EvalOption) ProgramOption

+ func Functions(funcs ...*functions.Overload) ProgramOption

+ func Globals(vars interpreter.Activation) ProgramOption

+ type Source interface

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL