google-cloud-functions-v1 0.8.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f78939bfbf642e23e782ed4e8171f899728147d9f2def093781a83926d57c900
-  data.tar.gz: ca6f1a60ff26a62072bfb7e564c60439bbef97e2b96d557bd72a7ded9759c8bc
+  metadata.gz: 133bdb41fa5847f2a169ab5b0b744c7c953c16d0b3cf8be94f797b5aad70db2c
+  data.tar.gz: 7b3d55d42cfe0df7b29ae045405dd806cff0dc9370db1c9015bc7d75de8fd06d
 SHA512:
-  metadata.gz: 157bf1a5cdc4e61d1c604bd59cc4fbd56612ca56148bdd402bfaada08abd349656b3252e1997dc6f56e1fab3537bb17d9460b2db57bee53da7218b49a0178cd1
-  data.tar.gz: 2085b5381bbbb694306412f652dd3e19c669835a3cb92422ed512216c951a1e3987dbb0be239ed77d33c345e0b5e65d659cb6af39d31804a713bc40dd5a07f18
+  metadata.gz: 21ac38859d881bcbfb5cccc6c377e5fc3de1c7bbd2f27058831a316c03e8072eaf1d298114c8f957d89abf9fd95754c140ab16bca3bef4dcbbaaf868e76f6148
+  data.tar.gz: eb2d5c20d73f555e73be0109a03b9b6e18b6b0cc7479ff9b7c1b6d297e7a05282c71c88d6ec5d93249716532257a441f0c6f7b02cde8f909bf06af6a1529d1db

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud Functions V1 API
 
-API Client library for the Cloud Functions V1 API
+Manages lightweight user-provided functions executed in response to events.
 
 The Cloud Functions API manages lightweight user-provided functions executed in response to events.
 
@@ -47,7 +47,7 @@ for general usage information.
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

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

@@ -0,0 +1,91 @@
+# 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 Functions
+      ##
+      # @example Loading just the REST part of this package, including all its services, and instantiating a REST client
+      #
+      #     require "google/cloud/functions/v1/rest"
+      #     client = ::Google::Cloud::Functions::V1::CloudFunctionsService::Rest::Client.new
+      #
+      module V1
+        ##
+        # @private
+        # Initialize the mixin bindings configuration
+        #
+        def self.configure
+          @configure ||= begin
+            namespace = ["Google", "Cloud", "Functions"]
+            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.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.functions.v1 package.
+        #
+        # This class contains common configuration for all services
+        # of the google.cloud.functions.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/functions/v1/cloud_functions_service/client.rb

@@ -18,6 +18,8 @@
 
 require "google/cloud/errors"
 require "google/cloud/functions/v1/functions_pb"
+require "google/cloud/location"
+require "google/iam/v1"
 
 module Google
   module Cloud
@@ -163,6 +165,18 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
+              @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @cloud_functions_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Functions::V1::CloudFunctionsService::Stub,
                 credentials:  credentials,
@@ -179,6 +193,20 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
+            ##
+            # Get the associated client for mix-in of the IAMPolicy.
+            #
+            # @return [Google::Iam::V1::IAMPolicy::Client]
+            #
+            attr_reader :iam_policy_client
+
             # Service calls
 
             ##
@@ -370,7 +398,7 @@ module Google
 
             ##
             # Creates a new function. If a function with the given name already exists in
-            # the specified project, the long running operation will return
+            # the specified project, the long running operation returns an
             # `ALREADY_EXISTS` error.
             #
             # @overload create_function(request, options = nil)
@@ -389,8 +417,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param location [::String]
-            #     Required. The project and location in which the function should be created, specified
-            #     in the format `projects/*/locations/*`
+            #     Required. The project and location in which the function should be created,
+            #     specified in the format `projects/*/locations/*`
             #   @param function [::Google::Cloud::Functions::V1::CloudFunction, ::Hash]
             #     Required. Function to be created.
             #
@@ -563,7 +591,7 @@ module Google
 
             ##
             # Deletes a function with the given name from the specified project. If the
-            # given function is used by some trigger, the trigger will be updated to
+            # given function is used by some trigger, the trigger is updated to
             # remove this function.
             #
             # @overload delete_function(request, options = nil)
@@ -764,12 +792,12 @@ module Google
             #   attached, the identity from the credentials would be used, but that
             #   identity does not have permissions to upload files to the URL.
             #
-            # When making a HTTP PUT request, these two headers need to be specified:
+            # When making an HTTP PUT request, these two headers must be specified:
             #
             # * `content-type: application/zip`
             # * `x-goog-content-length-range: 0,104857600`
             #
-            # And this header SHOULD NOT be specified:
+            # And this header must NOT be specified:
             #
             # * `Authorization: Bearer YOUR_TOKEN`
             #
@@ -876,9 +904,9 @@ module Google
 
             ##
             # Returns a signed URL for downloading deployed function source code.
-            # The URL is only valid for a limited period and should be used within
+            # The URL is only valid for a limited period and must be used within
             # minutes after generation.
-            # For more information about the signed URL usage see:
+            # For more information about the signed URL usage, see:
             # https://cloud.google.com/storage/docs/access-control/signed-urls
             #
             # @overload generate_download_url(request, options = nil)
@@ -1159,7 +1187,7 @@ module Google
             ##
             # Tests the specified permissions against the IAM access control policy
             # for a function.
-            # If the function does not exist, this will return an empty set of
+            # If the function does not exist, this returns an empty set of
             # permissions, not a NOT_FOUND error.
             #
             # @overload test_iam_permissions(request, options = nil)
@@ -1288,9 +1316,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/functions/v1/cloud_functions_service/operations.rb

@@ -612,9 +612,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials