google-apis-core 1.3.2 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e8ec145745bfbe87e1747980fcb94d965c85129a0d44aa4e04fe308c263a508
-  data.tar.gz: ca55fec0b063774de1dc181e40035c8f8114ceb3c8027e504d95af973b0a45b0
+  metadata.gz: b1c9da7b904255f5cfa7a7340b09680ad04e9b654cf0b9119a62d0d3f23785bb
+  data.tar.gz: dcb808f302b5a8432d7b71aac11d5eed7b57bbf84e27c759616e5f13bd3e65b8
 SHA512:
-  metadata.gz: 0562d448f8789e089f75015af48037267ef2022cbad87b71479dbc1d230affe5b66ec8a23564a5abaa2e764d4cfde5051a47023e6cb8d5e1cb028c941940e7d1
-  data.tar.gz: 4a57ea05752b7b7793583d8f6b766448ed49e6ff07f66e6f699ccc39a5b966ef78cca69cbe119e8c2af1cc0f3f1780f8218128dece2e1c55f18b8b2c7a2f32f4
+  metadata.gz: 9c591df50fe928a6edb03dba868becf61a918e9fa07173b8d8e4cbef540129c5985ad460252ce35ce6910eb7ba53c819663d94d231c9fbc8e92a842664ca7009
+  data.tar.gz: 1b191c3c847f9bda6e522160f6c5ff58862c534eacac8be8f708f2337cba4f2792438947bf2d243b5cc9208daf327fdf1ee17317e090b9aa8308b5f646a983a1

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release History
 
+### 1.4.1 (2026-11-01)
+
+#### Bug Fixes
+
+* bump dependencies representable to ~> 3.3, >= 3.3.1 and multi_json to ~> 1.21, >= 1.21.2 ([#28003](https://github.com/googleapis/google-api-ruby-client/issues/28003)) ([6e0759d](https://github.com/googleapis/google-api-ruby-client/commit/6e0759d7ccbc753ea04793cb991486d7b99faccd)), refs [#26611](https://github.com/googleapis/google-api-ruby-client/issues/26611)
+
+### 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.1".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.1
 platform: ruby
 authors:
 - Google LLC
@@ -85,28 +85,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.21'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.21.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.21'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.21.2
 - !ruby/object:Gem::Dependency
   name: representable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.1
 - !ruby/object:Gem::Dependency
   name: retriable
   requirement: !ruby/object:Gem::Requirement
@@ -167,7 +179,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.1
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/google-apis-core
 rdoc_options: []
 require_paths: