protocol-http 0.54.0 → 0.56.0

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

@@ -4,7 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require_relative "split"
-require_relative "quoted_string"
+require_relative "../quoted_string"
 require_relative "../error"
 
 module Protocol
@@ -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/quoted_string.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+module Protocol
+	module HTTP
+		# According to https://tools.ietf.org/html/rfc7231#appendix-C
+		TOKEN = /[!#$%&'*+\-.^_`|~0-9A-Z]+/i
+		
+		QUOTED_STRING = /"(?:.(?!(?<!\\)"))*.?"/
+		
+		# https://tools.ietf.org/html/rfc7231#section-5.3.1
+		QVALUE = /0(\.[0-9]{0,3})?|1(\.[0]{0,3})?/
+		
+		# Handling of HTTP quoted strings.
+		module QuotedString
+			# Unquote a "quoted-string" value according to <https://tools.ietf.org/html/rfc7230#section-3.2.6>. It should already match the QUOTED_STRING pattern above by the parser.
+			def self.unquote(value, normalize_whitespace = true)
+				value = value[1...-1]
+				
+				value.gsub!(/\\(.)/, '\1')
+				
+				if normalize_whitespace
+					# LWS = [CRLF] 1*( SP | HT )
+					value.gsub!(/[\r\n]+\s+/, " ")
+				end
+				
+				return value
+			end
+			
+			QUOTES_REQUIRED = /[()<>@,;:\\"\/\[\]?={} \t]/
+			
+			# Quote a string for HTTP header values if required.
+			#
+			# @raises [ArgumentError] if the value contains invalid characters like control characters or newlines.
+			def self.quote(value, force = false)
+				# Check if quoting is required:
+				if value =~ QUOTES_REQUIRED or force
+					"\"#{value.gsub(/["\\]/, '\\\\\0')}\""
+				else
+					value
+				end
+			end
+		end
+	end
+end

data/lib/protocol/http/version.rb

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

data/readme.md

