protocol-http 0.69.0 → 0.70.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e15c95aaaa592e283652205e025ad4473e3f082865506604799bb8eaadf06368
-  data.tar.gz: 10b0bf633c92acbec2fb96a70e5693060cab025e2df7ea45aaad410ba9c7afad
+  metadata.gz: 0bb8c2ea5ebb91d57bce473ec02b7cde1a0ca205194f7d60776114ec385abe09
+  data.tar.gz: 2c5bfedf8006d995f3959fe7dcf7c81b720633bccc44b05e80e1fd227a6002b1
 SHA512:
-  metadata.gz: 99165410a3df8b9efef707e17e1ea31befa3510a65c111a77d17270ffb9167f15d36d6bc64512ee2d7aea2ff3cf5087379e7826ce54595087f89d227eb42f9b6
-  data.tar.gz: 297e0e29550b333cfa5f35005263e9762ff8afc64c6ca9e1f76ca1fcfb0c0b9ea3a7364f81f8349aced4b9aa018d7892b5362863896d0827f0d4daec9fd0c648
+  metadata.gz: d42efaceae6b232ddd02d0d07dbe1a710da7e68315664c58b0e691fb47d195d6bd13ac8caeb9fda0e7a17c994e9aceb8c3811d40e6cea71eeb34492db7cc0598
+  data.tar.gz: be0a550a6038da525c836c4cd1219b4587a3fe9731c9e399c5c1b5a5cdd7fe633e8b9d5322e0aad0c4a4b39c0ca4122052fd5e7362afbf9ceddd72bb0de1a6c1

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

@@ -107,6 +107,15 @@ module Protocol
 					end
 				end
 				
+				# Parse the `accept` header and order media ranges by preference.
+				#
+				# Media ranges with equal quality factors retain their original relative order.
+				#
+				# @returns [Array(MediaRange)] the preferred media ranges.
+				def preferred_media_ranges
+					sort_by_quality_factor(media_ranges)
+				end
+				
 				private
 				
 				def parse_media_range(value)

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

@@ -47,6 +47,15 @@ module Protocol
 						end
 					end
 				end
+				
+				# Parse the `accept-charset` header and order character sets by preference.
+				#
+				# Character sets with equal quality factors retain their original relative order.
+				#
+				# @returns [Array(Charset)] the preferred character sets.
+				def preferred_charsets
+					sort_by_quality_factor(charsets)
+				end
 			end
 		end
 	end

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

@@ -50,6 +50,15 @@ module Protocol
 						end
 					end
 				end
+				
+				# Parse the `accept-encoding` header and order encodings by preference.
+				#
+				# Encodings with equal quality factors retain their original relative order.
+				#
+				# @returns [Array(Encoding)] the preferred encodings.
+				def preferred_encodings
+					sort_by_quality_factor(encodings)
+				end
 			end
 		end
 	end

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

@@ -53,6 +53,15 @@ module Protocol
 						end
 					end
 				end
+				
+				# Parse the `accept-language` header and order languages by preference.
+				#
+				# Languages with equal quality factors retain their original relative order.
+				#
+				# @returns [Array(Language)] the preferred languages.
+				def preferred_languages
+					sort_by_quality_factor(languages)
+				end
 			end
 		end
 	end

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

@@ -77,6 +77,14 @@ module Protocol
 				end
 				
 			protected
+				# Order weighted values by descending quality while preserving their relative order.
+				# @parameter values [Enumerable] The values which respond to `#quality_factor`.
+				# @returns [Array] The ordered values.
+				def sort_by_quality_factor(values)
+					values.sort_by.with_index do |value, index|
+						[-value.quality_factor, index]
+					end
+				end
 				
 				def reverse_find(&block)
 					reverse_each do |value|

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

@@ -113,6 +113,15 @@ module Protocol
 					end
 				end
 				
+				# Parse the `te` header and order transfer codings by preference.
+				#
+				# Transfer codings with equal quality factors retain their original relative order.
+				#
+				# @returns [Array(TransferCoding)] the preferred transfer codings.
+				def preferred_transfer_codings
+					sort_by_quality_factor(transfer_codings)
+				end
+				
 				# @returns [Boolean] whether the `chunked` encoding is accepted.
 				def chunked?
 					self.any?{|value| value.start_with?(CHUNKED)}

data/lib/protocol/http/version.rb

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

data/readme.md

@@ -30,6 +30,10 @@ 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.70.0
+
+  - Add stable preference ordering for weighted `Accept`, `Accept-Charset`, `Accept-Encoding`, `Accept-Language`, and `TE` values.
+
 ### v0.69.0
 
   - Add `Protocol::HTTP::Body::Readable#to_io` for obtaining an IO-compatible stream adapter.
@@ -68,10 +72,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http/relea
 
   - Introduce `Protocol::HTTP::RefusedError` for indicating a stream or request was refused before processing and can be safely retried. `RequestRefusedError` is provided as an alias for backwards compatibility.
 
-### v0.60.0
-
-  - Expose `Protocol::HTTP::Body::Writable#count` attribute to provide access to the number of chunks written to the body.
-
 ## See Also
 
   - [protocol-http1](https://github.com/socketry/protocol-http1) — HTTP/1 client/server implementation using this

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.70.0
+
+  - Add stable preference ordering for weighted `Accept`, `Accept-Charset`, `Accept-Encoding`, `Accept-Language`, and `TE` values.
+
 ## v0.69.0
 
   - Add `Protocol::HTTP::Body::Readable#to_io` for obtaining an IO-compatible stream adapter.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.69.0
+  version: 0.70.0
 platform: ruby
 authors:
 - Samuel Williams