v0.26.1

Compare Source

What's Changed

• Comprehension nesting limit typo, allow nesting limit validator to accept doubles as limits by @​l46kok in #​1196
• Minor compatibility fixes for google3-import. by @​jnthntatum in #​1198
• Bump the npm_and_yarn group across 1 directory with 2 updates by @​dependabot[bot] in #​1197
• Init function bindings on environment init by @​beldmian in #​1199
• Support variable descriptions in the AI prompt template by @​TristonianJones in #​1205
• Add support for nested element type by @​MisLink in #​1190
• Support unwrapping unknown implementations of proto.Message by @​srikrsna in #​1207

New Contributors

• @​beldmian made their first contribution in #​1199
• @​MisLink made their first contribution in #​1190
• @​srikrsna made their first contribution in #​1207

Full Changelog: google/cel-go@v0.25.1...v0.26.1

v0.26.0

Compare Source

New Features ✨

• Add support for global constants to constant folder by @​zeitgeist87 in #​1180
• Adding CEL Regex Extensions by @​maskri17 in #​1187
• Sqrt func by @​haribalan in #​1166
• Add bazel rule to trigger cel tests and return policy metadata while creating CEL programs by @​aakash070 in #​1176
• Create an util method to convert rpc status to eval status by @​ChinmayMadeshi in #​1178
• Add test runner option to configure a custom test suite parser by @​aakash070 in #​1189
• Cost tracking for list operations by @​TristonianJones in #​1192

Bug Fixes 🐛

• Fix lastIndexOf behavior against an empty string in strings extension by @​l46kok in #​1173
• Fix container setting for cel test all types example in online REPL by @​l46kok in #​1182
• fix(checker): Correct Sprintf argument count by @​cuishuang in #​1185

Test Updates 🧪

• fix test runner test cases by @​aakash070 in #​1170
• Update test runner to avoid using flags when not necessary by @​TristonianJones in #​1174
• add support for handling unknown expression ids in test result by @​aakash070 in #​1183
• Test case for aliasing container imports by @​TristonianJones in #​1193

Documentation 📚

• Add documentation for YAML quirks in celpolicy by @​jnthntatum in #​1186

Dependency Updates ⬆️

• Bump the npm_and_yarn group across 1 directory with 2 updates by @​dependabot[bot] in #​1188

v0.25.1

Compare Source

v0.25.0

Compare Source

Features & Enhancements

This release introduces features for richer configuration-based CEL, AI prompt generation from config files, additional documentation, and 3x performance when evaluating traced / state-tracking expressions. This release also introduces a unit test runner framwork.

#​1141: Expose extension option factory as a public method

#​1143: Add a new compiler tool which can be used to compile CEL expressions and policies using serialized environment

#​1151: Lightweight observable evaluation

#​1155: Utilities for formatting and parsing documentation strings

#​1156: Support for documentation and example strings in CEL environments

#​1158: Re-export interpreter.AttributePattern in package cel.

#​1159: Document the standard library macros and functions

#​1160: Prompt generation for AI-assisted authoring based on a CEL environment

#​1117: Add LateFunctionBinding declaration and fix constant folding

#​1163: Initialize stateful observers prior to evaluation

#​1164: Unparse Expr values to strings

#​1149: Add test runner library

#​1167: REPL: Add an extension option for two var comprehensions

Fixes

Several fixes were implemented, including updating strings.format to better adhere to the specification, correcting constant folding logic alongside the late binding feature, removing a non-functional check in test code, and adding argument count validation for optFieldSelect.

#​1133: Update strings.format to adhere to the specification

#​1117: Add LateFunctionBinding declaration and fix constant folding

#​1161: Remove non-functional optional check in test-only selection

#​1168: Check arg count when validating optFieldSelect

Refactoring & Internal Improvements

General refactoring was performed across the codebase. Coverage and comments for Activation methods were improved. The test runner library was refactored to create options from flags and improve code structure.

#​1145: Refactoring changes

#​1150: Additional comments and coverage for Activation methods

#​1165: Refactoring changes to create a test runner option from passed flags, correct indentation and add package level comment for test

Documentation

Documentation was enhanced, including updates to the NativeTypes documentation regarding the cel tag, adding documentation for the optional library, and documenting the standard library functions/macros as part of the documentation string feature.

#​1148: Update NativeTypes doc to reflect how to enable cel tag

#​1155: Utilities for formatting and parsing documentation strings

#​1156: Support for documentation and example strings in CEL environments

#​1159: Document the standard library macros and functions

#​1162: Document optional library and increase docs coverage

Build System

Configuration fixes were made for Bzlmod compatibility.

#​1146: Bzlmod configuration fixes

Type System

Type formatting was updated to correctly handle type parameters.

#​1154: Update type formatting for type params

v0.24.1

Compare Source

Fixes

