cel

Nov 6, 2024

Changes in this version

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

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

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

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

type Env

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

type EnvOption

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

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

type OptimizerContext

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

Aug 2, 2024

Changes in this version

type Env

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

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

type EnvOption

+ func EnableErrorOnBadPresenceTest(value bool) EnvOption

type OptimizerContext

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

Mar 7, 2024

Changes in this version

type OptimizerContext

+ func (opt OptimizerContext) ClearMacroCall(id int64)

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

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

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

Nov 10, 2023

Changes in this version

type Ast

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

type OptimizerContext

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

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

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

Sep 1, 2023

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 ConstantFoldingOption func(opt *constantFoldingOptimizer) (*constantFoldingOptimizer, error)

+ func MaxConstantFoldIterations(limit int) ConstantFoldingOption

+ 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) CopyExpr(e ast.Expr) ast.Expr

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

+ func (opt OptimizerContext) NewCall(function string, args ...ast.Expr) 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) NewPresenceTest(macroID int64, operand ast.Expr, field string) 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

+ type StaticOptimizer struct

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

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

Oct 30, 2023

Changes in this version

type EnvOption

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

type ProgramOption

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

Aug 23, 2023

Changes in this version

type Env

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

Aug 18, 2023

Changes in this version

type Macro

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

+ func GlobalVarArgMacro(function string, factory MacroFactory) Macro

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

+ func ReceiverVarArgMacro(function string, factory MacroFactory) Macro

+ type MacroExprFactory = parser.ExprHelper

type MacroExprHelper

+ 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

Jul 18, 2023

Changes in this version

+ const HomogeneousAggregateLiteralExemptFunctions

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

+ func FormatCELType(t *Type) string

+ type ASTValidator interface

+ Name func() string

