google-apis-core 0.4.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f584978e699dd7b6adbfe8e00ea529199b1b618ff78853027ead245769e1b047
-  data.tar.gz: 27af4c5f3f32b61ce1e7f1c115d4d0f3cc6b2a6fbc819f3b68be276f67beed74
+  metadata.gz: a06abcc898df4624c92e688e9a96df1b80a4672b9a1e3ab571fa050510eb7536
+  data.tar.gz: d52f59c6503a787921c8dee5dacd5c7420daca2d67ead5cdb36fe70974ab7bf2
 SHA512:
-  metadata.gz: 94230bf9e41f4dd4b2b6ab552cbab2759f81e3b9ed7e84220142000dffb53839c9d1d3f20abb125acd35b1d0cb276f80ec9d60cf144955e735037c60b0640f2a
-  data.tar.gz: d4d887b5d423d9f5e4934910e3285e5274a5762095de67ccde4c77516d6a680a45e3a56f8dc774738dc3a08e8047feb6296584d5e48b6937f54e19a77ed3b666
+  metadata.gz: 259dfe34f6d13f9f2381b4cf5c3d88a9aaeb46c954df0dd1b5f3c5029896dbef3853b4a76f5b9c3e79b38cff1c1fbb8a3d205c41824cebe9cdc66f8c0098d421
+  data.tar.gz: f383d03683daabbade354ec14c1708cefe2f5fd58bdee645e2d173d2fb9c95e2e35828750da8b1afd6449256a11374d953e87251cbc176595436fada8a12850d

data/CHANGELOG.md

@@ -1,25 +1,42 @@
 # Release History
 
-## 0.4.1 (2021-07-19)
+### 0.6.0 (2022-06-15)
+
+#### Features
+
+* add few more errors as retriable errors
+
+### 0.5.0 (2022-05-15)
+
+#### Features
+
+* Add support for retry options to be configurable
+
+### 0.4.2 (2022-01-21)
+
+#### Bug Fixes
+
+* Support for max elapsed time configuration.
+
+### 0.4.1 (2021-07-19)
 
 * FIX: Prevent duplicated pagination when a response returns an empty string as the next page token.
 
-## 0.4.0 (2021-06-28)
+### 0.4.0 (2021-06-28)
 
 * Expanded googleauth dependency to include future 1.x versions
 
-## [0.3.0](https://www.github.com/googleapis/google-api-ruby-client/compare/google-apis-core/v0.2.1...v0.3.0) (2021-03-07)
-
-### Features
+### 0.3.0 (2021-03-07)
 
