async-http-faraday 0.18.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b306179751e2a8f56e9f63b68b243f8ae504b8c7a79f2c00ecd98fc1e09d9ba
-  data.tar.gz: c5aef891d4ba786d2e489c847c021a00bb47c8b0096ad07b595184bf8cd96caf
+  metadata.gz: c35355716bc9483c9f0dcd3070e31cfa0570e49e20d25f96fa429c06d55fef5f
+  data.tar.gz: 8781699d3bef67478a25bee464f7ccd9bb7cfcf39dae30879f7ad2c09b767e9b
 SHA512:
-  metadata.gz: 2faccb555f15488e99cc9f3b774dd9aae4eb9b3dac432623a85cf5c85019fa223cf0fe3538fb1e82cef67400f6d4ec86fc41ec8530a95effc69364fa50a99bf3
-  data.tar.gz: 4ea301d64d6bd6716eae5f7bbdb6569a31a4d51b9ac023a30f153ff248e87420c454966fb05cecd44acfad0a614690ada231b9d4ef6508f4ec53c4b87ee24a07
+  metadata.gz: 785d20de694024d75fd214bdfbf0680d7de1e0cb8fb695434186b51c829b2b04c9c957a6cab120ce64b75b7daa57c9fa26cd19940e22296015183793ec2bbac3
+  data.tar.gz: 4f3cf8059b823e6db1b2be08eb76cd49d8383deb1685e8bafb31796d8c23a0f67672062c6739097a71dd944f48e346c74b9ca1c01a34ebbf0736c39fe049bebc

data/examples/topics.rb

@@ -6,14 +6,14 @@
 
 $LOAD_PATH.unshift File.expand_path("../lib", __dir__)
 
-require 'async'
-require 'faraday'
-require 'async/http/faraday'
+require "async"
+require "faraday"
+require "async/http/faraday"
 
 # Async.logger.debug!
 
 module TestAsync
-	URL = 'https://www.google.com/search'
+	URL = "https://www.google.com/search"
 	TOPICS = %W{ruby python lisp javascript cobol}
 	
 	def self.fetch_topics_async

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

@@ -8,16 +8,18 @@
 # Copyright, 2023, by Genki Takiuchi.
 # Copyright, 2023, by Flavio Fernandes.
 # Copyright, 2024, by Jacob Frautschi.
-# Copyright, 2024, by Korbin Hoffman.
+# Copyright, 2025, by Nikolaos Anastopoulos.
 
-require 'faraday'
-require 'faraday/adapter'
-require 'kernel/sync'
+require "faraday"
+require "faraday/adapter"
 
-require 'async/http/client'
-require 'async/http/proxy'
+require "async/barrier"
+require "kernel/sync"
 
-require_relative 'clients'
+require "async/http/client"
+require "async/http/proxy"
+
+require_relative "clients"
 
 module Async
 	module HTTP
@@ -48,8 +50,53 @@ module Async
 				end
 			end
 			
+			# Implement the Faraday parallel manager interface, using Async.
+			class ParallelManager
+				# Create a new parallel manager.
+				def initialize(options = {})
+					@options = options
+					@barrier = nil
+				end
+				
+				# @deprecated Please update your Faraday version!
+				def run
+					if $VERBOSE
+						warn "Please update your Faraday version!", uplevel: 2
+					end
+				end
+				
+				# Run the given block asynchronously, using the barrier if available.
+				def async(&block)
+					if @barrier
+						@barrier.async(&block)
+					else
+						Sync(&block)
+					end
+				end
+				
+				# Execute the given block which can perform multiple concurrent requests, waiting for them all to complete.
+				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
+				
+				# Create a new parallel manager, which is used to handle multiple concurrent requests.
+				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,
@@ -96,8 +143,23 @@ module Async
 					super
 					
 					# For compatibility with the default adapter:
-					env.url.path = '/' if env.url.path.empty?
+					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:
@@ -124,19 +186,19 @@ module Async
 								response = env.stream_response do |&on_data|
 									response = client.call(request)
 									
+									save_response(env, response.status, nil, response.headers, finished: false)
+									
 									response.each do |chunk|
 										on_data.call(chunk)
 									end
 									
 									response
 								end
-								
-								save_response(env, response.status, nil, response.headers)
 							else
 								response = client.call(request)
-								
-								save_response(env, response.status, encoded_body(response), response.headers)
 							end
+							
+							save_response(env, response.status, encoded_body(response), response.headers)
 						end
 					end
 					
@@ -149,8 +211,6 @@ module Async
 					raise ::Faraday::ConnectionFailed, e
 				end
 				
-				private
-				
 				def with_client(env)
 					Sync do
 						endpoint = Endpoint.new(env.url)
@@ -181,11 +241,11 @@ module Async
 				
 				def encoded_body(response)
 					body = response.read
-					return body if body.nil?
-					content_type = response.headers['content-type']
+					return +"" if body.nil?
+					content_type = response.headers["content-type"]
 					return body unless content_type
 					params = extract_type_parameters(content_type)
-					if charset = params['charset']
+					if charset = params["charset"]
 						body = body.dup if body.frozen?
 						body.force_encoding(charset)
 					end
@@ -196,10 +256,10 @@ module Async
 				
 				def extract_type_parameters(content_type)
 					result = {}
-					list = content_type.split(';')
+					list = content_type.split(";")
 					list.shift
 					list.each do |param|
-						key, value = *param.split('=', 2)
+						key, value = *param.split("=", 2)
 						result[key.strip] = value.strip
 					end
 					result

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

