protocol-http 0.67.0 → 0.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d934169186f9f7d3d55577ad02463aca42c88ba3e00b3273e3b6727f8c1b0e06
-  data.tar.gz: b8a13b51e95c6cda67717ad822cdc4b46828feefe6802374de6446c6d1a34f9d
+  metadata.gz: e15c95aaaa592e283652205e025ad4473e3f082865506604799bb8eaadf06368
+  data.tar.gz: 10b0bf633c92acbec2fb96a70e5693060cab025e2df7ea45aaad410ba9c7afad
 SHA512:
-  metadata.gz: d3bc1abcbef44eef390a2de0d4b17d8ebbec0a20180022f43d7e9aaeff0cf153027fec6d7e6b7968fd546dd9b8a321139f8966008acc2f7502f751af34bc5f1a
-  data.tar.gz: 733a70b325bcb1db25f9d21b2fd93be191d9cedf1a521bb386f88e028b47411c692a51f38d25f5381f840a143a9296e1e7a04d444bbf3089296b1e7bd02f9e41
+  metadata.gz: 99165410a3df8b9efef707e17e1ea31befa3510a65c111a77d17270ffb9167f15d36d6bc64512ee2d7aea2ff3cf5087379e7826ce54595087f89d227eb42f9b6
+  data.tar.gz: 297e0e29550b333cfa5f35005263e9762ff8afc64c6ca9e1f76ca1fcfb0c0b9ea3a7364f81f8349aced4b9aa018d7892b5362863896d0827f0d4daec9fd0c648

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

@@ -4,6 +4,8 @@
 # Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2023, by Bruno Sutic.
 
+require_relative "stream"
+
 module Protocol
 	module HTTP
 		module Body
@@ -186,6 +188,12 @@ module Protocol
 				def to_json(...)
 					as_json.to_json(...)
 				end
+				
+				# Return an IO-compatible stream for reading this body.
+				# @returns [Stream] The IO-compatible stream adapter.
+				def to_io
+					return Stream.new(self)
+				end
 			end
 		end
 	end

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

@@ -5,8 +5,6 @@
 # Copyright, 2023, by Genki Takiuchi.
 # Copyright, 2025, by William T. Nelson.
 
-require_relative "buffered"
-
 module Protocol
 	module HTTP
 		module Body
@@ -17,13 +15,15 @@ module Protocol
 				
 				# Initialize the stream with the given input and output.
 				#
-				# @parameter input [Readable] The input stream.
-				# @parameter output [Writable] The output stream.
-				def initialize(input = nil, output = Buffered.new)
+				# @parameter input [Readable | Nil] The input stream.
+				# @parameter output [Writable | Nil] The output stream.
+				def initialize(input = nil, output = nil)
 					@input = input
 					@output = output
 					
-					raise ArgumentError, "Non-writable output!" unless output.respond_to?(:write)
+					if @output
+						raise ArgumentError, "Non-writable output!" unless output.respond_to?(:write)
+					end
 					
 					# Will hold remaining data in `#read`.
 					@buffer = nil
@@ -32,10 +32,10 @@ module Protocol
 					@closed_read = false
 				end
 				
-				# @attribute [Readable] The input stream.
+				# @attribute [Readable | Nil] The input stream.
 				attr :input
 				
-				# @attribute [Writable] The output stream.
+				# @attribute [Writable | Nil] The output stream.
 				attr :output
 				
 				# This provides a read-only interface for data, which is surprisingly tricky to implement correctly.
@@ -409,7 +409,11 @@ module Protocol
 				
 				# @returns [Boolean] Whether there are any output chunks remaining.
 				def empty?
-					@output.empty?
+					if @output
+						return @output.empty?
+					else
+						return true
+					end
 				end
 				
 				private