-* Drop support for Ruby 2.4 and add support for Ruby 3.0 ([d871146](https://www.github.com/googleapis/google-api-ruby-client/commit/d871146916f3dd19a12820c03068b3861a4bc879))
+#### Features
 
-### [0.2.1](https://www.github.com/googleapis/google-api-ruby-client/compare/google-apis-core/v0.2.0...v0.2.1) (2021-01-25)
+* Drop support for Ruby 2.4 and add support for Ruby 3.0
 
+### 0.2.1 (2021-01-25)
 
-### Bug Fixes
+#### Bug Fixes
 
-* **core:** Add webrick to the gem dependencies, for Ruby 3 compatibility ([25824f2](https://www.github.com/googleapis/google-api-ruby-client/commit/25824f2512fa96d4d90e220ac038c9b3b2a6a0d1))
+* Add webrick to the gem dependencies, for Ruby 3 compatibility
 
 ### 0.2.0 (2021-01-06)
 

data/OVERVIEW.md

@@ -8,8 +8,8 @@ need to install it by itself.
 
 More detailed descriptions of the Google legacy REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 For reference information on specific calls in the clients, see the {Google::Apis class reference docs}.
 

data/lib/google/apis/core/http_command.rb

@@ -27,7 +27,10 @@ module Google
       class HttpCommand
         include Logging
 
-        RETRIABLE_ERRORS = [Google::Apis::ServerError, Google::Apis::RateLimitError, Google::Apis::TransmissionError]
+        RETRIABLE_ERRORS = [Google::Apis::ServerError,
+                            Google::Apis::RateLimitError,
+                            Google::Apis::TransmissionError,
+                            Google::Apis::RequestTimeOutError]
 
         begin
           require 'opencensus'
@@ -100,8 +103,10 @@ module Google
           opencensus_begin_span
           begin
             Retriable.retriable tries: options.retries + 1,
-                                base_interval: 1,
-                                multiplier: 2,
+                                max_elapsed_time: options.max_elapsed_time,
+                                base_interval: options.base_interval,
+                                max_interval: options.max_interval,
+                                multiplier: options.multiplier,
                                 on: RETRIABLE_ERRORS do |try|
               # This 2nd level retriable only catches auth errors, and supports 1 retry, which allows
               # auth to be re-attempted without having to retry all sorts of other failures like
@@ -223,6 +228,9 @@ module Google
           when 429
             message ||= 'Rate limit exceeded'
             raise Google::Apis::RateLimitError.new(message, status_code: status, header: header, body: body)
+          when 408
+            message ||= 'Request time out'
+            raise Google::Apis::RequestTimeOutError.new(message, status_code: status, header: header, body: body)
           when 304, 400, 402...500
             message ||= 'Invalid request'
             raise Google::Apis::ClientError.new(message, status_code: status, header: header, body: body)
@@ -276,7 +284,7 @@ module Google
             rescue Google::Apis::Error => e
               err = e
             end
-          elsif err.is_a?(HTTPClient::TimeoutError) || err.is_a?(SocketError)
+          elsif err.is_a?(HTTPClient::TimeoutError) || err.is_a?(SocketError) || err.is_a?(HTTPClient::KeepAliveDisconnected) || err.is_a?(Errno::ECONNREFUSED) || err.is_a?(Errno::ETIMEDOUT)
             err = Google::Apis::TransmissionError.new(err)
           end
           block.call(nil, err) if block_given?

data/lib/google/apis/core/version.rb

@@ -16,7 +16,7 @@ module Google
   module Apis
     module Core
       # Core version
-      VERSION = "0.4.1".freeze
+      VERSION = "0.6.0".freeze
     end
   end
 end

data/lib/google/apis/errors.rb

@@ -66,7 +66,11 @@ module Google
     class ClientError < Error
     end
 
-    # A 4xx class HTTP error occurred.
+    # A 408 HTTP error occurred.
+    class RequestTimeOutError < ClientError
+    end
+
+    # A 429 HTTP error occurred.
     class RateLimitError < Error
     end
 

data/lib/google/apis/options.rb

@@ -28,6 +28,10 @@ module Google
     RequestOptions = Struct.new(
       :authorization,
       :retries,
+      :max_elapsed_time,
+      :base_interval,
+      :max_interval,
+      :multiplier,
       :header,
       :normalize_unicode,
       :skip_serialization,
@@ -66,6 +70,15 @@ module Google
       #   @return [Signet::OAuth2::Client, #apply(Hash)] OAuth2 credentials.
       # @!attribute [rw] retries
       #   @return [Fixnum] Number of times to retry requests on server error.
+      # @!attribute [rw] max_elapsed_time
+      #   @return [Fixnum] Total time in seconds that requests are allowed to keep being retried.
+      # @!attribute [rw] base_interval
+      #   @return [Float] The initial interval in seconds between tries.
+      # @!attribute [rw] max_interval
+      #   @return [Fixnum] The maximum interval in seconds that any individual retry can reach.
+      # @!attribute [rw] multiplier
+      #   @return [rw] Each successive interval grows by this factor. A multipler of 1.5 means the next interval 
+      #              will be 1.5x the current interval.
       # @!attribute [rw] header
       #   @return [Hash<String,String>] Additional HTTP headers to include in requests.
       # @!attribute [rw] normalize_unicode
@@ -106,6 +119,10 @@ module Google
     ClientOptions.default.application_version = '0.0.0'
     ClientOptions.default.transparent_gzip_decompression = true
     RequestOptions.default.retries = 0
+    RequestOptions.default.max_elapsed_time = 900
+    RequestOptions.default.base_interval = 1
+    RequestOptions.default.max_interval = 60
+    RequestOptions.default.multiplier = 2
     RequestOptions.default.normalize_unicode = false
     RequestOptions.default.skip_serialization = false
     RequestOptions.default.skip_deserialization = false

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-core
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-20 00:00:00.000000000 Z
+date: 2022-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: representable
@@ -183,9 +183,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/google-apis-core/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-core/v0.4.1
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/google-apis-core
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-core/v0.6.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -201,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: Common utility and base classes for legacy Google REST clients