protocol-http 0.58.1 → 0.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e755c82bfe5d9098e7fe898dfb19e6963e500ab9410d9c7d04e2b6eb18886689
-  data.tar.gz: 23717c1485024e2f324cc069f7684a924f864a9f57c2a6e62b7be72ba532db45
+  metadata.gz: 86fc99bdf4478ab27c254aaf2c08879a76a7179d2f05979c022d7d9dd4149f7f
+  data.tar.gz: ef2431fbfddafb860028590fd5bfe641b3b7261e7beed8d5cdefea202b1423f6
 SHA512:
-  metadata.gz: a70c2c04344069a17fe6cdf1a5d23dcdaffcfbbfad815937d229c8bdeb7299bef0db2eb45c37e0fec6c1ba8cdf729560ebfcbb261910d630fc2d15d89a7b46a9
-  data.tar.gz: fc047716362a83605223b9f0107a652ac8dcaa860c10815dd755c55a7ba73dc4a4ef468212d570e6c37340e6d7bfc3ba85ad6623c1620d38b2bbce57a9e3e4be
+  metadata.gz: 4169ced46a030ec0d90e4ae0711dabd4663ddc7f1c51a5f8687a3eee30d23754df5c537f19533d350681f03196403e3501bd568d3c3526c465c5760ca2939fce
+  data.tar.gz: 88f2b94a09f2ce2c9b3815e609056d7ae45c4e657455abc48073d5f6b61aca6ae4d6dd3ad7104a0e576abfdea1c7fff2f5f838ba11fa398ed40c041bc913f6c8

data/context/headers.md

