google-apis-core 1.3.2 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e8ec145745bfbe87e1747980fcb94d965c85129a0d44aa4e04fe308c263a508
-  data.tar.gz: ca55fec0b063774de1dc181e40035c8f8114ceb3c8027e504d95af973b0a45b0
+  metadata.gz: acf2f399e82520a21f535b5d3a47d75d20aaa428e7c4807d2704f897dbdb54f5
+  data.tar.gz: 1e0290e584b80556ae63867e753a2440bc92418d1e58f9731bb952a3230835c9
 SHA512:
-  metadata.gz: 0562d448f8789e089f75015af48037267ef2022cbad87b71479dbc1d230affe5b66ec8a23564a5abaa2e764d4cfde5051a47023e6cb8d5e1cb028c941940e7d1
-  data.tar.gz: 4a57ea05752b7b7793583d8f6b766448ed49e6ff07f66e6f699ccc39a5b966ef78cca69cbe119e8c2af1cc0f3f1780f8218128dece2e1c55f18b8b2c7a2f32f4
+  metadata.gz: 583de4d2a041f1f07d927e2f422a5f64e53b8349586d986aee61b46de694bf1f67b4ac10a44288377c07e5e660d008adc2ae08e644f8a476bd07bd6a68a882e0
+  data.tar.gz: 0c7d347a9ee35b7b65a33821e97f4b15407652f1c7771c6b47c1258a3dacf1810dafbee8596a02e326f480d458e83bfa2c3e9bbda0e6457e06e8955cb45c37a4

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Release History
 
+### 1.4.0 (2026-10-22)
+
+#### Features
+
+* allow setting the faraday adapter to use ([#27337](https://github.com/googleapis/google-api-ruby-client/issues/27337)) ([370d8ae](https://github.com/googleapis/google-api-ruby-client/commit/370d8ae750e125066f3c1204b3ceb561d3aca1dd)), refs [#27339](https://github.com/googleapis/google-api-ruby-client/issues/27339)
+
+#### Documentation
+
+* document ClientOptions#adapter requirements and caveats ([#28298](https://github.com/googleapis/google-api-ruby-client/issues/28298)) ([96bd38f](https://github.com/googleapis/google-api-ruby-client/commit/96bd38fcceccfe20f0713545611911604d673f94)), refs [#27337](https://github.com/googleapis/google-api-ruby-client/issues/27337)
+
 ### 1.3.2 (2026-10-15)
 
 #### Bug Fixes

data/OVERVIEW.md

@@ -22,6 +22,14 @@ should pin `google-apis-core` to a 0.x version in your Gemfile. For example:
 
     gem "google-apis-core", "~> 0.18"
 
+google-apis-core uses Faraday's default adapter, which wraps [net-http](https://github.com/ruby/net-http), and is tested only against it. You can change the adapter by setting the `:adapter` client option:
+
+```ruby
+Google::Apis::ClientOptions.default.adapter = :net_http_persistent # or :httpx, or...
+```
+
+There's a caveat, though: downloading media requires a `faraday` adapter which [implements the `on_data` streaming API](https://lostisland.github.io/faraday/#/advanced/streaming-responses?id=streaming-responses). See {Google::Apis::ClientOptions#adapter} for the full requirements.
+
 ## Documentation
 
 More detailed descriptions of the Google legacy REST clients are available in two documents.

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

@@ -567,6 +567,7 @@ module Google
           Faraday.new options do |faraday|
             faraday.response :logger, Google::Apis.logger if client_options.log_http_requests
             faraday.response :follow_redirects_google_apis_core, limit: 5
+            faraday.adapter client_options.adapter if client_options.adapter
           end
         end
 

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

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

data/lib/google/apis/options.rb

@@ -23,7 +23,8 @@ module Google
       :read_timeout_sec,
       :send_timeout_sec,
       :log_http_requests,
-      :transparent_gzip_decompression)
+      :transparent_gzip_decompression,
+      :adapter)
 
     RequestOptions = Struct.new(
       :authorization,
@@ -50,6 +51,30 @@ module Google
       #   @return [String] Name of the application, for identification in the User-Agent header
       # @!attribute [rw] application_version
       #   @return [String] Version of the application, for identification in the User-Agent header
+      # @!attribute [rw] adapter
+      #   @return [Symbol, Class, nil] The Faraday adapter for HTTP connections, either a registered
+      #     adapter name ([Faraday adapters](https://lostisland.github.io/faraday/#/adapters/index?id=adapters),
+      #     for example `:net_http_persistent`) or an adapter class. If `nil` (the
+      #     default), Faraday uses `Faraday.default_adapter`, which is `:net_http` unless changed.
+      #
+      #     Only the default `:net_http` adapter is tested with google-apis-core. Any other adapter
+      #     is used at your own risk. It must:
+      #
+      #     * support response streaming with `on_data`, which media downloads require;
+      #     * honor the `open_timeout_sec`, `read_timeout_sec`, `send_timeout_sec` and `proxy_url`
+      #       settings;
+      #     * raise `Faraday::Error` subclasses for network failures, so that requests are retried;
+      #     * be safe to use from several threads at once, because each service shares a single
+      #       connection.
+      #
+      #     If the adapter keeps connections open, don't reuse them across `fork`. Create services
+      #     in each process after forking.
+      #
+      #     Load the adapter (for example `require "faraday/net_http_persistent"`) before the
+      #     connection is created. An unregistered name raises `Faraday::Error` at that point.
+      #     A service creates its connection once, on first use, so set this option before then.
+      #     Each service copies `ClientOptions.default` when it's created, so changing the default
+      #     only affects services created afterwards.
       # @!attribute [rw] proxy_url
       #   @return [String] URL of a proxy server
       # @!attribute [rw] log_http_requests
@@ -82,7 +107,7 @@ module Google
       # @!attribute [rw] max_interval
       #   @return [Integer] The maximum interval in seconds that any individual retry can reach.
       # @!attribute [rw] multiplier
-      #   @return [Numeric] Each successive interval grows by this factor. A multipler of 1.5 means the next interval 
+      #   @return [Numeric] 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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-core
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.4.0
 platform: ruby
 authors:
 - Google LLC
@@ -167,7 +167,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   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/v1.3.2
+  documentation_uri: https://googleapis.dev/ruby/google-apis-core/v1.4.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core
 rdoc_options: []
 require_paths: