google-cloud-service_directory-v1 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b65e971f67d733d365f1bc416763d3c39cccc62a9ffc5c44c008e27294d32f04
-  data.tar.gz: f87388da9ef3283e42c8a852376e45d97ebaeea13bc0b3fcc3662a7177e87b8b
+  metadata.gz: eb7347a1fe5c67d04d998a4266ffbda679f9c694f33ff7a2d0d7c24220930b1a
+  data.tar.gz: b0f5b0db819fbdf152ff72716242f0932869da6d4defe662c61c89fe7a01cd42
 SHA512:
-  metadata.gz: 0b02fea76e236f99dadd271bc11450fc6a484d0621789a99e6aaf5495315b94f625dd6255cdda8ab3a7964cbc316fd0fbeca9cc9278eba88a75d62a58140382f
-  data.tar.gz: 9c452ac4f0f2252e061d78beb61576821ec49d6dae3658ecec08188d2eb1d66c31578af22995dfed37e76ffbac359f606cd09a3e92fbfebc5bf554cdddb6ea67
+  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
@@ -128,7 +129,7 @@ module Google
               credentials = @config.credentials
               # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -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]
@@ -341,7 +373,9 @@ module Google
             class Configuration
               extend ::Gapic::Config
 
-              config_attr :endpoint,      "servicedirectory.googleapis.com", ::String
+              DEFAULT_ENDPOINT = "servicedirectory.googleapis.com"
+
+              config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
               config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC

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
@@ -124,7 +125,7 @@ module Google
                 credentials = @config.credentials
                 # Use self-signed JWT if the endpoint is unchanged from default,
                 # but only if the default endpoint does not have a region prefix.
-                enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
+                enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
                                          !@config.endpoint.split(".").first.include?("-")
                 credentials ||= Credentials.default scope: @config.scope,
                                                     enable_self_signed_jwt: enable_self_signed_jwt
@@ -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]
@@ -300,7 +333,9 @@ module Google
               class Configuration
                 extend ::Gapic::Config
 
-                config_attr :endpoint,      "servicedirectory.googleapis.com", ::String
+                DEFAULT_ENDPOINT = "servicedirectory.googleapis.com"
+
+                config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
                 config_attr :credentials,   nil do |value|
                   allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                   allowed.any? { |klass| klass === value }
@@ -313,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/service_stub.rb

@@ -59,7 +59,7 @@ module Google
 
                 verb, uri, query_string_params, body = ServiceStub.transcode_resolve_service_request request_pb
                 query_string_params = if query_string_params.any?
-                                        query_string_params.to_h { |p| p.split("=", 2) }
+                                        query_string_params.to_h { |p| p.split "=", 2 }
                                       else
                                         {}
                                       end

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"