api/tools: Shift validation script to bazel (#41775)

Signed-off-by: Ryan Northey <[email protected]>

Author: phlax

ci/do_ci.sh

@@ -194,7 +194,7 @@ function bazel_envoy_api_build() {
         --//tools/api_proto_plugin:extra_args=api_version:3.7 \
         //tools/protoprint:protoprint_test
     echo "Validating API structure..."
-    "${ENVOY_SRCDIR}"/tools/api/validate_structure.py
+    bazel run "${BAZEL_BUILD_OPTIONS[@]}" //tools/api:validate_structure "${PWD}/api/envoy"
     echo "Testing API..."
     bazel_with_collection \
         test "${BAZEL_BUILD_OPTIONS[@]}" \

tools/api/BUILD

@@ -0,0 +1,9 @@
+load("@rules_python//python:defs.bzl", "py_binary")
+
+licenses(["notice"])  # Apache 2
+
+py_binary(
+    name = "validate_structure",
+    srcs = ["validate_structure.py"],
+    # deps = [":validate"],
+)

tools/api/validate_structure.py

@@ -4,6 +4,7 @@
 #
 # ./tools/api/validate_structure.py
 
+import argparse
 import pathlib
 import re
 import sys
@@ -77,12 +78,18 @@ def validate_proto_paths(proto_paths):
     return error_msgs
 
 
-if __name__ == '__main__':
-    api_root = 'api/envoy'
-    api_protos = pathlib.Path(api_root).rglob('*.proto')
-    error_msgs = validate_proto_paths(p.relative_to(api_root) for p in api_protos)
+def main(*args):
+    parser = argparse.ArgumentParser(description="Check API structure.")
+    parser.add_argument("api_root", type=str, help="Specify the path to the api root.")
+    args = parser.parse_args(args)
+    api_protos = pathlib.Path(args.api_root).rglob('*.proto')
+    error_msgs = validate_proto_paths(p.relative_to(args.api_root) for p in api_protos)
     if error_msgs:
         for m in error_msgs:
             print(m)
         sys.exit(1)
     sys.exit(0)
+
+
+if __name__ == '__main__':
+    main(*sys.argv[1:])