google-cloud-bigquery-storage 1.8.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c58e461e3e942e97ff2847e68fedde5ddb4e401b21a369a93d77119ee58a86b
-  data.tar.gz: cb9e8f658df745037115a9ab61c04b444feb81ed745b431869ef0497e422d271
+  metadata.gz: 7dd885471edaacb7b32523e9e91a5dc2fb62a9218933a4db78adf1be200a5e84
+  data.tar.gz: 7993b1c5f7ba9baf8d7b8b6733b442dbc346c75be90fb59a0a6a294568d65d7d
 SHA512:
-  metadata.gz: c53b85c7ea1fecfc179e0e5552480373ec45062e88036fed3ad411cba9f6ab01bd05f8394c8746646526abade9496ce66037ec81749404cf997302f2fbc6972d
-  data.tar.gz: ef2ae99848b2b918f3494f89b7e94c4ce9b927eeae66410cc9ee46368245803b0d4a537ed5721ed03cca827a9dcbbce1512d131a32bf20f9c4be5b24784c7455
+  metadata.gz: cb3a3ee4631dc69d3373c7e92a966d711a3cc64df44296a23bed1c9776cd04afc2a190c03b55da2d842321cbaca7f23286d37852c694913759cdab7cf8429c73
+  data.tar.gz: 80c8e0be51682c868b2b1fe9490241a7637189fe2ca6b1250df3389bedbbad55c9104291a61bccf5f0a92a9f75dd618decfe65400a340858f7bb303098b3defa

data/README.md

@@ -2,7 +2,7 @@
 
 API Client library for the BigQuery Storage API
 
-The BigQuery Storage API provides fast access to BigQuery managed storage.
+google-cloud-bigquery-storage is the official client library for the BigQuery Storage API.
 
 Actual client classes for the various versions of this API are defined in
 _versioned_ client gems, with names of the form `google-cloud-bigquery-storage-v*`.
@@ -18,7 +18,7 @@ themselves can be found in the client library documentation for the versioned
 client gems:
 [google-cloud-bigquery-storage-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-bigquery-storage-v1/latest).
 
-See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/storage)
+See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/storage/)
 for more usage information.
 
 ## Quick Start
@@ -76,12 +76,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/bigquery/storage/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Bigquery
       module Storage
-        VERSION = "1.8.1"
+        VERSION = "1.9.0"
       end
     end
   end

data/lib/google/cloud/bigquery/storage.rb

@@ -56,9 +56,11 @@ module Google
         # `version` parameter. If the BigQueryRead 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 BigQueryRead service.
+        # given API version does not support the given transport of the BigQueryRead service.
         # You can determine whether the method will succeed by calling
         # {Google::Cloud::Bigquery::Storage.big_query_read_available?}.
         #
@@ -70,9 +72,10 @@ module Google
         #
         # @param version [::String, ::Symbol] The API version to connect to. Optional.
         #   Defaults to `:v1`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         # @return [::Object] A client object for the specified version.
         #
-        def self.big_query_read version: :v1, &block
+        def self.big_query_read version: :v1, transport: :grpc, &block
           require "google/cloud/bigquery/storage/#{version.to_s.downcase}"
 
           package_name = Google::Cloud::Bigquery::Storage
@@ -80,6 +83,7 @@ module Google
                          .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                          .first
           service_module = Google::Cloud::Bigquery::Storage.const_get(package_name).const_get(:BigQueryRead)
+          service_module = service_module.const_get(:Rest) if transport == :rest
           service_module.const_get(:Client).new(&block)
         end
 
@@ -92,9 +96,10 @@ module Google
         #
         # @param version [::String, ::Symbol] The API version to connect to. Optional.
         #   Defaults to `:v1`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         # @return [boolean] Whether the service is available.
         #
-        def self.big_query_read_available? version: :v1
+        def self.big_query_read_available? version: :v1, transport: :grpc
           require "google/cloud/bigquery/storage/#{version.to_s.downcase}"
           package_name = Google::Cloud::Bigquery::Storage
                          .constants
@@ -104,6 +109,10 @@ module Google
           service_module = Google::Cloud::Bigquery::Storage.const_get package_name
           return false unless service_module.const_defined? :BigQueryRead
           service_module = service_module.const_get :BigQueryRead
+          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
@@ -119,9 +128,11 @@ module Google
         # `version` parameter. If the BigQueryWrite 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 BigQueryWrite service.
+        # given API version does not support the given transport of the BigQueryWrite service.
         # You can determine whether the method will succeed by calling
         # {Google::Cloud::Bigquery::Storage.big_query_write_available?}.
         #
@@ -136,9 +147,10 @@ module Google
         #
         # @param version [::String, ::Symbol] The API version to connect to. Optional.
         #   Defaults to `:v1`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         # @return [::Object] A client object for the specified version.
         #
-        def self.big_query_write version: :v1, &block
+        def self.big_query_write version: :v1, transport: :grpc, &block
           require "google/cloud/bigquery/storage/#{version.to_s.downcase}"
 
           package_name = Google::Cloud::Bigquery::Storage
@@ -146,6 +158,7 @@ module Google
                          .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                          .first
           service_module = Google::Cloud::Bigquery::Storage.const_get(package_name).const_get(:BigQueryWrite)
+          service_module = service_module.const_get(:Rest) if transport == :rest
           service_module.const_get(:Client).new(&block)
         end
 
@@ -158,9 +171,10 @@ module Google
         #
         # @param version [::String, ::Symbol] The API version to connect to. Optional.
         #   Defaults to `:v1`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         # @return [boolean] Whether the service is available.
         #
-        def self.big_query_write_available? version: :v1
+        def self.big_query_write_available? version: :v1, transport: :grpc
           require "google/cloud/bigquery/storage/#{version.to_s.downcase}"
           package_name = Google::Cloud::Bigquery::Storage
                          .constants
@@ -170,6 +184,10 @@ module Google
           service_module = Google::Cloud::Bigquery::Storage.const_get package_name
           return false unless service_module.const_defined? :BigQueryWrite
           service_module = service_module.const_get :BigQueryWrite
+          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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-storage
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.0
 platform: ruby
 authors:
 - Google LLC
@@ -43,7 +43,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.6'
-description: The BigQuery Storage API provides fast access to BigQuery managed storage.
+description: google-cloud-bigquery-storage is the official client library for the
+  BigQuery Storage API.
 email: googleapis-packages@google.com
 executables: []
 extensions: []