google-cloud-run-client 1.8.1 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef1eea220b0e256778176a86fc5abac4f45487800660df8301d360baec324f81
-  data.tar.gz: 313f5fec35ef89d1b5506b600ed00481640868cadc030d6bebcb999ef3014166
+  metadata.gz: 2add445f96e1b7d8542e8b298a980e9bf0ca946c64ca4e1dbbd3a1d527d37bb0
+  data.tar.gz: 29a43c276152b706df4d5c79ee713457864e06e58886083fadb72172af263b73
 SHA512:
-  metadata.gz: a85b28588f8b4c14800d9c8d0691d7985ca0925cc43aec1cb610b48f0e508ab7d3700be87b4de39db039fb6729399ff6752d0662b89d20b34ddd3eab7fb3ed0a
-  data.tar.gz: 0c299d5363a209d9d8fab528fdbd002cd32748ff7b29e202f5a9c353bee975b3d9a94e3a36023b529ebfdc9bc354ce1aa16c3af42d55a2edc60989d845b1b569
+  metadata.gz: 529698bdb4cf29271db8d27f3ae627a6ae0f0dadabffa788ee4492eeb15753be691a18b12fb92df8d372cbfb3e394d967c690e570e1a56ad7f2527818d3268dd
+  data.tar.gz: e20fe9c86d8ae3c722f09abba1fc50311ed96cf81103621b8b3244ee30d3e5577d9f2c800fee745d83943040aaadabc26775919420602e18c3f080dfb90c0c7b

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title="Cloud Run API"
+--title="Cloud Run Admin API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/README.md

@@ -1,8 +1,7 @@
-# Ruby Client for the Cloud Run API
+# Ruby Client for the Cloud Run Admin API
 
-API Client library for the Cloud Run API
+Deploy and manage user provided container images that scale automatically based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving API specification, while v2 is aligned with Google Cloud AIP-based API standards, as described in https://google.aip.dev/.
 
-Cloud Run deploys and manages user provided container images that scale automatically based on incoming requests.
 
 Actual client classes for the various versions of this API are defined in
 _versioned_ client gems, with names of the form `google-cloud-run-v*`.
@@ -18,9 +17,6 @@ themselves can be found in the client library documentation for the versioned
 client gems:
 [google-cloud-run-v2](https://cloud.google.com/ruby/docs/reference/google-cloud-run-v2/latest).
 
-See also the [Product Documentation](https://cloud.google.com/run)
-for more usage information.
-
 ## Quick Start
 
 ```
@@ -76,12 +72,10 @@ working, try updating the versioned clients in your bundle or installed gems:
 
 This library is supported on Ruby 3.2+.
 
-Google provides official support for Ruby versions that are actively supported
-by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Older versions of Ruby _may_
-still work, but are unsupported and not recommended. See
-https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
-support schedule.
+Google provides official support for Ruby versions as described in the
+[Supported Ruby versions](https://docs.cloud.google.com/ruby/getting-started/supported-ruby-versions)
+policy. Older versions of Ruby _may_ still work, but are unsupported and not
+recommended.
 
 ## Which client should I use?
 

data/lib/google/cloud/run/client/version.rb

@@ -18,7 +18,7 @@ module Google
   module Cloud
     module Run
       module Client
-        VERSION = "1.8.1"
+        VERSION = "1.10.0"
       end
     end
   end

data/lib/google/cloud/run.rb

@@ -465,6 +465,77 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for SourceUpload.
+      #
+      # By default, this returns an instance of
+      # [Google::Cloud::Run::V2::SourceUpload::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-run-v2/latest/Google-Cloud-Run-V2-SourceUpload-Client)
+      # for a gRPC client for version V2 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the SourceUpload service is
+      # supported by that API version, and the corresponding gem is available, the
+      # appropriate versioned client will be returned.
+      # You can also specify a different transport by passing `:rest` or `:grpc` in
+      # the `transport` parameter.
+      #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the given transport of the SourceUpload service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Cloud::Run.source_upload_available?}.
+      #
+      # ## About SourceUpload
+      #
+      # The Cloud Run Source Upload API allows you to upload source code to deploy
+      # Cloud Run resources.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v2`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.source_upload version: :v2, transport: :grpc, &block
+        require "google/cloud/run/#{version.to_s.downcase}"
+
+        package_name = Google::Cloud::Run
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        service_module = Google::Cloud::Run.const_get(package_name).const_get(:SourceUpload)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the SourceUpload service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::Run.source_upload}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the SourceUpload service,
+      # or if the versioned client gem needs an update to support the SourceUpload service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v2`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.source_upload_available? version: :v2, transport: :grpc
+        require "google/cloud/run/#{version.to_s.downcase}"
+        package_name = Google::Cloud::Run
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Cloud::Run.const_get package_name
+        return false unless service_module.const_defined? :SourceUpload
+        service_module = service_module.const_get :SourceUpload
+        if transport == :rest
+          return false unless service_module.const_defined? :Rest
+          service_module = service_module.const_get :Rest
+        end
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for Tasks.
       #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-run-client
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.10.0
 platform: ruby
 authors:
 - Google LLC
@@ -43,8 +43,10 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
-description: Cloud Run deploys and manages user provided container images that scale
-  automatically based on incoming requests.
+description: Deploy and manage user provided container images that scale automatically
+  based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving
+  API specification, while v2 is aligned with Google Cloud AIP-based API standards,
+  as described in https://google.aip.dev/.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -77,5 +79,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: API Client library for the Cloud Run API
+summary: Deploy and manage user provided container images that scale automatically
+  based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving
+  API specification, while v2 is aligned with Google Cloud AIP-based API standards,
+  as described in https://google.aip.dev/.
 test_files: []