async-http 0.101.0 → 0.102.0

data/lib/async/http/protocol/http2/stream.rb

@@ -28,6 +28,9 @@ module Async
 						@length = nil
 						@input = nil
 						
+						# The application can close its input before the peer finishes sending. HTTP/2 cannot close only the receiving side of a stream, so incoming data is discarded until local output also finishes. At that point, a no-error reset terminates the remaining wire stream.
+						@input_closed = false
+						
 						# Output buffer, writing request body or response body (window_updated):
 						@output = nil
 					end
@@ -114,14 +117,17 @@ module Async
 					def process_data(frame)
 						data = frame.unpack
 						
-						if @input
+						if input = @input
 							unless data.empty?
-								@input.write(data)
+								input.write(data)
 							end
 							
 							if frame.end_stream?
-								@input.close_write
+								input.close_write
 							end
+						else
+							# The application has closed the input, so discard incoming data while maintaining flow control for the stream.
+							request_window_update
 						end
 						
 						return data
@@ -131,6 +137,22 @@ module Async
 						send_reset_stream(::Protocol::HTTP2::Error::INTERNAL_ERROR)
 					end
 					
+					# Close the application-facing receiving side of the stream. While local output remains active, incoming data is discarded with flow-control updates. Once local output is also closed, the remaining wire stream is terminated without an error.
+					# @parameter input [Input] The input body being closed.
+					# @parameter error [Exception | Nil] The error which closed the input.
+					def finish_input(input, error = nil)
+						if @input.equal?(input)
+							@input = nil
+							@input_closed = true
+							
+							if error
+								send_reset_stream(::Protocol::HTTP2::Error::INTERNAL_ERROR)
+							else
+								close_if_finished
+							end
+						end
+					end
+					
 					# Set the body and begin sending it.
 					def send_body(body, trailer = nil)
 						@output = Output.new(self, body, trailer)
@@ -169,11 +191,32 @@ module Async
 						return true
 					end
 					
+					# Send headers and apply any pending application-side closure.
+					def send_headers(...)
+						result = super
+						close_if_finished
+						return result
+					end
+					
+					# Send data and apply any pending application-side closure.
+					def send_data(...)
+						result = super
+						close_if_finished
+						return result
+					end
+					
 					# When the stream transitions to the closed state, this method is called. There are roughly two ways this can happen:
 					# - A frame is received which causes this stream to enter the closed state. This method will be invoked from the background reader task.
 					# - A frame is sent which causes this stream to enter the closed state. This method will be invoked from that task.
 					# While the input stream is relatively straight forward, the output stream can trigger the second case above
 					def closed(error)
+						orderly_reset = error.is_a?(::Protocol::HTTP2::StreamError) &&
+							error.code == ::Protocol::HTTP2::Error::NO_ERROR
+						
+						if orderly_reset
+							error = nil
+						end
+						
 						super
 						
 						if input = @input
@@ -183,7 +226,12 @@ module Async
 						
 						if output = @output
 							@output = nil
-							output.stop(error)
+							
+							if orderly_reset
+								output.close_stream
+							else
+								output.stop(error)
+							end
 						end
 						
 						if pool = @pool and @connection
@@ -192,6 +240,15 @@ module Async
 						
 						return self
 					end
+					
+					private
+					
+					# If both application-facing directions are closed but the peer has not finished, terminate the remaining wire stream without an error.
+					def close_if_finished
+						if @input_closed && @state == :half_closed_local
+							send_reset_stream(::Protocol::HTTP2::Error::NO_ERROR)
+						end
+					end
 				end
 			end
 		end

data/lib/async/http/protocol/http2.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2025, by Samuel Williams.
+# Copyright, 2018-2026, by Samuel Williams.
 # Copyright, 2024, by Thomas Morgan.
 
 require_relative "configurable"

data/lib/async/http/protocol/request.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 require "protocol/http/request"
 require "protocol/http/headers"

data/lib/async/http/protocol/response.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 require "protocol/http/response"
 