@@ -22,10 +22,6 @@ Please see the [project documentation](https://socketry.github.io/protocol-http/
 
   - [Middleware](https://socketry.github.io/protocol-http/guides/middleware/index) - This guide explains how to build and use HTTP middleware with `Protocol::HTTP::Middleware`.
 
-  - [Hypertext References](https://socketry.github.io/protocol-http/guides/hypertext-references/index) - This guide explains how to use `Protocol::HTTP::Reference` for constructing and manipulating hypertext references (URLs with parameters).
-
-  - [URL Parsing](https://socketry.github.io/protocol-http/guides/url-parsing/index) - This guide explains how to use `Protocol::HTTP::URL` for parsing and manipulating URL components, particularly query strings and parameters.
-
   - [Streaming](https://socketry.github.io/protocol-http/guides/streaming/index) - This guide gives an overview of how to implement streaming requests and responses.
 
   - [Design Overview](https://socketry.github.io/protocol-http/guides/design-overview/index) - This guide explains the high level design of `protocol-http` in the context of wider design patterns that can be used to implement HTTP clients and servers.
@@ -34,6 +30,23 @@ 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.
+  - **Breaking**: Handle cookie key/value pairs using `QuotedString` as per RFC 6265.
+      - Don't use URL encoding for cookie key/value.
+  - **Breaking**: Remove `Protocol::HTTP::URL` and `Protocol::HTTP::Reference` – replaced by `Protocol::URL` gem.
+      - `Protocol::HTTP::URL` -\> `Protocol::URL::Encoding`.
+      - `Protocol::HTTP::Reference` -\> `Protocol::URL::Reference`.
+
 ### v0.54.0
 
   - Introduce rich support for `Header::Digest`, `Header::ServerTiming`, `Header::TE`, `Header::Trailer` and `Header::TransferEncoding`.
@@ -73,21 +86,13 @@ 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.
-
-### v0.30.0
-
-  - [`Request[]` and `Response[]` Keyword Arguments](https://socketry.github.io/protocol-http/releases/index#request[]-and-response[]-keyword-arguments)
-  - [Interim Response Handling](https://socketry.github.io/protocol-http/releases/index#interim-response-handling)
-
 ## See Also
 
   - [protocol-http1](https://github.com/socketry/protocol-http1) — HTTP/1 client/server implementation using this
     interface.
   - [protocol-http2](https://github.com/socketry/protocol-http2) — HTTP/2 client/server implementation using this
     interface.
+  - [protocol-url](https://github.com/socketry/protocol-url) — URL parsing and manipulation library.
   - [async-http](https://github.com/socketry/async-http) — Asynchronous HTTP client and server, supporting multiple HTTP
     protocols & TLS.
   - [async-websocket](https://github.com/socketry/async-websocket) — Asynchronous client and server WebSockets.

data/releases.md

@@ -1,5 +1,22 @@
 # 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.
+  - **Breaking**: Handle cookie key/value pairs using `QuotedString` as per RFC 6265.
+      - Don't use URL encoding for cookie key/value.
+  - **Breaking**: Remove `Protocol::HTTP::URL` and `Protocol::HTTP::Reference` – replaced by `Protocol::URL` gem.
+      - `Protocol::HTTP::URL` -\> `Protocol::URL::Encoding`.
+      - `Protocol::HTTP::Reference` -\> `Protocol::URL::Reference`.
+
 ## v0.54.0
 
   - Introduce rich support for `Header::Digest`, `Header::ServerTiming`, `Header::TE`, `Header::Trailer` and `Header::TransferEncoding`.
@@ -125,3 +142,160 @@ def call(request)
 	# ...
 end
 ```
+
+## v0.29.0
+
+  - Introduce `rewind` and `rewindable?` methods for body rewinding capabilities.
+  - Add support for output buffer in `read_partial`/`readpartial` methods.
+  - `Reader#buffered!` now returns `self` for method chaining.
+
+## v0.28.0
+
+  - Add convenient `Reader#buffered!` method to buffer the body.
+  - Modernize gem infrastructure with RuboCop integration.
+
+## v0.27.0
+
+  - Expand stream interface to support `gets`/`puts` operations.
+  - Skip empty key/value pairs in header processing.
+  - Prefer lowercase method names for consistency.
+  - Add `as_json` support to avoid default Rails implementation.
+  - Use `@callback` to track invocation state.
+  - Drop `base64` gem dependency.
+
+## v0.26.0
+
+  - Prefer connection `close` over `keep-alive` when both are present.
+  - Add support for `#readpartial` method.
+  - Add `base64` dependency.
+
+## v0.25.0
+
+  - Introduce explicit support for informational responses (1xx status codes).
+  - Add `cache-control` support for `must-revalidate`, `proxy-revalidate`, and `s-maxage` directives.
+  - Add `#strong_match?` and `#weak_match?` methods to `ETags` header.
+  - Fix `last-modified`, `if-modified-since` and `if-unmodified-since` headers to use proper `Date` parsing.
+  - Improve date/expires header parsing.
+  - Add tests for `Stream#close_read`.
+  - Check if input is closed before raising `IOError`.
+  - Ensure saved files truncate existing file by default.
+
+## v0.24.0
+
+  - Add output stream `#<<` as alias for `#write`.
+  - Add support for `Headers#include?` and `#key?` methods.
+  - Fix URL unescape functionality.
+  - Fix cookie parsing issues.
+  - Fix superclass mismatch in `Protocol::HTTP::Middleware::Builder`.
+  - Allow trailers without explicit `trailer` header.
+  - Fix cookie handling and Ruby 2 keyword arguments.
+
+## v0.23.0
+
+  - Improve argument handling.
+  - Rename `path` parameter to `target` to better match RFCs.
+
+## v0.22.0
+
+  - Rename `trailers` to `trailer` for consistency.
+
+## v0.21.0
+
+  - Streaming interface improvements.
+  - Rename `Streamable` to `Completable`.
+
+## v0.20.0
+
+  - Improve `Authorization` header implementation.
+
+## v0.19.0
+
+  - Expose `Body#ready?` for more efficient response handling.
+
+## v0.18.0
+
+  - Add `#trailers` method which enumerates trailers without marking tail.
+  - Don't clear trailers in `#dup`, move functionality to `flatten!`.
+  - All requests and responses must have mutable headers instance.
+
+## v0.17.0
+
+  - Remove deferred headers due to complexity.
+  - Remove deprecated `Headers#slice!`.
+  - Add support for static, dynamic and streaming content to `cache-control` model.
+  - Initial support for trailers.
+  - Add support for `Response#not_modified?`.
+
+## v0.16.0
+
+  - Add support for `if-match` and `if-none-match` headers.
+  - Revert `Request#target` change for HTTP/2 compatibility.
+
+## v0.15.0
+
+  - Prefer `Request#target` over `Request#path`.
+  - Add body implementation to support HEAD requests.
+  - Add support for computing digest on buffered body.
+  - Add `Headers#set(key, value)` to replace existing values.
+  - Add support for `vary` header.
+  - Add support for `no-cache` & `no-store` cache directives.
+
+## v0.14.0
+
+  - Add `Cacheable` body for buffering and caching responses.
+  - Add support for `cache-control` header.
+
+## v0.13.0
+
+  - Add support for `connection` header.
+  - Fix handling of keyword arguments.
+
+## v0.12.0
+
+  - Improved handling of `cookie` header.
+  - Add `Headers#clear` method.
+
+## v0.11.0
+
+  - Ensure `Body#call` invokes `stream.close` when done.
+
+## v0.10.0
+
+  - Allow user to specify size for character devices.
+
+## v0.9.1
+
+  - Add support for `authorization` header.
+
+## v0.8.0
+
+  - Remove `reason` from `Response`.
+
+## v0.7.0
+
+  - Explicit path handling in `Reference#with`.
+
+## v0.6.0
+
+  - Initial version with basic HTTP protocol support.
+
+## v0.5.1
+
+  - Fix path splitting behavior when path is empty.
+  - Add `connect` method.
+  - Support protocol in `[]` constructor.
+  - Incorporate middleware functionality.
+
+## v0.4.0
+
+  - Add `Request`, `Response` and `Body` classes from `async-http`.
+  - Allow deletion of non-existent header fields.
+
+## v0.3.0
+
+  - **Initial release** of `protocol-http` gem.
+  - Initial implementation of HTTP/2 flow control.
+  - Support for connection preface and settings frames.
+  - Initial headers support.
+  - Implementation of `Connection`, `Client` & `Server` classes.
+  - HTTP/2 protocol framing and headers.

metadata

@@ -1,20 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.56.0
 platform: ruby
 authors:
 - Samuel Williams
 - Thomas Morgan
 - Bruno Sutic
 - Herrick Fang
+- William T. Nelson
 - Bryan Powell
 - Dan Olson
 - Earlopain
 - Genki Takiuchi
 - Marcelo Junior
 - Olle Jonsson
-- William T. Nelson
 - Yuta Iwama
 bindir: bin
 cert_chain:
@@ -96,7 +96,6 @@ files:
 - lib/protocol/http/header/etags.rb
 - lib/protocol/http/header/multiple.rb
 - lib/protocol/http/header/priority.rb
-- lib/protocol/http/header/quoted_string.rb
 - lib/protocol/http/header/server_timing.rb
 - lib/protocol/http/header/split.rb
 - lib/protocol/http/header/te.rb
@@ -108,10 +107,9 @@ files:
 - lib/protocol/http/middleware.rb
 - lib/protocol/http/middleware/builder.rb
 - lib/protocol/http/peer.rb
-- lib/protocol/http/reference.rb
+- lib/protocol/http/quoted_string.rb
 - lib/protocol/http/request.rb
 - lib/protocol/http/response.rb
-- lib/protocol/http/url.rb
 - lib/protocol/http/version.rb
 - license.md
 - readme.md

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

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
-
-module Protocol
-	module HTTP
-		module Header
-			# According to https://tools.ietf.org/html/rfc7231#appendix-C
-			TOKEN = /[!#$%&'*+\-.^_`|~0-9A-Z]+/i
-			
-			QUOTED_STRING = /"(?:.(?!(?<!\\)"))*.?"/
-			
-			# https://tools.ietf.org/html/rfc7231#section-5.3.1
-			QVALUE = /0(\.[0-9]{0,3})?|1(\.[0]{0,3})?/
-			
-			# Handling of HTTP quoted strings.
-			module QuotedString
-				# Unquote a "quoted-string" value according to <https://tools.ietf.org/html/rfc7230#section-3.2.6>. It should already match the QUOTED_STRING pattern above by the parser.
-				def self.unquote(value, normalize_whitespace = true)
-					value = value[1...-1]
-					
-					value.gsub!(/\\(.)/, '\1')
-					
-					if normalize_whitespace
-						# LWS = [CRLF] 1*( SP | HT )
-						value.gsub!(/[\r\n]+\s+/, " ")
-					end
-					
-					return value
-				end
-				
-				QUOTES_REQUIRED = /[()<>@,;:\\"\/\[\]?={} \t]/
-				
-				# Quote a string for HTTP header values if required.
-				#
-				# @raises [ArgumentError] if the value contains invalid characters like control characters or newlines.
-				def self.quote(value, force = false)
-					# Check if quoting is required:
-					if value =~ QUOTES_REQUIRED or force
-						"\"#{value.gsub(/["\\]/, '\\\\\0')}\""
-					else
-						value
-					end
-				end
-			end
-		end
-	end
-end