@@ -3,12 +3,12 @@
 # Released under the MIT License.
 # Copyright, 2024, by Samuel Williams.
 
-require 'faraday'
-require 'faraday/adapter'
-require 'kernel/sync'
+require "faraday"
+require "faraday/adapter"
+require "kernel/sync"
 
-require 'async/http/client'
-require 'async/http/proxy'
+require "async/http/client"
+require "async/http/proxy"
 
 module Async
 	module HTTP

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

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative 'adapter'
+require_relative "adapter"
 
 # Set the default adapter to use Async::HTTP.
 ::Faraday.default_adapter = :async_http

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

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

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2018-2024, by Samuel Williams.  
+Copyright, 2018-2025, by Samuel Williams.  
 Copyright, 2018, by Andreas Garnaes.  
 Copyright, 2019, by Denis Talakevich.  
 Copyright, 2019-2020, by Igor Sidorov.  
@@ -9,7 +9,7 @@ Copyright, 2020, by Benoit Daloze.
 Copyright, 2023, by Genki Takiuchi.  
 Copyright, 2023, by Flavio Fernandes.  
 Copyright, 2024, by Jacob Frautschi.  
-Copyright, 2024, by Korbin Hoffman.  
+Copyright, 2025, by Nikolaos Anastopoulos.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -9,9 +9,30 @@ 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 releases](https://socketry.github.io/async-http-faraday/releases/index) for all releases.
+
+### v0.20.0
+
+  - Implement the new response streaming interface, which provides the initial response status code and headers before streaming the response body.
+  - An empty response now sets the response body to an empty string rather than `nil` as required by the Faraday specification.
+
+### v0.19.0
+
+  - [Support `in_parallel`](https://socketry.github.io/async-http-faraday/releases/index#support-in_parallel)
+
+### v0.18.0
+
+  - [Config Block](https://socketry.github.io/async-http-faraday/releases/index#config-block)
+
+### v0.17.0
+
+  - [Per-thread Client Cache](https://socketry.github.io/async-http-faraday/releases/index#per-thread-client-cache)
 
 ## Contributing
 

data/releases.md

@@ -0,0 +1,83 @@
+# Releases
+
+## v0.20.0
+
+  - Implement the new response streaming interface, which provides the initial response status code and headers before streaming the response body.
+  - An empty response now sets the response body to an empty string rather than `nil` as required by the Faraday specification.
+
+## v0.19.0
+
+### Support `in_parallel`
+
+The adapter now supports the `in_parallel` method, which allows multiple requests to be made concurrently.
+
+``` ruby
+adapter = Faraday.new(bound_url) do |builder|
+	builder.adapter :async_http
+end
+
+response1 = response2 = response3 = nil
+
+adapter.in_parallel do
+	response1 = adapter.get("/index")
+	response2 = adapter.get("/index")
+	response3 = adapter.get("/index")
+end
+
+puts response1.body # => "Hello World"
+puts response2.body # => "Hello World"
+puts response3.body # => "Hello World"
+```
+
+This is primarily for compatibility with existing code. If you are designing a new library, you should just use `Async` directly:
+
+``` ruby
+Async do
+	response1 = Async{adapter.get("/index")}
+	response2 = Async{adapter.get("/index")}
+	response3 = Async{adapter.get("/index")}
+	
+	puts response1.wait.body # => "Hello World"
+	puts response2.wait.body # => "Hello World"
+	puts response3.wait.body # => "Hello World"
+end
+```
+
+## v0.18.0
+
+### Config Block
+
+The `config_block` provided to the adapter must now return `nil`, `client` or a middleware wrapper around `client`.
+
+``` ruby
+Faraday.new do |builder|
+	builder.adapter :async_http do |client|
+		# Option 1 (same as returning `nil`), use client as is:
+		client # Use `client` as is.
+		
+		# Option 2, wrap client in a middleware:
+		Async::HTTP::Middleware::LocationRedirector.new(client)
+	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
+```

metadata

@@ -1,20 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: async-http-faraday
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Samuel Williams
 - Igor Sidorov
 - Andreas Garnaes
 - Genki Takiuchi
+- Nikolaos Anastopoulos
 - Olle Jonsson
 - Benoit Daloze
 - Denis Talakevich
 - Flavio Fernandes
 - Jacob Frautschi
-- Korbin Hoffman
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -46,7 +45,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-08-17 00:00:00.000000000 Z
+date: 2025-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-http
@@ -76,13 +75,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- changes.md
 - examples/topics.rb
 - lib/async/http/faraday.rb
 - lib/async/http/faraday/adapter.rb
@@ -91,13 +87,14 @@ files:
 - lib/async/http/faraday/version.rb
 - license.md
 - readme.md
-homepage: https://github.com/socketry/async-http
+- releases.md
+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: []
 require_paths:
 - lib
@@ -112,8 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Provides an adaptor between async-http and faraday.
 test_files: []

data/changes.md

@@ -1,17 +0,0 @@
-# v0.18.0
-
-## Config Block
-
-The `config_block` provided to the adapter must now return `nil`, `client` or a middleware wrapper around `client`.
-
-```ruby
-Faraday.new do |builder|
-	builder.adapter :async_http do |client|
-		# Option 1 (same as returning `nil`), use client as is:
-		client # Use `client` as is.
-		
-		# Option 2, wrap client in a middleware:
-		Async::HTTP::Middleware::LocationRedirector.new(client)
-	end
-end
-```