+ Validate func(*Env, ValidatorConfig, *ast.CheckedAST, *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 Env

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

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

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

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

type EnvOption

+ func ASTValidators(validators ...ASTValidator) EnvOption

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

+ func ExtendedValidations() EnvOption

+ type Error = common.Error

type FunctionOpt

+ func DisableDeclaration(value bool) FunctionOpt

type Issues

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

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

+ type MutableValidatorConfig interface

+ Set func(name string, value any) error

+ type OptionalTypesOption func(*optionalLib) *optionalLib

+ func OptionalTypesVersion(version uint32) OptionalTypesOption

+ type ValidatorConfig interface

+ GetOrDefault func(name string, value any) any

May 30, 2023

Changes in this version

type EnvOption

+ func ParserExpressionSizeLimit(limit int) EnvOption

Apr 4, 2023

Changes in this version

type EvalOption

+ const OptCheckStringFormat

Dec 6, 2022

Changes in this version

type Env

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

type EnvOption

+ func OptionalTypes() EnvOption

+ func ParserRecursionLimit(limit int) EnvOption

type FunctionOpt

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

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

+ type SingletonLibrary interface

+ LibraryName func() string

type Type

+ func OptionalType(param *Type) *Type

Jul 6, 2022

Changes in this version

+ var AllMacro = parser.AllMacro

+ var AnyType = &Type

+ var BoolType = &Type

+ var BytesType = &Type

+ var DoubleType = &Type

+ var DurationType = &Type

+ var DynType = &Type

+ var ExistsMacro = parser.ExistsMacro

+ var ExistsOneMacro = parser.ExistsOneMacro

+ var FilterMacro = parser.FilterMacro

+ var HasMacro = parser.HasMacro

+ var IntType = &Type

+ var MapFilterMacro = parser.MapFilterMacro

+ var MapMacro = parser.MapMacro

+ var NoMacros = []Macro

+ var NullType = &Type

+ var StandardMacros = []Macro

+ var StringType = &Type

+ var TimestampType = &Type

+ var TypeType = &Type

+ var UintType = &Type

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

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

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

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

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

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

type Ast

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

type EnvOption

+ func DefaultUTCTimeZone(enabled bool) EnvOption

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

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

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

+ type FunctionOpt func(*functionDecl) (*functionDecl, error)

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

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

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

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

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

+ type Kind uint

+ const AnyKind

+ const BoolKind

+ const BytesKind

+ const DoubleKind

+ const DurationKind

+ const DynKind

+ const IntKind

+ const ListKind

+ const MapKind

+ const NullTypeKind

+ const OpaqueKind

+ const StringKind

+ const StructKind

+ const TimestampKind

+ const TypeKind

+ const TypeParamKind

+ const UintKind

+ type Macro = parser.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

+ type MacroExpander = parser.MacroExpander

+ type MacroExprHelper = parser.ExprHelper

+ type OverloadOpt func(*overloadDecl) (*overloadDecl, error)

+ 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 Type struct

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

+ func ListType(elemType *Type) *Type

+ func MapType(keyType, valueType *Type) *Type

+ func NullableType(wrapped *Type) *Type

+ func ObjectType(typeName string) *Type

+ func OpaqueType(name string, params ...*Type) *Type

+ func TypeParamType(paramName string) *Type

+ func (t *Type) IsAssignableRuntimeType(runtimeType ref.Type) bool

+ func (t *Type) IsAssignableType(fromType *Type) bool

+ func (t *Type) String() string

Mar 24, 2022

Changes in this version

type EnvOption

+ func EagerlyValidateDeclarations(enabled bool) EnvOption

Mar 8, 2022

Changes in this version

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

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

type Env

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

type EnvOption

+ func CrossTypeNumericComparisons(enabled bool) EnvOption

+ func EnableMacroCallTracking() EnvOption

type EvalDetails

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

type EvalOption

+ const OptTrackCost

type Program

+ ContextEval func(context.Context, interface{}) (ref.Val, *EvalDetails, error)

type ProgramOption

+ func CostLimit(costLimit uint64) ProgramOption

+ func CostTracking(costEstimator interpreter.ActualCostEstimator) ProgramOption

+ func InterruptCheckFrequency(checkFrequency uint) ProgramOption

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

Oct 19, 2021

Changes in this version

type Ast

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

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

Sep 18, 2021

Changes in this version

type EnvOption

+ func DeclareContextProto(descriptor protoreflect.MessageDescriptor) EnvOption

Jan 29, 2021

Changes in this version

+ func FormatType(t *exprpb.Type) string

Sep 2, 2020

Changes in this version

+ func EstimateCost(p Program) (min, max int64)

type Env

+ Container *containers.Container

type EnvOption

+ func Abbrevs(qualifiedNames ...string) EnvOption

type ProgramOption

+ func CustomDecorator(dec interpreter.InterpretableDecorator) ProgramOption

May 22, 2020

Changes in this version

+ const FeatureDisableDynamicAggregateLiterals

type Env

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

+ func (e *Env) SetFeature(flag int)

type EnvOption

+ func Features(flags ...int) EnvOption

Mar 10, 2020

Changes in this version

+ func AttributePattern(varName string) *interpreter.AttributePattern

+ func PartialVars(vars interface{}, unknowns ...*interpreter.AttributePattern) (interpreter.PartialActivation, error)

type Env

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

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

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

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

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

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

type EnvOption

+ func Lib(l Library) EnvOption

+ func StdLib() EnvOption

type EvalOption

+ const OptPartialEval

type Issues

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

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

+ func (i *Issues) String() string

+ type Library interface

+ CompileOptions func() []EnvOption

+ ProgramOptions func() []ProgramOption

Oct 9, 2019

Changes in this version

type Env

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

Aug 20, 2019

Changes in this version

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

type EvalOption

+ const OptOptimize

Apr 1, 2019

Changes in this version

type Env

+ TypeAdapter func() ref.TypeAdapter

+ TypeProvider func() ref.TypeProvider

type EnvOption

+ func CustomTypeAdapter(adapter ref.TypeAdapter) EnvOption

+ func HomogeneousAggregateLiterals() EnvOption

+ func TypeDescs(descs ...interface{}) EnvOption

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