data/lib/async/http/proxy.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 
 require_relative "client"
 require_relative "endpoint"

data/lib/async/http/statistics.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2024, by Samuel Williams.
+# Copyright, 2018-2026, by Samuel Williams.
 
 require "protocol/http/body/wrapper"
 

data/lib/async/http/version.rb

@@ -7,6 +7,6 @@
 module Async
 	# @namespace
 	module HTTP
-		VERSION = "0.101.0"
+		VERSION = "0.102.0"
 	end
 end

data/lib/async/http.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 require_relative "http/version"
 require_relative "http/client"

data/lib/traces/provider/async/http/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require_relative "../../../../async/http/client"
 require "traces/provider"

data/lib/traces/provider/async/http/protocol/http1/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require_relative "../../../../../../async/http/protocol/http1/client"
 require "traces/provider"

data/lib/traces/provider/async/http/protocol/http2/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require_relative "../../../../../../async/http/protocol/http2/client"
 require "traces/provider"

data/lib/traces/provider/async/http/server.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require_relative "../../../../async/http/server"
 require "traces/provider"

data/license.md

@@ -3,7 +3,7 @@
 Copyright, 2017-2026, by Samuel Williams.  
 Copyright, 2018, by Viacheslav Koval.  
 Copyright, 2018, by Janko Marohnić.  
-Copyright, 2019, by Denis Talakevich.  
+Copyright, 2019-2026, by Denis Talakevich.  
 Copyright, 2019-2020, by Brian Morearty.  
 Copyright, 2019, by Cyril Roelandt.  
 Copyright, 2020, by Stefan Wrobel.  
@@ -25,6 +25,7 @@ Copyright, 2024, by Hal Brodigan.
 Copyright, 2025, by Jean Boussier.  
 Copyright, 2025, by Yuuji Yaginuma.  
 Copyright, 2025, by William T. Nelson.  
+Copyright, 2026, by Jun Jiang.  
 
 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

