google-cloud-service_directory-v1 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc43248af4aa3edaec0ee4ab8350748ff36fa451e376754820213ebfa61b72c3
-  data.tar.gz: f81f89316aa19cc9803179f15f582c60a14abed040516f662877c51dae9c41ae
+  metadata.gz: eb7347a1fe5c67d04d998a4266ffbda679f9c694f33ff7a2d0d7c24220930b1a
+  data.tar.gz: b0f5b0db819fbdf152ff72716242f0932869da6d4defe662c61c89fe7a01cd42
 SHA512:
-  metadata.gz: 208fa1bf6c2b833d5ecf5afd9eb2ffc5641775fb33db4315cad569cc0e1c9753c9691c4e20162807cc4151bfa2fa6242b2aca12de3475f69024e2ac8d27bf32f
-  data.tar.gz: b9f1991c063d88d25488a1ed4ecd325d9ec49da864ab3477b05ff3cadd694987dde146b5f0e65af5a71b9490c6a00a563511216e574dc48119a6f81e199c0d7e
+  metadata.gz: 4baabb7351990bfae900bac4402d4c05ee3432c7aaf480270945fcc11dc2c4a9fdefe41be51870e9cdbca80492a42b8716c4afabc519e95ffc7b8ae925113a53
+  data.tar.gz: da32f7379aa9d81c103cd4eeffbc11ca60399e901a8ea9976e86ca9a5dad6f608b661aeb95451910b48e9ac195af35e922d947fb318c7fd32529eb6081ae7473

data/lib/google/cloud/service_directory/v1/bindings_override.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/config"
+
+module Google
+  module Cloud
+    module ServiceDirectory
+      ##
+      # @example Loading just the REST part of this package, including all its services, and instantiating a REST client
+      #
+      #     require "google/cloud/service_directory/v1/rest"
+      #     client = ::Google::Cloud::ServiceDirectory::V1::LookupService::Rest::Client.new
+      #
+      module V1
+        ##
+        # @private
+        # Initialize the mixin bindings configuration
+        #
+        def self.configure
+          @configure ||= begin
+            namespace = ["Google", "Cloud", "ServiceDirectory"]
+            parent_config = while namespace.any?
+                              parent_name = namespace.join "::"
+                              parent_const = const_get parent_name
+                              break parent_const.configure if parent_const.respond_to? :configure
+                              namespace.pop
+                            end
+
+            default_config = Configuration.new parent_config
+            default_config.bindings_override["google.cloud.location.Locations.GetLocation"] = [
+              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
+                uri_method: :get,
+                uri_template: "/v1/{name}",
+                matches: [
+                  ["name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
+                ],
+                body: nil
+              )
+            ]
+            default_config.bindings_override["google.cloud.location.Locations.ListLocations"] = [
+
+              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
+                uri_method: :get,
+                uri_template: "/v1/{name}/locations",
+                matches: [
+                  ["name", %r{^projects/[^/]+/?$}, false]
+                ],
+                body: nil
+              )
+            ]
+            default_config
+          end
+          yield @configure if block_given?
+          @configure
+        end
+
+        ##
+        # @private
+        # Configuration class for the google.cloud.servicedirectory.v1 package.
+        #
+        # This class contains common configuration for all services
+        # of the google.cloud.servicedirectory.v1 package.
+        #
+        # This configuration is for internal use of the client library classes,
+        # and it is not intended that the end-users will read or change it.
+        #
+        class Configuration
+          extend ::Gapic::Config
+
+          # @private
+          # Overrides for http bindings for the RPC of the mixins for this package.
+          # Services in this package should use these when creating clients for the mixin services.
+          # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+          config_attr :bindings_override, {}, ::Hash, nil
+
+          # @private
+          def initialize parent_config = nil
+            @parent_config = parent_config unless parent_config.nil?
+
+            yield self if block_given?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/service_directory/v1/lookup_service/client.rb

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/servicedirectory/v1/lookup_service_pb"
+require "google/cloud/location"
 
 module Google
   module Cloud
@@ -138,6 +139,12 @@ module Google
               @quota_project_id = @config.quota_project
               @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @lookup_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::ServiceDirectory::V1::LookupService::Stub,
                 credentials:  credentials,
@@ -147,6 +154,13 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
             # Service calls
 
             ##
@@ -178,22 +192,40 @@ module Google
             #   @param endpoint_filter [::String]
             #     Optional. The filter applied to the endpoints of the resolved service.
             #
-            #     General filter string syntax:
-            #     <field> <operator> <value> (<logical connector>)
-            #     <field> can be "name" or "metadata.<key>" for map field.
-            #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS and is
-            #     roughly the same as "=".
-            #     <value> must be the same data type as the field.
-            #     <logical connector> can be "AND, OR, NOT".
+            #     General `filter` string syntax:
+            #     `<field> <operator> <value> (<logical connector>)`
+            #
+            #     *   `<field>` can be `name`, `address`, `port`, or `annotations.<key>` for
+            #         map field
+            #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+            #         means `HAS`, and is roughly the same as `=`
+            #     *   `<value>` must be the same data type as field
+            #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
             #
             #     Examples of valid filters:
