protocol-rack 0.18.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fed6d6b2ffc0dc007d343e8f9414af4c61cd7c321cb289b6d218290977feb7f
-  data.tar.gz: d02dd7e216b58d3bbe94e5e99b4c71d689ad8de5cb7451a67a81bcd0ade5a55a
+  metadata.gz: c27e5bf1536d42121ad0ce4dc5a853f0dc2ecb742413bb84b96165518202a0ae
+  data.tar.gz: 4e6e3713f8d48d5ef5595e9f9472861593330e5551f106366d5a6c7cc7b6e908
 SHA512:
-  metadata.gz: df29bd96d8542e75e146d0eec4d7813f7e037fdd84e68bd08ac1f6a4cfca66b3ec176dd3167e31eedb3ae849b44059c23b0fe57a4aea8b4a2c3f55c90755b36f
-  data.tar.gz: 6969ef3c4a7fb95083dd57697c5bcf0aee57ec1f9eee6f0b4233af56e4845513c21480cee2abc14daf320d5cf7c5c739b50448bc3d3c6023432292a6544d8876
+  metadata.gz: 2027afc339a462587ac9c31143ad33b6d9fca2c3432068fc7369182ecf7f1111b171a33b1b7ae4600e303e8f6a59ab12369480433d8e38acc4bc3e04ed8ca3d1
+  data.tar.gz: c9e376f09aaf01e32b0cc2bf395d729e1043ecc14916850bc719d8d5709b8ca148e29203f8339de2899e2466dbcb5ab918f39055ae21bd63fb1595d95a9f93b8

data/context/getting-started.md

@@ -53,3 +53,25 @@ end
 ```
 
 The adapter automatically detects your Rack version (v2, v3, or v3.1+) and uses the appropriate implementation, ensuring compatibility without any configuration.
+
+### Server Adapter
+
+Any Rack compatible server can host `Protocol::HTTP` compatible middlewares.
+
+``` ruby
+require "protocol/http/middleware"
+require "protocol/rack"
+
+# Your native application:
+middleware = Protocol::HTTP::Middleware::HelloWorld
+
+run do |env|
+	# Convert the rack request to a compatible rich request object:
+	request = Protocol::Rack::Request[env]
+	
+	# Call your application
+	response = middleware.call(request)
+	
+	Protocol::Rack::Adapter.make_response(env, response)
+end
+```

data/lib/protocol/rack/adapter/generic.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2025, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
 
 require "console"
 
@@ -76,7 +76,7 @@ module Protocol
 								env[http_key] = "#{current_value},#{value}"
 							end
 						else
-							env[http_key] = value
+							env[http_key] = value.to_s
 						end
 					end
 				end

data/lib/protocol/rack/adapter/rack2.rb

@@ -131,10 +131,10 @@ module Protocol
 							meta[key] = value
 						elsif value.is_a?(String)
 							value.split("\n").each do |value|
-								headers[key] = value
+								headers.add(key, value)
 							end
 						else
-							headers[key] = value
+							headers.add(key, value)
 						end
 					end
 					

data/lib/protocol/rack/adapter/rack3.rb

@@ -103,10 +103,10 @@ module Protocol
 							meta[key] = value
 						elsif value.is_a?(Array)
 							value.each do |value|
-								headers[key] = value
+								headers.add(key, value)
 							end
 						else
-							headers[key] = value
+							headers.add(key, value)
 						end
 					end
 					

data/lib/protocol/rack/input.rb

@@ -89,7 +89,7 @@ module Protocol
 				# No-op.
 			end
 			
-			def sysread(size, buffer = nil)
+			def sysread(size, buffer)
 				if @body
 					# User's may forget to call #close...
 					if chunk = @body.read
@@ -100,13 +100,8 @@ module Protocol
 							@closed = true
 						end
 						
-						if buffer
-							# If a buffer is provided, we copy the chunk into it:
-							buffer.replace(chunk)
-						else
-							# Otherwise we return the chunk directly:
-							buffer = chunk
-						end
+						# The buffer is always provided, and we replace its contents:
+						buffer.replace(chunk)
 						
 						return buffer
 					else

data/lib/protocol/rack/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module Rack
-		VERSION = "0.18.0"
+		VERSION = "0.20.0"
 	end
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2022-2025, by Samuel Williams.  
+Copyright, 2022-2026, by Samuel Williams.  
 Copyright, 2023, by Genki Takiuchi.  
 Copyright, 2025, by Francisco Mejia.  
 

data/readme.md

@@ -17,60 +17,18 @@ Please see the [project documentation](https://socketry.github.io/protocol-rack/
 
   - [Request and Response Handling](https://socketry.github.io/protocol-rack/guides/request-response/index) - This guide explains how to work with requests and responses when bridging between Rack and `Protocol::HTTP`, covering advanced use cases and edge cases.
 
-### Application Adapter
-
-Given a rack application, you can adapt it for use on `async-http`:
-
-``` ruby
-require "async"
-require "async/http/server"
-require "async/http/client"
-require "async/http/endpoint"
-require "protocol/rack/adapter"
-
-app = proc{|env| [200, {}, ["Hello World"]]}
-middleware = Protocol::Rack::Adapter.new(app)
-
-Async do
-	endpoint = Async::HTTP::Endpoint.parse("http://localhost:9292")
-	
-	server_task = Async(transient: true) do
-		server = Async::HTTP::Server.new(middleware, endpoint)
-		server.run
-	end
-	
-	client = Async::HTTP::Client.new(endpoint)
-	puts client.get("/").read
-		# "Hello World"
-end
-```
-
-### Server Adapter
-
-While not tested, in theory any Rack compatible server can host `Protocol::HTTP` compatible middlewares.
-
-``` ruby
-require "protocol/http/middleware"
-require "protocol/rack"
-
-# Your native application:
-middleware = Protocol::HTTP::Middleware::HelloWorld
-
-run do |env|
-	# Convert the rack request to a compatible rich request object:
-	request = Protocol::Rack::Request[env]
-	
-	# Call your application
-	response = middleware.call(request)
-	
-	Protocol::Rack::Adapter.make_response(env, response)
-end
-```
-
 ## Releases
 
 Please see the [project releases](https://socketry.github.io/protocol-rack/releases/index) for all releases.
 
+### v0.20.0
+
+  - Convert header values into strings using `to_s` so that `Headers#each` can yield non-string values if necessary.
+
+### v0.19.0
+
+  - Use `Headers#add` instead of `Headers#[]=` in Rack3 and Rack31 adapters, which is the correct interface for appending headers.
+
 ### v0.18.0
 
   - Correctly invoke `rack.response_finished` in reverse order.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.20.0
+
+  - Convert header values into strings using `to_s` so that `Headers#each` can yield non-string values if necessary.
+
+## v0.19.0
+
+  - Use `Headers#add` instead of `Headers#[]=` in Rack3 and Rack31 adapters, which is the correct interface for appending headers.
+
 ## v0.18.0
 
   - Correctly invoke `rack.response_finished` in reverse order.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-rack
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -128,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: An implementation of the Rack protocol/specification.
 test_files: []