Add reporting v2 cli tool.

src/main/kotlin/org/wfanet/measurement/reporting/service/api/v2alpha/tools/BUILD.bazel

@@ -0,0 +1,29 @@
+load("@rules_java//java:defs.bzl", "java_binary")
+load("@io_bazel_rules_kotlin//kotlin:jvm.bzl", "kt_jvm_library")
+
+package(
+    default_visibility = ["//src/test/kotlin/org/wfanet/measurement/reporting:__subpackages__"],
+)
+
+kt_jvm_library(
+    name = "reporting",
+    srcs = ["Reporting.kt"],
+    deps = [
+        "//src/main/kotlin/org/wfanet/measurement/kingdom/deploy/common:flags",
+        "//src/main/proto/wfa/measurement/reporting/v2alpha:event_groups_service_kt_jvm_grpc_proto",
+        "//src/main/proto/wfa/measurement/reporting/v2alpha:reporting_sets_service_kt_jvm_grpc_proto",
+        "//src/main/proto/wfa/measurement/reporting/v2alpha:reports_service_kt_jvm_grpc_proto",
+        "@wfa_common_jvm//imports/java/picocli",
+        "@wfa_common_jvm//imports/kotlin/com/google/protobuf/kotlin",
+        "@wfa_common_jvm//imports/kotlin/kotlinx/coroutines:core",
+        "@wfa_common_jvm//src/main/kotlin/org/wfanet/measurement/common",
+        "@wfa_common_jvm//src/main/kotlin/org/wfanet/measurement/common/grpc",
+    ],
+)
+
+java_binary(
+    name = "Reporting",
+    main_class = "org.wfanet.measurement.reporting.service.api.v2alpha.tools.ReportingKt",
+    tags = ["manual"],
+    runtime_deps = [":reporting"],
+)

src/main/kotlin/org/wfanet/measurement/reporting/service/api/v2alpha/tools/README.md

@@ -0,0 +1,163 @@
+# Reporting CLI Tools
+
+Command-line tools for Reporting API. Use the `help` subcommand for help with
+any of the subcommands.
+
+Note that instead of specifying arguments on the command-line, you can specify
+an arguments file using `@` followed by the path. For example,
+
+```shell
+Reporting @/home/foo/args.txt
+```
+
+## Certificate Host
+
+In the event that the host you specify to the `--reporting-server-api-target`
+option doesn't match what's in the Subject Alternative Name (SAN) extension of
+the server's certificate, you'll need to specify a host that does match using
+the `--reporting-server-api-cert-host` option.
+
+## Examples
+
+### reporting-sets
+
+#### create
+
+```shell
+Reporting \
+  --tls-cert-file=src/main/k8s/testing/secretfiles/mc_tls.pem \
+  --tls-key-file=src/main/k8s/testing/secretfiles/mc_tls.key \
+  --cert-collection-file src/main/k8s/testing/secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reporting-sets create \
+  --parent=measurementConsumers/VCTqwV_vFXw \
+  --cmms-event-group=dataProviders/FeQ5FqAQ5_0/eventGroups/OsICFAbXJ5c \
+  --filter='video_ad.age.value == 1' --display-name='test-reporting-set' \
+  --id=abc
+```
+
+```shell
+Reporting \
+  --tls-cert-file=src/main/k8s/testing/secretfiles/mc_tls.pem \
+  --tls-key-file=src/main/k8s/testing/secretfiles/mc_tls.key \
+  --cert-collection-file src/main/k8s/testing/secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reporting-sets create \
+  --parent=measurementConsumers/VCTqwV_vFXw \
+  --set-expression='
+      operation: UNION
+      lhs {
+        reporting_set: "measurementConsumers/VCTqwV_vFXw/reportingSets/abc"
+      }
+  ' \
+  --filter='video_ad.age.value == 1' --display-name='test-reporting-set' \
+  --id=abc
+```
+
+User specifies a primitive ReportingSet with one or more `--cmms-event-group` 
+and a composite ReportingSet with `--set-expression`.
+
+The `--set-expression` option expects a
+[`SetExpression`](../../../../../../../../../proto/wfa/measurement/reporting/v2alpha/reporting_set.proto)
+protobuf message in text format. You can use shell quoting for a multiline string, or
+use command substitution to read the message from a file e.g. `--set-expression=$(cat
+set_expression.textproto)`.
+
+#### list
+
+```shell
+Reporting \
+  --tls-cert-file=src/main/k8s/testing/secretfiles/mc_tls.pem \
+  --tls-key-file=src/main/k8s/testing/secretfiles/mc_tls.key \
+  --cert-collection-file src/main/k8s/testing/secretfiles/reporting_root.pem \
+  --reporting-server-api-target v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reporting-sets list --parent=measurementConsumers/VCTqwV_vFXw
+```
+
+To retrieve the next page of reports, use the `--page-token` option to specify
+the token returned from the previous response.
+
+### reports
+
+#### create
+
+```shell
+Reporting \
+  --tls-cert-file=secretfiles/mc_tls.pem \
+  --tls-key-file=secretfiles/mc_tls.key \
+  --cert-collection-file=secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reports create \
+  --parent=measurementConsumers/VCTqwV_vFXw \
+  --id=abcd \
+  --request-id=abcd \
+  --interval-start-time=2023-01-15T01:30:15.01Z \
+  --interval-end-time=2023-06-27T23:19:12.99Z \
+  --interval-start-time=2023-06-28T09:48:35.57Z \
+  --interval-end-time=2023-12-13T11:57:54.21Z \
+  --reporting-metric-entry='
+      key: "measurementConsumers/VCTqwV_vFXw/reportingSets/abc"
+      value {
+        metric_calculation_specs {
+          display_name: "spec_1"
+          metric_specs {
+            reach {
+              privacy_params {
+                epsilon: 0.0041
+                delta: 1.0E-12
+              }
+            }
+            vid_sampling_interval {
+              width: 0.01
+            }
+          }
+        }
+      }
+  '
+```
+
+User specifies the type of time args by using either repeated interval params(
+`--interval-start-time`, `--interval-end-time`) or periodic time args(
+`--periodic-interval-start-time`, `--periodic-interval-increment` and
+`--periodic-interval-count`)
+
+The `--reporting-metric-entry` option expects a
+[`ReportingMetricEntry`](../../../../../../../../../proto/wfa/measurement/reporting/v2alpha/report.proto)
+protobuf message in text format. You can use shell quoting for a multiline string, or
+use command substitution to read the message from a file e.g. `--reporting-metric-entry=$(cat
+reporting_metric_entry.textproto)`.
+
+#### list
+
+```shell
+Reporting \
+  --tls-cert-file=secretfiles/mc_tls.pem \
+  --tls-key-file=secretfiles/mc_tls.key \
+  --cert-collection-file=secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reports list --parent=measurementConsumers/VCTqwV_vFXw
+```
+
+#### get
+
+```shell
+Reporting \
+  --tls-cert-file=secretfiles/mc_tls.pem \
+  --tls-key-file=secretfiles/mc_tls.key \
+  --cert-collection-file=secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  reports get measurementConsumers/VCTqwV_vFXw/reports/abcd
+```
+
+### event-groups
+
+#### list
+```shell
+Reporting \
+  --tls-cert-file=secretfiles/mc_tls.pem \
+  --tls-key-file=secretfiles/mc_tls.key \
+  --cert-collection-file=secretfiles/reporting_root.pem \
+  --reporting-server-api-target=v2alpha.reporting.dev.halo-cmm.org:8443 \
+  event-groups list \
+  --parent=measurementConsumers/VCTqwV_vFXw
+```