protocol-http 0.55.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c016217fd5d9ddfac87278d8a629d47ec338d02441d0f27ed25102962e927b9
-  data.tar.gz: 51d479e7f25046ca76d08ed60676b7bf4afe5ffa3e234bbb4501478d3fe1db2c
+  metadata.gz: 5409468cd5dfe153d3ab2ecc8fae839ff0a688e0d54a81aa402395e6b3de0f1e
+  data.tar.gz: 11d700efbe0ecc425438a605f09643bba5bdde1e258bb0508e34428285b209f3
 SHA512:
-  metadata.gz: a49eb6993da937df85d263f3b505dc700066c796b102c2e4290b9893700fd9f82852bb17f330ef2bf350e11dbf0782e206ae1d29cc4be3fb422d8f6642f1720b
-  data.tar.gz: 2680c120c9d72c6ee7c35929984b67e248d26496145dc08700e4a8a5f60568e6dfe2600b5179042d92793d5784ee46e270a59e76f6d272c094c47ccf1c97c0b3
+  metadata.gz: 90bf1b95afe9e830249676ab82cba8306c2184dfac7b105dff9c068eb67484f5002b73ec5141a1f42177042a4016c83a118a875df36f30ab65c8aa4b9b1ed2fb
+  data.tar.gz: 43ce8ee9a1ace9ff2ae0be4d9ae90625415a504fad5162ebf7e8b1f487bab25bae0aa452260b7cd3fe00193c53835c80f730a1ca16ac142c90f827c852119497

checksums.yaml.gz.sig

