async-http-faraday 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b306179751e2a8f56e9f63b68b243f8ae504b8c7a79f2c00ecd98fc1e09d9ba
-  data.tar.gz: c5aef891d4ba786d2e489c847c021a00bb47c8b0096ad07b595184bf8cd96caf
+  metadata.gz: 405bbaf8e19d542be2efd5e6ba29e5dabaa0fedbbad6c392f70b70dac5295f21
+  data.tar.gz: 2ae52a3a031dea0f6c715e7144f9e0ed2872b0e9b2c8a07043ce1be49f8640a5
 SHA512:
-  metadata.gz: 2faccb555f15488e99cc9f3b774dd9aae4eb9b3dac432623a85cf5c85019fa223cf0fe3538fb1e82cef67400f6d4ec86fc41ec8530a95effc69364fa50a99bf3
-  data.tar.gz: 4ea301d64d6bd6716eae5f7bbdb6569a31a4d51b9ac023a30f153ff248e87420c454966fb05cecd44acfad0a614690ada231b9d4ef6508f4ec53c4b87ee24a07
+  metadata.gz: 8808afa0006650011169d8a9ea52d7029e8e7032d84eceec7e2fa2046b58e66297c3a5b0166ed623b81198161e5a5830309b4db21e30e9174d69f21927bb0a6f
+  data.tar.gz: '064528fe335006b4b00ba6719c119bf583c0cfb20ebdf67d74324d98c74d1c95c3bd9d00359ae1bf80d1fdaca796203526c95473a1d392128eff66b392770dba'

data/changes.md

@@ -15,3 +15,24 @@ Faraday.new do |builder|
 	end
 end
 ```
+
+# v0.17.0
+
+## Per-thread Client Cache
+
+The default adapter now uses a per-thread client cache internally, to improve compatibility with existing code that shares a single `Faraday::Connection` instance across multiple threads.
+
+```ruby
+adapter = Faraday.new do |builder|
+	builder.adapter :async_http
+end
+
+3.times do
+	Thread.new do
+		Async do
+			# Each thread has it's own client cache.
+			adapter.get('http://example.com')
+		end
+	end
+end
+```

data/lib/async/http/faraday/adapter.rb

@@ -12,6 +12,8 @@
 
 require 'faraday'
 require 'faraday/adapter'
+
+require 'async/barrier'
 require 'kernel/sync'
 
 require 'async/http/client'
@@ -48,8 +50,47 @@ module Async
 				end
 			end
 			
+			class ParallelManager
+				def initialize(options = {})
+					@options = options
+					@barrier = nil
+				end
+				
+				def run
+					if $VERBOSE
+						warn "Please update your Faraday version!", uplevel: 2
+					end
+				end
+				
+				def async(&block)
+					if @barrier
+						@barrier.async(&block)
+					else
+						Sync(&block)
+					end
+				end
+				
+				def execute(&block)
+					Sync do
+						@barrier = Async::Barrier.new
+						
+						yield
+						
+						@barrier.wait
+					ensure
+						@barrier&.stop
+					end
+				end
+			end
+			
 			# An adapter that allows Faraday to use Async::HTTP as the underlying HTTP client.
 			class Adapter < ::Faraday::Adapter
+				self.supports_parallel = true
+				
+				def self.setup_parallel_manager(**options)
+					ParallelManager.new(options)
+				end
+				
 				# The exceptions that are considered connection errors and result in a `Faraday::ConnectionFailed` exception.
 				CONNECTION_EXCEPTIONS = [
 					Errno::EADDRNOTAVAIL,
@@ -98,6 +139,21 @@ module Async
 					# For compatibility with the default adapter:
 					env.url.path = '/' if env.url.path.empty?
 					
+					if parallel_manager = env.parallel_manager
+						parallel_manager.async do
+							perform_request(env)
+							env.response.finish(env)
+						end
+					else
+						perform_request(env)
+					end
+					
+					@app.call(env)
+				end
+				
+				private
+				
+				def perform_request(env)
 					with_client(env) do |endpoint, client|
 						if body = env.body
 							# We need to ensure the body is wrapped in a Readable object so that it can be read in chunks:
@@ -149,8 +205,6 @@ module Async
 					raise ::Faraday::ConnectionFailed, e
 				end
 				
-				private
-				
 				def with_client(env)
 					Sync do
 						endpoint = Endpoint.new(env.url)

data/lib/async/http/faraday/version.rb

@@ -6,7 +6,7 @@
 module Async
 	module HTTP
 		module Faraday
-			VERSION = "0.18.0"
+			VERSION = "0.19.0"
 		end
 	end
 end

data/readme.md

@@ -9,9 +9,21 @@ Provides an adaptor for [Faraday](https://github.com/lostisland/faraday) to perf
 
 ## Usage
 
-Please see the [project documentation](https://socketry.github.io/async-http/) for more details.
+Please see the [project documentation](https://socketry.github.io/async-http-faraday/) for more details.
 
-  - [Getting Started](https://socketry.github.io/async-http/guides/getting-started/index) - This guide explains how to use use `Async::HTTP::Faraday` as a drop-in replacement for improved concurrency.
+  - [Getting Started](https://socketry.github.io/async-http-faraday/guides/getting-started/index) - This guide explains how to use use `Async::HTTP::Faraday` as a drop-in replacement for improved concurrency.
+
+## Releases
+
+Please see the [project changes](https://socketry.github.io/async-http-faraday//changes/index) for all releases.
+
+### v0.18.0
+
+  - [Config Block](https://socketry.github.io/async-http-faraday/changes/index#config-block)
+
+### v0.17.0
+
+  - [Per-thread Client Cache](https://socketry.github.io/async-http-faraday/changes/index#per-thread-client-cache)
 
 ## Contributing
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-http-faraday
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -46,7 +46,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-08-17 00:00:00.000000000 Z
+date: 2024-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-http
@@ -91,11 +91,12 @@ files:
 - lib/async/http/faraday/version.rb
 - license.md
 - readme.md
-homepage: https://github.com/socketry/async-http
+homepage: https://github.com/socketry/async-http-faraday
 licenses:
 - MIT
 metadata:
-  documentation_uri: https://socketry.github.io/async-http/
+  documentation_uri: https://socketry.github.io/async-http-faraday/
+  funding_uri: https://github.com/sponsors/ioquatix
   source_code_uri: https://github.com/socketry/async-http.git
 post_install_message:
 rdoc_options: []