• Separate unnest optimization from composer to capture type info [#​1138]

Full Changelog: google/cel-go@v0.24.0...v0.24.1

v0.24.0

Compare Source

Support for subsetting CEL standard library and serialization of CEL environments to YAML.

CEL is an official Google product [#​1122]

Features

• Helper methods for subsetting function overloads [#​1120]
• Introduce cel package aliases for Activation [#​1123]
• Canonical environment description and stdlib subsetting [#​1125]
• Support for cel.Env conversion to YAML-serializable config [#​1128]
• Option to configure CEL via env.Config object [#​1129]
• Support for feature flags and validators in env.Config [#​1132]
• Add k8s custom policy tag handler for test [#​1121]

Fixes

• ContextEval support for Unknowns [#​1126]
• Fix godoc formatting for Lists and OptionalTypes functions [#​1127]
• Default enable DefaultUTCTimeZone [#​1130]
• Support for splitting nested branching operators within policies [#​1136]

New Contributors

• @​chaewonkong made their first contribution in #​1127

Full Changelog: google/cel-go@v0.23.2...v0.24.0

v0.23.2

Compare Source

Corrects one remaining issue for cost computations from the v0.23.0 releases

Fixes

• Bump github.com/golang/glog from 1.0.0 to 1.2.4 in /codelab in the go_modules group across 1 directory by @​dependabot in #​1115
• Minor update on cost order by @​TristonianJones in #​1119

Full Changelog: google/cel-go@v0.23.1...v0.23.2

v0.23.1

Compare Source

Minor release to address cost tracking and size estimation [#​1113]

Full Changelog: google/cel-go@v0.23.0...v0.23.1

v0.23.0

Compare Source

Features

• First and last element in list support [#​1067]
• Add support for typed conformance tests. [#​1089]
• Add syntax for escaped field selectors. [#​1002]
• Add optional.unwrap() / .unwrapOpt() function [#​1103]
• Cost tracking for two-variable comprehensions and bindings [#​1104]

Fixes

PR #​1099 enables a change in the internal variable name used for comprehension result accumulation. This change may break some tests which inspect the AST contents in text form; however, will not break any existing uses of CEL during parse, check, or evaluation.

• Improve policy compiler error message for incompatible outputs. [#​1082]
• Fix partial evaluation with the comprehension folder objects [#​1084]
• Introduce versioning options to all extensions [#​1075]
• Fix a crash in mismatched output check for nested rules [#​1086]
• improve debug output to properly quote byte strings [#​1088]
• Fix two-variable comprehension pruning [#​1083]
• Replace checks for valid UTF-8 in strings with go-maintained calls [#​1094]
• Policy nested rule fix [#​1092]
• Address non-const format string lint findings [#​1096]
• Fix typos in ext/README.md [#​1098]
• Add option to use inaccessible accumulator var [#​1097]
• Add test cases for string.format covering various edge cases [#​1101]
• Add base_config and partial_config files under restricted_destination testdata [#​1106]
• Default enable using hidden accumulator name [#​1099]
• Update PruneAst to support constants of optional type [#​1109]

New Contributors

• @​bigkevmcd made their first contribution in #​1067
• @​hudlow made their first contribution in #​1088
• @​dbuduev made their first contribution in #​1098
• @​zeitgeist87 made their first contribution in #​1101

Full Changelog: google/cel-go@v0.22.1...v0.23.0

v0.22.1

Compare Source

Fixes

• Additional hardening on legacy macros [#​1064]
• Additional nil-safety checks with corresponding test updates [#​1073]
• Add two-variable comprehension support to cel-policy [#​1074]
• Fix optional test to short-circuit [#​1076]
• Fix nil-type when two-var comprehension has a dyn range [#​1077]

New Contributors

• @​aakash070 made their first contribution in #​1069

Full Changelog: google/cel-go@v0.22.0...v0.22.1

v0.22.0

Compare Source

What's Changed

Core CEL

• Add list flatten() by @​fabriziosestito in https://github.com/google/cel-go/pull/980
• Add sets and lists extensions to REPL by @​l46kok in https://github.com/google/cel-go/pull/1005
• CEL Spec and Proto Updates by @​TristonianJones in https://github.com/google/cel-go/pull/1011
• Implement native conformance test runner by @​jcking in https://github.com/google/cel-go/pull/1001
• Add support for no padding in base64 decode by @​TristonianJones in https://github.com/google/cel-go/pull/1017
• Allow configurable tag name overrides in native types by @​matthchr in https://github.com/google/cel-go/pull/1009
• Introduce helper trait types for lists and maps by @​TristonianJones in https://github.com/google/cel-go/pull/1026
• ext: add list.sort() by @​cezar-guimaraes in https://github.com/google/cel-go/pull/1021
• Foldable Maps and Lists by @​TristonianJones in https://github.com/google/cel-go/pull/995
• Update REPL examples by @​jnthntatum in https://github.com/google/cel-go/pull/1028
• Interop foldable maps and lists with map mutation helper by @​TristonianJones in https://github.com/google/cel-go/pull/1029
• Update the Go AST representation to handle a second iteration variable by @​TristonianJones in https://github.com/google/cel-go/pull/1031
• Runtime support for two-variable comprehensions by @​TristonianJones in https://github.com/google/cel-go/pull/1032
• Two-variable comprehension support by @​TristonianJones in https://github.com/google/cel-go/pull/1034
• Update tag-based parsing to use lambda for additional customization by @​matthchr in https://github.com/google/cel-go/pull/1039
• Fix string reverse member overload name by @​TristonianJones in https://github.com/google/cel-go/pull/1045
• Remove unused server directory by @​TristonianJones in https://github.com/google/cel-go/pull/1041
• Add functions to the lists extension. by @​seirl in https://github.com/google/cel-go/pull/1037
• Rename strings version test by @​TristonianJones in https://github.com/google/cel-go/pull/1047
• Fix doc strings and version support on math extensions by @​TristonianJones in https://github.com/google/cel-go/pull/1046
• Upgrade cel-go to support bazel-mod by @​TristonianJones in https://github.com/google/cel-go/pull/1049
• Fix out of range error for non-negative string indexing offsets by @​TristonianJones in https://github.com/google/cel-go/pull/1052
• Expand visibility of parser/gen package by @​TristonianJones in https://github.com/google/cel-go/pull/1057
• Ensure variables in comprehensions don't collide by @​TristonianJones in https://github.com/google/cel-go/pull/1062

Policy

• Support for typename import aliases by @​TristonianJones in https://github.com/google/cel-go/pull/993
• Error on condition-only match blocks by @​TristonianJones in https://github.com/google/cel-go/pull/1003
• Update context proto resolution to use type provider by @​TristonianJones in https://github.com/google/cel-go/pull/1013
• Support for context proto declarations by @​TristonianJones in https://github.com/google/cel-go/pull/1006
• CEL Policy Readme by @​TristonianJones in https://github.com/google/cel-go/pull/1025
• Support for cel.@​block during policy composition by @​TristonianJones in https://github.com/google/cel-go/pull/1056

New Contributors

• @​fabriziosestito made their first contribution in https://github.com/google/cel-go/pull/980
• @​matthchr made their first contribution in https://github.com/google/cel-go/pull/1009
• @​cezar-guimaraes made their first contribution in https://github.com/google/cel-go/pull/1021
• @​sreeram-venkitesh made their first contribution in https://github.com/google/cel-go/pull/1035

Full Changelog: google/cel-go@v0.21.0...v0.22.0

v0.21.0

Compare Source

Features

• Math extensions update to include bitwise ops and floating point helpers [#​923]
• Better support custom types with custom type registries [#​931]
• repl: implement %parse [#​933]
• Fixed partial variables extended bug and split PartialVarsEnvExtended test into two [#​955]
• Added partial evaluations example [#​959]
• Enable conformance tests for extensions [#​930]
• Update cel-spec and enable optional_type conformance tests [#​919]
• Improve token representation in AST [#​932]
• Add function accessor to Env [#​978]

CEL Policy Compiler

Policies which use CEL often evolve to express complex logic using multiple statements
and decision criteria. The CEL Policy Compiler provides an extensible format for parsing,
compiling, and composing expression graphs. Below is a simple example which can easily
be compiled to a single CEL expression.

name: "my-policy"
rule:
  variables:
    - name: greeting
      expression: "'%s, %s!'"
    - name: people
      expression: >
       ['Tristan', 'Calla', 'Antoine', 'Jonathan', 'Sokwhan', 'Rebecca']
  match:
    - condition: "request.user in variables.people"
      output: "variables.greeting.format(['hello', request.user])"
    - output: "variables.greeting.format(['goodbye', 'stranger'])"

• Simple Policy Compiler [#​924]
• Introduce protobuf message testing to policies [#​961]
• Generate policy explanations during compilation [#​977]
• Variable and nested rule limits [#​989]
• Improved support for nested rules #​991]

Fixes

• Delete dangling source info from macro expansion [#​934]
• Do not re-use ID twice in exists_one macro [#​935]
• Avoid iterating over the source multiple times during parse [#​936]
• Fix for working with byte arrays by [#​958]
• Stabilize macro id generation during optimization [#​962]
• String formatting panic fix for non-literal format strings [#​987]
• Add nil checking for wrapperspb's types [#​960]
• Prevent self-append for Issues [#​988]
• Use bytes interface value for zero native type struct fields instead of dynamic list [#​981]

Presence Test Semantics

The following two changes identified an issue where presence test was unexpectedly being performed over a scalar type and evaluating to absent rather than erroring. It is strongly advised to set the flag cel.EnableErrorOnBadPresenceTest(true) to avoid a logical correctness issue.

• Fix presence test to produce an error when it's not a map or a message [#​922]
• Update the presence testing fix to be opt-out [#​939]

Deprecation Cleanup

• Remove the deprecated protobuf function and type declarations [#​921]

New Contributors

• @​testwill made their first contribution in https://github.com/google/cel-go/pull/911
• @​patrickpichler made their first contribution in https://github.com/google/cel-go/pull/941
• @​seirl made their first contribution in https://github.com/google/cel-go/pull/948
• @​jduraniglesias made their first contribution in https://github.com/google/cel-go/pull/955
• @​goccy made their first contribution in https://github.com/google/cel-go/pull/960

Full Changelog: google/cel-go@v0.20.1...v0.21.0