@@ -1,3 +1,2 @@
-H��m�J��
-b����f�Aa�+vS�ck`�ÙJ���M�S�r"��.D
-y�������^Je8�
6O�����O��iH6�6쐐���Hʸ��6P���_.��z�qX���O�v�T��އ��ɲ>���xv쓼�~���n�\XD
�(3
+'�5uS�e�T���̯�?r̳���n�n��&��@�T��H�$�)ʣb�o�[�Y�����]br*=�ҵ[�O{R]
+<Ǧ9�y���@�.A5}�F}�贿Xryc%��=�p�@�>��T�V���@��N�i~���¶��šϘD�lH��ў����L���T��]wv>�O;Jo���

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

@@ -10,7 +10,7 @@ require_relative "buffered"
 module Protocol
 	module HTTP
 		module Body
-			# The input stream is an IO-like object which contains the raw HTTP POST data. When applicable, its external encoding must be “ASCII-8BIT” and it must be opened in binary mode, for Ruby 1.9 compatibility. The input stream must respond to gets, each, read and rewind.
+			# The input stream is an IO-like object which contains the raw HTTP POST data. When applicable, its external encoding must be "ASCII-8BIT" and it must be opened in binary mode, for Ruby 1.9 compatibility. The input stream must respond to gets, each, read and rewind.
 			class Stream
 				# The default line separator, used by {gets}.
 				NEWLINE = "\n"

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

@@ -12,7 +12,7 @@ module Protocol
 	module HTTP
 		module Header
 			# The `accept-content-type` header represents a list of content-types that the client can accept.
-			class Accept < Array
+			class Accept < Split
 				# Regular expression used to split values on commas, with optional surrounding whitespace, taking into account quoted strings.
 				SEPARATOR = /
 					(?:            # Start non-capturing group
@@ -68,27 +68,26 @@ module Protocol
 					end
 				end
 				
-				# Parse the `accept` header value into a list of content types.
+				# Parses a raw header value.
 				#
-				# @parameter value [String] the value of the header.
-				def initialize(value = nil)
-					if value
-						super(value.scan(SEPARATOR).map(&:strip))
-					end
+				# @parameter value [String] a raw header value containing comma-separated media types.
+				# @returns [Accept] a new instance containing the parsed media types.
+				def self.parse(value)
+					self.new(value.scan(SEPARATOR).map(&:strip))
 				end
 				
 				# Adds one or more comma-separated values to the header.
 				#
 				# The input string is split into distinct entries and appended to the array.
 				#
-				# @parameter value [String] the value or values to add, separated by commas.
+				# @parameter value [String] a raw header value containing one or more media types separated by commas.
 				def << value
 					self.concat(value.scan(SEPARATOR).map(&:strip))
 				end
 				
-				# Serializes the stored values into a comma-separated string.
+				# Converts the parsed header value into a raw header value.
 				#
-				# @returns [String] the serialized representation of the header values.
+				# @returns [String] a raw header value (comma-separated string).
 				def to_s
 					join(",")
 				end

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

@@ -15,6 +15,22 @@ module Protocol
 			#
 			# TODO Support other authorization mechanisms, e.g. bearer token.
 			class Authorization < String
+				# Parses a raw header value.
+				#
+				# @parameter value [String] a raw header value.
+				# @returns [Authorization] a new instance.
+				def self.parse(value)
+					self.new(value)
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String] the value to coerce.
+				# @returns [Authorization] a parsed header object.
+				def self.coerce(value)
+					self.new(value.to_s)
+				end
+				
 				# Splits the header into the credentials.
 				#
 				# @returns [Tuple(String, String)] The username and password.
@@ -31,8 +47,8 @@ module Protocol
 					strict_base64_encoded = ["#{username}:#{password}"].pack("m0")
 					
 					self.new(
-						"Basic #{strict_base64_encoded}"
-					)
+								"Basic #{strict_base64_encoded}"
+							)
 				end
 				
 				# Whether this header is acceptable in HTTP trailers.

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

@@ -44,16 +44,44 @@ module Protocol
 				# The `proxy-revalidate` directive is similar to `must-revalidate` but applies only to shared caches.
 				PROXY_REVALIDATE = "proxy-revalidate"
 				
-				# Initializes the cache control header with the given value. The value is expected to be a comma-separated string of cache directives.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the raw Cache-Control header value.
+				# @parameter value [String] a raw header value containing comma-separated directives.
+				# @returns [CacheControl] a new instance containing the parsed and normalized directives.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [CacheControl] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the cache control header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of directives, a raw header value, or `nil` for an empty header.
 				def initialize(value = nil)
-					super(value&.downcase)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Adds a directive to the Cache-Control header. The value will be normalized to lowercase before being added.
 				#
-				# @parameter value [String] the directive to add.
+				# @parameter value [String] a raw header value containing directives to add.
 				def << value
 					super(value.downcase)
 				end
@@ -132,3 +160,4 @@ module Protocol
 		end
 	end
 end
+

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

@@ -22,16 +22,44 @@ module Protocol
 				# The `upgrade` directive indicates that the connection should be upgraded to a different protocol, as specified in the `Upgrade` header.
 				UPGRADE = "upgrade"
 				
-				# Initializes the connection header with the given value. The value is expected to be a comma-separated string of directives.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the raw `connection` header value.
+				# @parameter value [String] a raw header value containing comma-separated directives.
+				# @returns [Connection] a new instance with normalized (lowercase) directives.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [Connection] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the connection header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of directives, a raw header value, or `nil` for an empty header.
 				def initialize(value = nil)
-					super(value&.downcase)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Adds a directive to the `connection` header. The value will be normalized to lowercase before being added.
 				#
-				# @parameter value [String] the directive to add.
+				# @parameter value [String] a raw header value containing directives to add.
 				def << value
 					super(value.downcase)
 				end
@@ -61,3 +89,4 @@ module Protocol
 		end
 	end
 end
+

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

@@ -12,9 +12,25 @@ module Protocol
 			#
 			# This header is typically included in HTTP responses and follows the format defined in RFC 9110.
 			class Date < String
-				# Replaces the current value of the `date` header with the specified value.
+				# Parses a raw header value.
 				#
-				# @parameter value [String] the new value for the `date` header.
+				# @parameter value [String] a raw header value.
+				# @returns [Date] a new instance.
+				def self.parse(value)
+					self.new(value)
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String] the value to coerce.
+				# @returns [Date] a parsed header object.
+				def self.coerce(value)
+					self.new(value.to_s)
+				end
+				
+				# Replaces the current value of the `date` header.
+				#
+				# @parameter value [String] a raw header value for the `date` header.
 				def << value
 					replace(value)
 				end

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

@@ -10,9 +10,25 @@ module Protocol
 			#
 			# The `etag` header provides a unique identifier for a specific version of a resource, typically used for cache validation or conditional requests. It can be either a strong or weak validator as defined in RFC 9110.
 			class ETag < String
-				# Replaces the current value of the `etag` header with the specified value.
+				# Parses a raw header value.
 				#
-				# @parameter value [String] the new value for the `etag` header.
+				# @parameter value [String] a raw header value.
+				# @returns [ETag] a new instance.
+				def self.parse(value)
+					self.new(value)
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String] the value to coerce.
+				# @returns [ETag] a parsed header object.
+				def self.coerce(value)
+					self.new(value.to_s)
+				end
+				
+				# Replaces the current value of the `etag` header.
+				#
+				# @parameter value [String] a raw header value for the `etag` header.
 				def << value
 					replace(value)
 				end

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

@@ -52,7 +52,7 @@ module Protocol
 					wildcard? || self.include?(etag) || self.include?(opposite_tag(etag))
 				end
 				
-				private
+			private
 				
 				# Converts a weak tag to its strong counterpart or vice versa.
 				#

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

@@ -10,18 +10,47 @@ module Protocol
 			#
 			# This isn't a specific header but is used as a base for headers that store multiple values, such as cookies. The values are split and stored as an array internally, and serialized back to a newline-separated string when needed.
 			class Multiple < Array
-				# Initializes the multiple header with the given value. As the header key-value pair can only contain one value, the value given here is added to the internal array, and subsequent values can be added using the `<<` operator.
+				# Parses a raw header value.
 				#
-				# @parameter value [String] the raw header value.
-				def initialize(value)
+				# Multiple headers receive each value as a separate header entry, so this method takes a single string value and creates a new instance containing it.
+				#
+				# @parameter value [String] a single raw header value.
+				# @returns [Multiple] a new instance containing the parsed value.
+				def self.parse(value)
+					self.new([value])
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# This method is used by the Headers class when setting values via `[]=` to convert application values into the appropriate policy type.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [Multiple] a parsed header object.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:to_s))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the multiple header with the given values.
+				#
+				# @parameter value [Array | Nil] an array of header values, or `nil` for an empty header.
+				def initialize(value = nil)
 					super()
 					
-					self << value
+					if value
+						self.concat(value)
+					end
 				end
 				
-				# Serializes the stored values into a newline-separated string.
+				# Converts the parsed header value into a raw header value.
+				#
+				# Multiple headers are transmitted as separate header entries, so this serializes to a newline-separated string for storage.
 				#
-				# @returns [String] the serialized representation of the header values.
+				# @returns [String] a raw header value (newline-separated string).
 				def to_s
 					join("\n")
 				end

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

@@ -12,16 +12,44 @@ module Protocol
 			#
 			# The `priority` header allows clients to express their preference for how resources should be prioritized by the server. It supports directives like `u=` to specify the urgency level of a request, and `i` to indicate whether a response can be delivered incrementally. The urgency levels range from 0 (highest priority) to 7 (lowest priority), while the `i` directive is a boolean flag.
 			class Priority < Split
-				# Initialize the priority header with the given value.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the value of the priority header, if any. The value should be a comma-separated string of directives.
+				# @parameter value [String] a raw header value containing comma-separated directives.
+				# @returns [Priority] a new instance with normalized (lowercase) directives.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [Priority] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the priority header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of directives, a raw header value, or `nil` for an empty header.
 				def initialize(value = nil)
-					super(value&.downcase)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Add a value to the priority header.
 				#
-				# @parameter value [String] the directive to add to the header.
+				# @parameter value [String] a raw header value containing directives to add to the header.
 				def << value
 					super(value.downcase)
 				end
@@ -55,3 +83,4 @@ module Protocol
 		end
 	end
 end
+

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

@@ -13,14 +13,43 @@ module Protocol
 				# Regular expression used to split values on commas, with optional surrounding whitespace.
 				COMMA = /\s*,\s*/
 				
-				# Initializes a `Split` header with the given value. If the value is provided, it is split into distinct entries and stored as an array.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the raw header value containing multiple entries separated by commas, or `nil` for an empty header.
-				def initialize(value = nil)
-					if value
-						super(value.split(COMMA))
+				# Split headers receive comma-separated values in a single header entry. This method splits the raw value into individual entries.
+				#
+				# @parameter value [String] a raw header value containing multiple entries separated by commas.
+				# @returns [Split] a new instance containing the parsed values.
+				def self.parse(value)
+					self.new(value.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# This method is used by the Headers class when setting values via `[]=` to convert application values into the appropriate policy type.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [Split] a parsed header object.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:to_s))
 					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes a `Split` header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of values, a raw header value, or `nil` for an empty header.
+				def initialize(value = nil)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						# Compatibility with the old constructor, prefer to use `parse` instead:
 						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
 					end
 				end
 				
@@ -28,14 +57,14 @@ module Protocol
 				#
 				# The input string is split into distinct entries and appended to the array.
 				#
-				# @parameter value [String] the value or values to add, separated by commas.
+				# @parameter value [String] a raw header value containing one or more values separated by commas.
 				def << value
 					self.concat(value.split(COMMA))
 				end
 				
-				# Serializes the stored values into a comma-separated string.
+				# Converts the parsed header value into a raw header value.
 				#
-				# @returns [String] the serialized representation of the header values.
+				# @returns [String] a raw header value (comma-separated string).
 				def to_s
 					join(",")
 				end
@@ -47,7 +76,7 @@ module Protocol
 					false
 				end
 				
-				protected
+			protected
 				
 				def reverse_find(&block)
 					reverse_each do |value|

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

@@ -62,16 +62,44 @@ module Protocol
 					end
 				end
 				
-				# Initializes the TE header with the given value. The value is split into distinct entries and converted to lowercase for normalization.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the raw header value containing transfer encodings separated by commas.
+				# @parameter value [String] a raw header value containing comma-separated encodings.
+				# @returns [TE] a new instance with normalized (lowercase) encodings.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [TE] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the TE header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of encodings, a raw header value, or `nil` for an empty header.
 				def initialize(value = nil)
-					super(value&.downcase)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Adds one or more comma-separated values to the TE header. The values are converted to lowercase for normalization.
 				#
-				# @parameter value [String] the value or values to add, separated by commas.
+				# @parameter value [String] a raw header value containing one or more values separated by commas.
 				def << value
 					super(value.downcase)
 				end
@@ -129,3 +157,4 @@ module Protocol
 		end
 	end
 end
+

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

@@ -27,16 +27,44 @@ module Protocol
 				# The `identity` transfer encoding indicates no transformation has been applied.
 				IDENTITY = "identity"
 				
-				# Initializes the transfer encoding header with the given value. The value is split into distinct entries and converted to lowercase for normalization.
+				# Parses a raw header value.
 				#
-				# @parameter value [String | Nil] the raw header value containing transfer encodings separated by commas.
+				# @parameter value [String] a raw header value containing comma-separated encodings.
+				# @returns [TransferEncoding] a new instance with normalized (lowercase) encodings.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [TransferEncoding] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes the transfer encoding header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of encodings, a raw header value, or `nil` for an empty header.
 				def initialize(value = nil)
-					super(value&.downcase)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Adds one or more comma-separated values to the transfer encoding header. The values are converted to lowercase for normalization.
 				#
-				# @parameter value [String] the value or values to add, separated by commas.
+				# @parameter value [String] a raw header value containing one or more values separated by commas.
 				def << value
 					super(value.downcase)
 				end
@@ -76,3 +104,4 @@ module Protocol
 		end
 	end
 end
+

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

@@ -12,16 +12,44 @@ module Protocol
 			#
 			# The `vary` header is used in HTTP responses to indicate which request headers affect the selected response. It allows caches to differentiate stored responses based on specific request headers.
 			class Vary < Split
-				# Initializes a `Vary` header with the given value. The value is split into distinct entries and converted to lowercase for normalization.
+				# Parses a raw header value.
 				#
-				# @parameter value [String] the raw header value containing request header names separated by commas.
-				def initialize(value)
-					super(value.downcase)
+				# @parameter value [String] a raw header value containing comma-separated header names.
+				# @returns [Vary] a new instance with normalized (lowercase) header names.
+				def self.parse(value)
+					self.new(value.downcase.split(COMMA))
+				end
+				
+				# Coerces a value into a parsed header object.
+				#
+				# @parameter value [String | Array] the value to coerce.
+				# @returns [Vary] a parsed header object with normalized values.
+				def self.coerce(value)
+					case value
+					when Array
+						self.new(value.map(&:downcase))
+					else
+						self.parse(value.to_s)
+					end
+				end
+				
+				# Initializes a `Vary` header with the given values.
+				#
+				# @parameter value [Array | String | Nil] an array of header names, a raw header value, or `nil` for an empty header.
+				def initialize(value = nil)
+					if value.is_a?(Array)
+						super(value)
+					elsif value.is_a?(String)
+						super()
+						self << value
+					elsif value
+						raise ArgumentError, "Invalid value: #{value.inspect}"
+					end
 				end
 				
 				# Adds one or more comma-separated values to the `vary` header. The values are converted to lowercase for normalization.
 				#
-				# @parameter value [String] the value or values to add, separated by commas.
+				# @parameter value [String] a raw header value containing one or more values separated by commas.
 				def << value
 					super(value.downcase)
 				end
@@ -29,3 +57,4 @@ module Protocol
 		end
 	end
 end
+

data/lib/protocol/http/headers.rb

@@ -189,7 +189,7 @@ module Protocol
 			#
 			# @yields {|key, value| ...}
 			# 	@parameter key [String] The header key.
-			# 	@parameter value [String] The header value.
+			# 	@parameter value [String] The raw header value.
 			def each(&block)
 				@fields.each(&block)
 			end
@@ -228,7 +228,6 @@ module Protocol
 			# @parameter key [String] the header key.
 			# @parameter value [String] the header value to assign.
 			def add(key, value)
-				# The value MUST be a string, so we convert it to a string to prevent errors later on.
 				value = value.to_s
 				
 				if @indexed
@@ -238,18 +237,51 @@ module Protocol
 				@fields << [key, value]
 			end
 			
-			alias []= add
-			
 			# Set the specified header key to the specified value, replacing any existing header keys with the same name.
 			#
 			# @parameter key [String] the header key to replace.
 			# @parameter value [String] the header value to assign.
 			def set(key, value)
-				# TODO This could be a bit more efficient:
 				self.delete(key)
 				self.add(key, value)
 			end
 			
+			# Set the specified header key to the specified value, replacing any existing values.
+			#
+			# The value can be a String or a coercable value.
+			#
+			# @parameter key [String] the header key.
+			# @parameter value [String | Array] the header value to assign.
+			def []=(key, value)
+				key = key.downcase
+				
+				# Delete existing value if any:
+				self.delete(key)
+				
+				if policy = @policy[key]
+					unless value.is_a?(policy)
+						value = policy.coerce(value)
+					end
+				else
+					value = value.to_s
+				end
+				
+				# Clear the indexed cache so it will be rebuilt with parsed values when accessed:
+				if @indexed
+					@indexed[key] = value
+				end
+				
+				@fields << [key, value.to_s]
+			end
+			
+			# Get the value of the specified header key.
+			#
+			# @parameter key [String] The header key.
+			# @returns [String | Array | Object] The header value.
+			def [] key
+				to_h[key]
+			end
+			
 			# Merge the headers into this instance.
 			def merge!(headers)
 				headers.each do |key, value|
@@ -338,6 +370,11 @@ module Protocol
 			# @parameter key [String] The header key.
 			# @returns [String | Array | Object] The merged header value.
 			def delete(key)
+				# If we've indexed the headers, we can bail out early if the key is not present:
+				if @indexed && !@indexed.key?(key.downcase)
+					return nil
+				end
+				
 				deleted, @fields = @fields.partition do |field|
 					field.first.downcase == key
 				end
@@ -350,7 +387,7 @@ module Protocol
 					return @indexed.delete(key)
 				elsif policy = @policy[key]
 					(key, value), *tail = deleted
-					merged = policy.new(value)
+					merged = policy.parse(value)
 					
 					tail.each{|k,v| merged << v}
 					
@@ -376,7 +413,11 @@ module Protocol
 					if current_value = hash[key]
 						current_value << value
 					else
-						hash[key] = policy.new(value)
+						if policy.respond_to?(:parse)
+							hash[key] = policy.parse(value)
+						else
+							hash[key] = policy.new(value)
+						end
 					end
 				else
 					# By default, headers are not allowed in trailers:
@@ -392,14 +433,6 @@ module Protocol
 				end
 			end
 			
-			# Get the value of the specified header key.
-			#
-			# @parameter key [String] The header key.
-			# @returns [String | Array | Object] The header value.
-			def [] key
-				to_h[key]
-			end
-			
 			# Compute a hash table of headers, where the keys are normalized to lower case and the values are normalized according to the policy for that header.
 			#
 			# @returns [Hash] A hash table of `{key, value}` pairs.

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.55.0"
+		VERSION = "0.56.0"
 	end
 end

data/readme.md

@@ -30,6 +30,14 @@ 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.56.0
+
+  - Introduce `Header::*.parse(value)` which parses a raw header value string into a header instance.
+  - Introduce `Header::*.coerce(value)` which coerces any value (`String`, `Array`, etc.) into a header instance with normalization.
+  - `Header::*#initialize` now accepts arrays without normalization for efficiency, or strings for backward compatibility.
+  - Update `Headers#[]=` to use `coerce(value)` for smart conversion of user input.
+  - Normalization (e.g., lowercasing) is applied by `parse`, `coerce`, and `<<` methods, but not by `new` when given arrays.
+
 ### v0.55.0
 
   - **Breaking**: Move `Protocol::HTTP::Header::QuotedString` to `Protocol::HTTP::QuotedString` for better reusability.