-            #     * "metadata.owner" returns Endpoints that have a label with the
-            #       key "owner", this is the same as "metadata:owner"
-            #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-            #       "protocol=gRPC"
-            #     * "metadata.owner!=sd AND metadata.foo=bar" returns
-            #       Endpoints that have "owner" field in metadata with a value that is not
-            #       "sd" AND have the key/value foo=bar.
+            #
+            #     *   `annotations.owner` returns endpoints that have a annotation with the
+            #         key `owner`, this is the same as `annotations:owner`
+            #     *   `annotations.protocol=gRPC` returns endpoints that have key/value
+            #         `protocol=gRPC`
+            #     *   `address=192.108.1.105` returns endpoints that have this address
+            #     *   `port>8080` returns endpoints that have port number larger than 8080
+            #     *
+            #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+            #         returns endpoints that have name that is alphabetically later than the
+            #         string, so "endpoint-e" is returned but "endpoint-a" is not
+            #     *
+            #     `name=projects/my-project/locations/us-central1/namespaces/my-namespace/services/my-service/endpoints/ep-1`
+            #          returns the endpoint that has an endpoint_id equal to `ep-1`
+            #     *   `annotations.owner!=sd AND annotations.foo=bar` returns endpoints that
+            #         have `owner` in annotation key but value is not `sd` AND have
+            #         key/value `foo=bar`
+            #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+            #         doesn't have a field called "doesnotexist". Since the filter does not
+            #         match any endpoint, it returns no results
+            #
+            #     For more information about filtering, see
+            #     [API Filtering](https://aip.dev/160).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::ServiceDirectory::V1::ResolveServiceResponse]

data/lib/google/cloud/service_directory/v1/lookup_service/rest/client.rb

@@ -19,6 +19,7 @@
 require "google/cloud/errors"
 require "google/cloud/servicedirectory/v1/lookup_service_pb"
 require "google/cloud/service_directory/v1/lookup_service/rest/service_stub"
+require "google/cloud/location/rest"
 
 module Google
   module Cloud
@@ -135,9 +136,23 @@ module Google
                 @quota_project_id = @config.quota_project
                 @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+                @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
+                  config.credentials = credentials
+                  config.quota_project = @quota_project_id
+                  config.endpoint = @config.endpoint
+                  config.bindings_override = @config.bindings_override
+                end
+
                 @lookup_service_stub = ::Google::Cloud::ServiceDirectory::V1::LookupService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
               end
 
+              ##
+              # Get the associated client for mix-in of the Locations.
+              #
+              # @return [Google::Cloud::Location::Locations::Rest::Client]
+              #
+              attr_reader :location_client
+
               # Service calls
 
               ##
@@ -169,22 +184,40 @@ module Google
               #   @param endpoint_filter [::String]
               #     Optional. The filter applied to the endpoints of the resolved service.
               #
-              #     General filter string syntax:
-              #     <field> <operator> <value> (<logical connector>)
-              #     <field> can be "name" or "metadata.<key>" for map field.
-              #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS and is
-              #     roughly the same as "=".
-              #     <value> must be the same data type as the field.
-              #     <logical connector> can be "AND, OR, NOT".
+              #     General `filter` string syntax:
+              #     `<field> <operator> <value> (<logical connector>)`
+              #
+              #     *   `<field>` can be `name`, `address`, `port`, or `annotations.<key>` for
+              #         map field
+              #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+              #         means `HAS`, and is roughly the same as `=`
+              #     *   `<value>` must be the same data type as field
+              #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
               #
               #     Examples of valid filters:
-              #     * "metadata.owner" returns Endpoints that have a label with the
-              #       key "owner", this is the same as "metadata:owner"
-              #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-              #       "protocol=gRPC"
-              #     * "metadata.owner!=sd AND metadata.foo=bar" returns
-              #       Endpoints that have "owner" field in metadata with a value that is not
-              #       "sd" AND have the key/value foo=bar.
+              #
+              #     *   `annotations.owner` returns endpoints that have a annotation with the
+              #         key `owner`, this is the same as `annotations:owner`
+              #     *   `annotations.protocol=gRPC` returns endpoints that have key/value
+              #         `protocol=gRPC`
+              #     *   `address=192.108.1.105` returns endpoints that have this address
+              #     *   `port>8080` returns endpoints that have port number larger than 8080
+              #     *
+              #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+              #         returns endpoints that have name that is alphabetically later than the
+              #         string, so "endpoint-e" is returned but "endpoint-a" is not
+              #     *
+              #     `name=projects/my-project/locations/us-central1/namespaces/my-namespace/services/my-service/endpoints/ep-1`
+              #          returns the endpoint that has an endpoint_id equal to `ep-1`
+              #     *   `annotations.owner!=sd AND annotations.foo=bar` returns endpoints that
+              #         have `owner` in annotation key but value is not `sd` AND have
+              #         key/value `foo=bar`
+              #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+              #         doesn't have a field called "doesnotexist". Since the filter does not
+              #         match any endpoint, it returns no results
+              #
+              #     For more information about filtering, see
+              #     [API Filtering](https://aip.dev/160).
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::ServiceDirectory::V1::ResolveServiceResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -315,6 +348,13 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
 
+                # @private
+                # Overrides for http bindings for the RPCs of this service
+                # are only used when this service is used as mixin, and only
+                # by the host service.
+                # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+                config_attr :bindings_override, {}, ::Hash, nil
+
                 # @private
                 def initialize parent_config = nil
                   @parent_config = parent_config unless parent_config.nil?

data/lib/google/cloud/service_directory/v1/lookup_service/rest.rb

@@ -21,6 +21,7 @@ require "gapic/config"
 require "gapic/config/method"
 
 require "google/cloud/service_directory/v1/version"
+require "google/cloud/service_directory/v1/bindings_override"
 
 require "google/cloud/service_directory/v1/lookup_service/credentials"
 require "google/cloud/service_directory/v1/lookup_service/paths"