Release 0.1.0 version

PiperOrigin-RevId: 511248130

Author: l46kok

README.md

@@ -100,12 +100,12 @@ import dev.cel.common.CelAbstractSyntaxTree;
 import dev.cel.runtime.CelRuntimeFactory;
 
 CelRuntime celRuntime = CelRuntimeFactory.standardCelRuntimeBuilder().build();
-CelAbstractSyntaxTree ast = CelAbstractSyntaxTree.fromCheckedExpr(checkedExpr);
+CelAbstractSyntaxTree ast = CelProtoAbstractSyntaxTree.fromCheckedExpr(checkedExpr);
 
 try {
-  CelRuntime.Program program=celRuntime.createProgram(ast);
-  Object evaluatedResult=program.eval(parameterValues);
-} catch(CelEvaluationException e) {
+  CelRuntime.Program program = celRuntime.createProgram(ast);
+  Object evaluatedResult = program.eval(parameterValues);
+} catch (CelEvaluationException e) {
   throw new IllegalArgumentException("Evaluation error has occurred.",e);
 }
 ```
@@ -153,7 +153,23 @@ This section will be completed once parser and type-checker has been added.
 
 ## Install
 
-CEL-Java will be available in Maven repository soon.
+CEL-Java is available in Maven Central Repository. [Download the JARs here][6] or add the following to your build dependencies:
+
+**Maven (pom.xml)**:
+
+```xml
+<dependency>
+  <groupId>dev.cel</groupId>
+  <artifactId>runtime</artifactId>
+  <version>0.1.0</version>
+</dependency>
+```
+
+**Gradle**
+
+```gradle
+implementation 'dev.cel:runtime:0.1.0'
+```
 
 ## Common Questions
 
@@ -218,4 +234,6 @@ Disclaimer: This is not an official Google product.
 
 [4]:  https://github.com/google/cel-go
 
-[5]:  https://github.com/google/cel-java/issues
+[5]:  https://github.com/google/cel-java/issues
+
+[6]:  https://search.maven.org/search?q=g:dev.cel

publish/cel_version.bzl

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 """Maven artifact version for CEL."""
-CEL_VERSION = "0.1.0-alpha"
+CEL_VERSION = "0.1.0"

publish/publish.sh

@@ -1,12 +1,28 @@
 #!/bin/bash
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 #
 # Publishes CEL to a Maven repository.
 #
-# To push locally, just run the script
-# To publish a SNAPSHOT version, run with -snapshot (-s) flag: "publish.sh --snapshot"
+# To push locally, just run the script. On MacOS by default, the artifact lives in ~/.m2/repository
+# To publish a SNAPSHOT version, run with -snapshot (-s) flag: "publish.sh --snapshot". Snapshots can be found in https://s01.oss.sonatype.org/#nexus-search;quick~dev.cel
 # To publish a RELEASE version remotely, run with -release (-r) flag: "publish.sh --release". Note that released maven artifacts are permanent and can never be deleted under any circumstances.
 
-# Note: To publish, you must create a pgp certificate and upload it to keyserver.ubuntu.com. See https://blog.sonatype.com/2010/01/how-to-generate-pgp-signatures-with-maven/
+# Note, to publish remotely:
+# 1. You must create a pgp certificate and upload it to keyserver.ubuntu.com. See https://blog.sonatype.com/2010/01/how-to-generate-pgp-signatures-with-maven/
+# 2. You will need to enter the key's password. The prompt appears in GUI, not in terminal. The publish operation will eventually timeout if the password is not entered.
 
 RUNTIME_TARGET=//publish:cel_runtime.publish
 

runtime/src/test/java/dev/cel/runtime/BUILD.bazel

@@ -10,8 +10,10 @@ java_library(
         "//common/src/main/java/dev/cel/common",
         "//common/src/main/java/dev/cel/common:options",
         "//common/src/main/java/dev/cel/common:proto_ast",
+        "//common/src/main/java/dev/cel/common:proto_v1alpha1_ast",
         "//common/src/main/java/dev/cel/common/internal:converter",
         "//common/src/main/java/dev/cel/common/internal:dynamic_proto",
+        "//common/src/main/java/dev/cel/common/types:cel_v1alpha1_types",
         "//common/src/main/resources/testdata/proto2:messages_extensions_proto2_java_proto",
         "//common/src/main/resources/testdata/proto2:messages_proto2_java_proto",
         "//common/src/main/resources/testdata/proto3:test_all_types_java_proto",
@@ -20,6 +22,7 @@ java_library(
         "//runtime/src/main/java/dev/cel/runtime:runtime_helper",
         "//runtime/src/main/java/dev/cel/runtime:unknown_attributes",
         "@cel_spec//proto/expr:expr_java_proto",
+        "@com_google_googleapis//google/api/expr/v1alpha1:expr_java_proto",
         "@com_google_googleapis//google/rpc/context:attribute_context_java_proto",
         "@com_google_protobuf//:any_proto",
         "@com_google_protobuf//:duration_proto",

runtime/src/test/java/dev/cel/runtime/CelRuntimeTest.java

@@ -17,13 +17,18 @@
 import static com.google.common.truth.Truth.assertThat;
 
 import dev.cel.expr.CheckedExpr;
+import com.google.api.expr.v1alpha1.Constant;
+import com.google.api.expr.v1alpha1.Expr;
+import com.google.api.expr.v1alpha1.Type.PrimitiveType;
 import com.google.common.collect.ImmutableMap;
 import com.google.protobuf.Any;
 import com.google.protobuf.ByteString;
 import com.google.protobuf.ExtensionRegistry;
 import com.google.rpc.context.AttributeContext;
 import dev.cel.common.CelOptions;
 import dev.cel.common.CelProtoAbstractSyntaxTree;
+import dev.cel.common.CelProtoV1Alpha1AbstractSyntaxTree;
+import dev.cel.common.types.CelV1AlphaTypes;
 import java.util.Base64;
 import org.junit.Test;
 import org.junit.runner.RunWith;
@@ -74,4 +79,27 @@ public void evaluate_anyPackedEqualityUsingProtoDifferencer_success() throws Exc
 
     assertThat(evaluatedResult).isEqualTo(true);
   }
+
+  @Test
+  public void evaluate_v1alpha1CheckedExpr() throws Exception {
+    // Note: v1alpha1 proto support exists only to help migrate existing consumers.
+    // New users of CEL should use the canonical protos instead (I.E: dev.cel.expr)
+    com.google.api.expr.v1alpha1.CheckedExpr checkedExpr =
+        com.google.api.expr.v1alpha1.CheckedExpr.newBuilder()
+            .setExpr(
+                Expr.newBuilder()
+                    .setId(1)
+                    .setConstExpr(Constant.newBuilder().setStringValue("Hello world!").build())
+                    .build())
+            .putTypeMap(1, CelV1AlphaTypes.create(PrimitiveType.STRING))
+            .build();
+    CelRuntime celRuntime = CelRuntimeFactory.standardCelRuntimeBuilder().build();
+    CelRuntime.Program program =
+        celRuntime.createProgram(
+            CelProtoV1Alpha1AbstractSyntaxTree.fromCheckedExpr(checkedExpr).getAst());
+
+    String evaluatedResult = (String) program.eval();
+
+    assertThat(evaluatedResult).isEqualTo("Hello world!");
+  }
 }