@@ -8,14 +8,23 @@ An asynchronous client and server implementation of HTTP/1.0, HTTP/1.1 and HTTP/
 
 Please see the [project documentation](https://socketry.github.io/async-http/) for more details.
 
-  - [Getting Started](https://socketry.github.io/async-http/guides/getting-started/index) - This guide explains how to get started with `Async::HTTP`.
+  - [Getting Started](https://socketry.github.io/async-http/guides/getting-started/index) - This guide explains how to make HTTP requests and serve HTTP responses with `Async::HTTP`.
 
-  - [Testing](https://socketry.github.io/async-http/guides/testing/index) - This guide explains how to use `Async::HTTP` clients and servers in your tests.
+  - [Choosing a Client](https://socketry.github.io/async-http/guides/choosing-a-client/index) - This guide explains how to choose between ruby:`Async::HTTP::Internet`, ruby:`Async::HTTP::Client`, and higher-level interfaces for libraries.
+
+  - [Concurrent Requests and Connection Pooling](https://socketry.github.io/async-http/guides/concurrent-requests/index) - This guide explains how to run HTTP requests concurrently while keeping request fan-out, connection usage, and resource life cycles bounded.
+
+  - [Testing](https://socketry.github.io/async-http/guides/testing/index) - This guide explains how to test `Async::HTTP` clients and servers without depending on external HTTP services.
 
 ## Releases
 
 Please see the [project releases](https://socketry.github.io/async-http/releases/index) for all releases.
 
+### v0.102.0
+
+  - Requests assigned to an HTTP/2 connection which has already closed are refused before being written, allowing them to be retried safely.
+  - HTTP/2 connections which received a graceful `GOAWAY` are removed from availability immediately, but remain in the pool until the server has finished answering the streams it accepted. The connection is closed after its final user releases it, so those requests no longer fail with `EOFError: Connection closed with N active stream(s)!`.
+
 ### v0.101.0
 
   - Handle remote disconnects in `Async::HTTP::Protocol::HTTP1::Server#each` without reporting them as server failures.
@@ -55,10 +64,6 @@ Please see the [project releases](https://socketry.github.io/async-http/releases
       - HTTP/1: Delegate request write failure handling to `protocol-http1`.
       - HTTP/2: Handle GOAWAY and REFUSED\_STREAM via `protocol-http2`, enabling automatic retry of unprocessed requests.
 
-### v0.94.3
-
-  - Fix response body leak in HTTP/2 server when stream is reset before `send_response` completes (e.g. client-side gRPC cancellation). The response body's `close` was never called, leaking any resources tied to body lifecycle (such as `rack.response_finished` callbacks and utilization metrics).
-
 ## See Also
 
   - [benchmark-http](https://github.com/socketry/benchmark-http) — A benchmarking tool to report on web server concurrency.
@@ -71,26 +76,26 @@ Please see the [project releases](https://socketry.github.io/async-http/releases
 
 We welcome contributions to this project.
 
-1.  Fork it.
+1.  Fork the repository.
 2.  Create your feature branch (`git checkout -b my-new-feature`).
-3.  Commit your changes (`git commit -am 'Add some feature'`).
+3.  Commit your changes (`git commit -am 'Add some feature.'`).
 4.  Push to the branch (`git push origin my-new-feature`).
-5.  Create new Pull Request.
+5.  Create a new pull request.
 
 ### Running Tests
 
 To run the test suite:
 
-``` shell
-bundle exec sus
+``` bash
+$ bundle exec sus
 ```
 
 ### Making Releases
 
 To make a new release:
 
-``` shell
-bundle exec bake gem:release:patch # or minor or major
+``` bash
+$ bundle exec bake gem:release:patch # or minor or major
 ```
 
 ### Developer Certificate of Origin

data/releases.md

@@ -1,5 +1,10 @@
 # Releases
 
+## v0.102.0
+
+  - Requests assigned to an HTTP/2 connection which has already closed are refused before being written, allowing them to be retried safely.
+  - HTTP/2 connections which received a graceful `GOAWAY` are removed from availability immediately, but remain in the pool until the server has finished answering the streams it accepted. The connection is closed after its final user releases it, so those requests no longer fail with `EOFError: Connection closed with N active stream(s)!`.
+
 ## v0.101.0
 
   - Handle remote disconnects in `Async::HTTP::Protocol::HTTP1::Server#each` without reporting them as server failures.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-http
 version: !ruby/object:Gem::Version
-  version: 0.101.0
+  version: 0.102.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -10,15 +10,16 @@ authors:
 - Janko Marohnić
 - Thomas Morgan
 - Adam Daniels
+- Denis Talakevich
 - Igor Sidorov
 - William T. Nelson
 - Anton Zhuravsky
 - Cyril Roelandt
-- Denis Talakevich
 - Hal Brodigan
 - Ian Ker-Seymer
 - Jean Boussier
 - Josh Huber
+- Jun Jiang
 - Marco Concetto Rudilosso
 - Olle Jonsson
 - Orgad Shaneh
@@ -82,14 +83,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
 - !ruby/object:Gem::Dependency
   name: io-endpoint
   requirement: !ruby/object:Gem::Requirement
@@ -152,14 +153,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.26'
+        version: '0.27'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.26'
+        version: '0.27'
 - !ruby/object:Gem::Dependency
   name: protocol-url
   requirement: !ruby/object:Gem::Requirement
@@ -180,6 +181,8 @@ extra_rdoc_files: []
 files:
 - bake/async/http.rb
 - bake/async/http/h2spec.rb
+- context/choosing-a-client.md
+- context/concurrent-requests.md
 - context/getting-started.md
 - context/index.yaml
 - context/testing.md
@@ -240,6 +243,8 @@ homepage: https://github.com/socketry/async-http
 licenses:
 - MIT
 metadata:
+  bug_tracker_uri: https://github.com/socketry/async-http/issues
+  changelog_uri: https://github.com/socketry/async-http/blob/main/releases.md
   documentation_uri: https://socketry.github.io/async-http/
   source_code_uri: https://github.com/socketry/async-http.git
 rdoc_options: []