@@ -78,10 +86,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http/relea
   - Clarify behaviour of streaming bodies and copy `Protocol::Rack::Body::Streaming` to `Protocol::HTTP::Body::Streamable`.
   - Copy `Async::HTTP::Body::Writable` to `Protocol::HTTP::Body::Writable`.
 
-### v0.31.0
-
-  - Ensure chunks are flushed if required, when streaming.
-
 ## See Also
 
   - [protocol-http1](https://github.com/socketry/protocol-http1) — HTTP/1 client/server implementation using this

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.56.0
+
+  - Introduce `Header::*.parse(value)` which parses a raw header value string into a header instance.
+  - Introduce `Header::*.coerce(value)` which coerces any value (`String`, `Array`, etc.) into a header instance with normalization.
+  - `Header::*#initialize` now accepts arrays without normalization for efficiency, or strings for backward compatibility.
+  - Update `Headers#[]=` to use `coerce(value)` for smart conversion of user input.
+  - Normalization (e.g., lowercasing) is applied by `parse`, `coerce`, and `<<` methods, but not by `new` when given arrays.
+
 ## v0.55.0
 
   - **Breaking**: Move `Protocol::HTTP::Header::QuotedString` to `Protocol::HTTP::QuotedString` for better reusability.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.55.0
+  version: 0.56.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -134,7 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Provides abstractions to handle HTTP protocols.
 test_files: []

metadata.gz.sig

@@ -1,3 +1,3 @@
-����&1>[�.�]�k��iտ	�GZ^��a��Ak��8�-�$\t�:&�7Ն���=���@r~ܔ�ʌ3b͐�)���:�5���—�c��kgV�~z����2$cog���O�
-K��\�үm�����������J��{B��Y��������w
�n����c@�>O1י\�4[�"��p�wlX�0�b��iT�u�2���Fݴ��Y�L:ȼIs�C��{ҙK�K-'��x"�����@3eͦa1�x�EЋ##�m΀���p��	F@E,Y�u;�J0�n�P�ц�?�S��mh�c=�:�Z��%��:����Cus�uK�
-0��ç�4�\�a�	{��8o�G�Z
+�R�}��k�Q�y*���lk�J�C�ߏ�A�]vQ=/-w��ݷ%��L9��C���#��5w��g���d^�x�xt����(=�
	s�ιrX�����gڳ
+�T�N9�o
+�!t
�Dϗ�Wv��-���z
+��zQY����*}���|��U�
:��5v� U��C�z���,Aċ�s�t���=����F���A��t�v>&