data/lib/protocol/http/status.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Protocol
+	module HTTP
+		# HTTP status codes and their human-readable descriptions.
+		module Status
+			# Human-readable descriptions for registered and conventional HTTP status codes.
+			DESCRIPTIONS = {
+				100 => "Continue",
+				101 => "Switching Protocols",
+				102 => "Processing",
+				103 => "Early Hints",
+				
+				200 => "OK",
+				201 => "Created",
+				202 => "Accepted",
+				203 => "Non-Authoritative Information",
+				204 => "No Content",
+				205 => "Reset Content",
+				206 => "Partial Content",
+				207 => "Multi-Status",
+				208 => "Already Reported",
+				226 => "IM Used",
+				
+				300 => "Multiple Choices",
+				301 => "Moved Permanently",
+				302 => "Found",
+				303 => "See Other",
+				304 => "Not Modified",
+				305 => "Use Proxy",
+				306 => "Switch Proxy",
+				307 => "Temporary Redirect",
+				308 => "Permanent Redirect",
+				
+				400 => "Bad Request",
+				401 => "Unauthorized",
+				402 => "Payment Required",
+				403 => "Forbidden",
+				404 => "Not Found",
+				405 => "Method Not Allowed",
+				406 => "Not Acceptable",
+				407 => "Proxy Authentication Required",
+				408 => "Request Timeout",
+				409 => "Conflict",
+				410 => "Gone",
+				411 => "Length Required",
+				412 => "Precondition Failed",
+				413 => "Content Too Large",
+				414 => "URI Too Long",
+				415 => "Unsupported Media Type",
+				416 => "Range Not Satisfiable",
+				417 => "Expectation Failed",
+				418 => "I'm a Teapot",
+				421 => "Misdirected Request",
+				422 => "Unprocessable Content",
+				423 => "Locked",
+				424 => "Failed Dependency",
+				425 => "Too Early",
+				426 => "Upgrade Required",
+				428 => "Precondition Required",
+				429 => "Too Many Requests",
+				431 => "Request Header Fields Too Large",
+				451 => "Unavailable For Legal Reasons",
+				
+				500 => "Internal Server Error",
+				501 => "Not Implemented",
+				502 => "Bad Gateway",
+				503 => "Service Unavailable",
+				504 => "Gateway Timeout",
+				505 => "HTTP Version Not Supported",
+				506 => "Variant Also Negotiates",
+				507 => "Insufficient Storage",
+				508 => "Loop Detected",
+				510 => "Not Extended",
+				511 => "Network Authentication Required",
+			}.freeze
+			
+			# Look up the human-readable description for a status code.
+			# @parameter code [Integer] The HTTP status code.
+			# @returns [String | Nil] The standard description, if known.
+			def self.description(code)
+				return DESCRIPTIONS[code]
+			end
+		end
+	end
+end

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.67.0"
+		VERSION = "0.69.0"
 	end
 end

data/lib/protocol/http.rb

@@ -5,6 +5,7 @@
 
 require_relative "http/version"
 
+require_relative "http/status"
 require_relative "http/headers"
 require_relative "http/request"
 require_relative "http/response"

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.69.0
+
+  - Add `Protocol::HTTP::Body::Readable#to_io` for obtaining an IO-compatible stream adapter.
+  - Avoid creating an implicit buffered output for `Protocol::HTTP::Body::Stream`.
+
+### v0.68.0
+
+  - Add HTTP status descriptions.
+
 ### v0.67.0
 
   - Parse and resolve HTTP `Range` header values according to the default headers policy.
@@ -63,15 +72,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http/relea
 
   - 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.
-
 ## 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.69.0
+
+  - Add `Protocol::HTTP::Body::Readable#to_io` for obtaining an IO-compatible stream adapter.
+  - Avoid creating an implicit buffered output for `Protocol::HTTP::Body::Stream`.
+
+## v0.68.0
+
+  - Add HTTP status descriptions.
+
 ## v0.67.0
 
   - Parse and resolve HTTP `Range` header values according to the default headers policy.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.67.0
+  version: 0.69.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -113,6 +113,7 @@ files:
 - lib/protocol/http/quoted_string.rb
 - lib/protocol/http/request.rb
 - lib/protocol/http/response.rb
+- lib/protocol/http/status.rb
 - lib/protocol/http/version.rb
 - license.md
 - readme.md