cleanup: move google/cloud/examples/ to examples/ (#9304)

We decided to separate the libraries from the examples that use more
than one library.

CMakeLists.txt

@@ -362,7 +362,7 @@ if (GOOGLE_CLOUD_CPP_ENABLE_EXAMPLES
     AND iam IN_LIST GOOGLE_CLOUD_CPP_ENABLE
     AND spanner IN_LIST GOOGLE_CLOUD_CPP_ENABLE
     AND storage IN_LIST GOOGLE_CLOUD_CPP_ENABLE)
-    add_subdirectory(google/cloud/examples)
+    add_subdirectory(examples)
 endif ()
 
 # Obsolete / retired flags and options. Removing them just cleans up a bit of

ci/cloudbuild/builds/coverage.sh

@@ -26,15 +26,15 @@ export CXX=g++
 # Explicitly list the patterns that match hand-crafted code. Excluding the
 # generated code results in a longer list and more maintenance.
 instrumented_patterns=(
+  "/examples[/:]"
+  "/generator[/:]"
   "/google/cloud:"
   "/google/cloud/testing_util:"
   "/google/cloud/bigtable[/:]"
-  "/google/cloud/examples[/:]"
   "/google/cloud/pubsub[/:]"
   "/google/cloud/pubsublite[/:]"
   "/google/cloud/spanner[/:]"
   "/google/cloud/storage[/:]"
-  "/generator[/:]"
 )
 instrumentation_filter="$(printf ",%s" "${instrumented_patterns[@]}")"
 instrumentation_filter="${instrumentation_filter:1}"

ci/cloudbuild/builds/integration-production.sh

@@ -29,10 +29,10 @@ mapfile -t args < <(bazel::common_args)
 bazel test "${args[@]}" --test_tag_filters=-integration-test ...
 
 excluded_rules=(
+  "-//examples:grpc_credential_types"
   "-//google/cloud/bigtable/examples:bigtable_grpc_credentials"
   "-//google/cloud/storage/examples:storage_service_account_samples"
   "-//google/cloud/storage/tests:service_account_integration_test"
-  "-//google/cloud/examples:grpc_credential_types"
   "-//google/cloud/storage/tests:grpc_integration_test"
 )
 

ci/cloudbuild/builds/lib/integration.sh

@@ -216,7 +216,7 @@ function integration::bazel_with_emulators() {
     "--test_env=GOOGLE_CLOUD_CPP_TEST_HELLO_WORLD_HTTP_URL=${hello_world_http}" \
     "--test_env=GOOGLE_CLOUD_CPP_TEST_HELLO_WORLD_GRPC_URL=${hello_world_grpc}" \
     "--test_env=GOOGLE_CLOUD_CPP_TEST_HELLO_WORLD_SERVICE_ACCOUNT=${GOOGLE_CLOUD_CPP_TEST_HELLO_WORLD_SERVICE_ACCOUNT}" \
-    //google/cloud/examples/...
+    //examples/...
 
   local bazel_output_base
   if echo "${args[@]}" | grep -w -q -- "--config=msan"; then

cmake/GoogleCloudCppCommon.cmake

@@ -68,7 +68,7 @@ elseif (GOOGLE_CLOUD_CPP_GENERATE_DOXYGEN)
         # found here
         "${PROJECT_BINARY_DIR}/external/googleapis"
         # Proto files generated by the examples are found here
-        "${PROJECT_BINARY_DIR}/google/cloud/examples"
+        "${PROJECT_BINARY_DIR}/examples"
         # Any additional includes that the library needs
         ${GOOGLE_CLOUD_CPP_DOXYGEN_EXTRA_INCLUDES})
     set(DOXYGEN_GENERATE_LATEX NO)

google/cloud/examples/BUILD.bazel → examples/BUILD.bazel

@@ -81,7 +81,7 @@ cc_test(
     timeout = "long",
     srcs = ["grpc_credential_types.cc"],
     copts = [
-        "-I$(GENDIR)/google/cloud/examples",
+        "-I$(GENDIR)/examples",
     ],
     tags = [
         "integration-test",

google/cloud/examples/README.md → examples/README.md

@@ -20,8 +20,8 @@ We use Docker to create an image with our "Greeter" service:
 
 ```shell
 docker build -t "gcr.io/${GOOGLE_CLOUD_PROJECT}/hello-world-grpc:latest" \
-    -f google/cloud/examples/hello_world_grpc/Dockerfile \
-    google/cloud/examples/hello_world_grpc
+    -f examples/hello_world_grpc/Dockerfile \
+    examples/hello_world_grpc
 ```
 
 ### Push the Docker image to GCR
@@ -95,7 +95,7 @@ and use it from Cloud Run.
 pack build  --builder gcr.io/buildpacks/builder:latest \
      --env "GOOGLE_FUNCTION_SIGNATURE_TYPE=http" \
      --env "GOOGLE_FUNCTION_TARGET=HelloWorldHttp" \
-     --path "google/cloud/examples/hello_world_http/" \
+     --path "examples/hello_world_http/" \
      "gcr.io/${GOOGLE_CLOUD_PROJECT}/hello-world-http"
 ```