@@ -63,8 +63,8 @@ HTTP trailers are headers that appear after the message body. For security reaso
 ```ruby
 # Working with trailers
 headers = Protocol::HTTP::Headers.new([
-		["content-type", "text/html"],
-		["content-length", "1000"]
+	["content-type", "text/html"],
+	["content-length", "1000"]
 ])
 
 # Start trailer section

data/lib/protocol/http/body/deflate.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 "wrapper"
 
@@ -113,15 +113,19 @@ module Protocol
 					return if @stream.finished?
 					
 					# The stream might have been closed while waiting for the chunk to come in.
-					if chunk = super
-						@input_length += chunk.bytesize
-						
-						chunk = @stream.deflate(chunk, Zlib::SYNC_FLUSH)
-						
-						@output_length += chunk.bytesize
-						
-						return chunk
-					elsif !@stream.closed?
+					while chunk = super
+						unless chunk.empty?
+							@input_length += chunk.bytesize
+							
+							chunk = @stream.deflate(chunk, Zlib::SYNC_FLUSH)
+							
+							@output_length += chunk.bytesize
+							
+							return chunk
+						end
+					end
+					
+					if !@stream.closed?
 						chunk = @stream.finish
 						
 						@output_length += chunk.bytesize

data/lib/protocol/http/body/writable.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024-2025, by Samuel Williams.
+# Copyright, 2024-2026, by Samuel Williams.
 
 require_relative "readable"
 
@@ -28,6 +28,9 @@ module Protocol
 				# @attribute [Integer] The length of the response body if known.
 				attr :length
 				
+				# @attribute [Integer] The number of chunks written to the body.
+				attr :count
+				
 				# Stop generating output; cause the next call to write to fail with the given error. Does not prevent existing chunks from being read. In other words, this indicates both that no more data will be or should be written to the body.
 				#
 				# @parameter error [Exception] The error that caused this body to be closed, if any. Will be raised on the next call to {read}.

data/lib/protocol/http/error.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.
 
 module Protocol
 	module HTTP
@@ -36,6 +36,9 @@ module Protocol
 			# @attribute [String] new_value The new value for the duplicated header.
 			attr :new_value
 			
+			# Provides a detailed error message including the existing and new values.
+			# @parameter highlight [Boolean] Whether to highlight the message (not currently used).
+			# @return [String] The detailed error message.
 			def detailed_message(highlight: false)
 				<<~MESSAGE
 					#{self.message}

data/lib/protocol/http/header/generic.rb

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

data/lib/protocol/http/middleware/builder.rb

@@ -18,6 +18,22 @@ module Protocol
 					@app = default_app
 				end
 				
+				# Build the middleware application using the given block.
+				#
+				# @parameter block [Proc] The block to pass to the middleware constructor.
+				# @returns [Builder] The builder.
+				def build(&block)
+					if block_given?
+						if block.arity == 0
+							instance_exec(&block)
+						else
+							yield self
+						end
+					end
+					
+					return self
+				end
+				
 				# Use the given middleware with the given arguments and options.
 				#
 				# @parameter middleware [Class | Object] The middleware class to use.
@@ -44,15 +60,28 @@ module Protocol
 			end
 			
 			# Build a middleware application using the given block.
-			def self.build(&block)
-				builder = Builder.new
+			def self.build(*arguments, &block)
+				builder = Builder.new(*arguments)
+				
+				builder.build(&block)
+				
+				return builder.to_app
+			end
+			
+			# Load a middleware application from the given path.
+			#
+			# @parameter path [String] The path to the middleware application.
+			# @parameter arguments [Array] The arguments to pass to the middleware constructor.
+			# @parameter options [Hash] The options to pass to the middleware constructor.
+			# @parameter block [Proc] The block to pass to the middleware constructor.
+			def self.load(path, *arguments, &block)
+				builder = Builder.new(*arguments)
+				
+				binding = Builder::TOPLEVEL_BINDING.call(builder)
+				eval(File.read(path), binding, path)
 				
 				if block_given?
-					if block.arity == 0
-						builder.instance_exec(&block)
-					else
-						yield builder
-					end
+					builder.build(&block)
 				end
 				
 				return builder.to_app
@@ -60,3 +89,5 @@ module Protocol
 		end
 	end
 end
+
+Protocol::HTTP::Middleware::Builder::TOPLEVEL_BINDING = ->(builder){builder.instance_eval{binding}}

data/lib/protocol/http/version.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2025, by Samuel Williams.
+# Copyright, 2018-2026, by Samuel Williams.
 
 module Protocol
 	module HTTP
-		VERSION = "0.58.1"
+		VERSION = "0.60.0"
 	end
 end

data/readme.md

@@ -30,6 +30,15 @@ Please see the [project documentation](https://socketry.github.io/protocol-http/
 
 Please see the [project releases](https://socketry.github.io/protocol-http/releases/index) for all releases.
 
+### v0.60.0
+
+  - Expose `Protocol::HTTP::Body::Writable#count` attribute to provide access to the number of chunks written to the body.
+
+### v0.59.0
+
+  - Introduce `Protocol::HTTP::Middleware.load` method for loading middleware applications from files.
+  - Prevent `ZLib::BufError` when deflating empty chunks by skipping deflation for empty chunks.
+
 ### v0.58.1
 
   - `Protocol::HTTP::DuplicateHeaderError` now includes the existing and new values for better debugging.
@@ -79,16 +88,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http/relea
   - Expose `tail` in `Headers.new` so that trailers can be accurately reproduced.
   - Add agent context.
 
-### v0.51.0
-
-  - `Protocol::HTTP::Headers` now raise a `DuplicateHeaderError` when a duplicate singleton header (e.g. `content-length`) is added.
-  - `Protocol::HTTP::Headers#add` now coerces the value to a string when adding a header, ensuring consistent behaviour.
-  - `Protocol::HTTP::Body::Head.for` now accepts an optional `length` parameter, allowing it to create a head body even when the body is not provided, based on the known content length.
-
-### v0.50.0
-
-    - Drop support for Ruby v3.1.
-
 ## See Also
 
   - [protocol-http1](https://github.com/socketry/protocol-http1) — HTTP/1 client/server implementation using this

data/releases.md

@@ -1,5 +1,14 @@
 # Releases
 
+## v0.60.0
+
+  - Expose `Protocol::HTTP::Body::Writable#count` attribute to provide access to the number of chunks written to the body.
+
+## v0.59.0
+
+  - Introduce `Protocol::HTTP::Middleware.load` method for loading middleware applications from files.
+  - Prevent `ZLib::BufError` when deflating empty chunks by skipping deflation for empty chunks.
+
 ## v0.58.1
 
   - `Protocol::HTTP::DuplicateHeaderError` now includes the existing and new values for better debugging.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.58.1
+  version: 0.60.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -128,7 +128,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="