protocol-http 0.46.0 → 0.47.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 753df89051cc0eeff1cab5100a4ebc2a98e11bd3dce4a3fbcba890406c198c32
-  data.tar.gz: dbc6b80efe3fc8a430839868f160151a9490336cc39423e31cfd851076b72947
+  metadata.gz: d8281f44eb94360f117cba9ef4770386d57b72049ec2200e45041f7b93193147
+  data.tar.gz: 0e93ed313a1a91971568b575b58db52857f15da6a92fe8764294f2b6ef2335c6
 SHA512:
-  metadata.gz: 104b449c9a3beaaf7f3c50e28eb21df3f2bef95b89ec954bd20a808a09b508f69d8e0387d6b41ed8e7dc02e41a85bc1116ff8f775694c4e0b26c3899b248f310
-  data.tar.gz: 3ea2e87c3375055aa89f8d9b73b549854cb53ecb90bf6ee3f75ffc4c4ae8b7fbb61b10119fbdb0d125287aea03c894c7327b79ee410d28a771faab24e2fcafa5
+  metadata.gz: 4f5765e41ef7706b20f8c82812099dc5e79fa6f5c9036332688e5dde9ea0a41a52d44a2442aa33d3514f977939f70c32b40fa858179d4bada70df5b70227e7ab
+  data.tar.gz: 8835f1c4351794d80db3c917b374648a2090c89619b9bd9deb556955a86eb230118814930d2b8d363838b49f0d2a75d7cee0f8f91bbc2393146cc8cecc9c4f68

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

@@ -10,54 +10,46 @@ module Protocol
 		module Header
 			# Represents the `priority` header, used to indicate the relative importance of an HTTP request.
 			#
-			# The `priority` header allows clients to express their preference for how resources should be prioritized by the server. It can include directives like `urgency` to specify the importance of a request, and `progressive` to indicate whether a response can be delivered incrementally.
+			# 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
-				# Urgency levels as defined in RFC 9218:
-				#
-				# These levels indicate the relative importance of a request, helping servers and intermediaries allocate resources efficiently. Properly setting urgency can significantly improve user-perceived performance by prioritizing critical content and deferring less important tasks.
-				module Urgency
-					# `background` priority indicates a request that is not time-sensitive and can be processed with minimal impact to other tasks. It is ideal for requests like analytics or logging, which do not directly impact the user's current experience.
-					BACKGROUND = "background"
-					
-					# `low` priority indicates a request that is important but not critical. It is suitable for content like non-blocking images, videos, or scripts that enhance the experience but do not affect core functionality.
-					LOW = "low"
-					
-					# `normal` priority (default) indicates the standard priority for most requests. It is appropriate for content like text, CSS, or essential images that are necessary for the primary user experience but do not require urgent delivery.
-					NORMAL = "normal"
-					
-					# `high` priority indicates the highest priority, used for requests that are essential and time-critical to the user experience. Examples include content above-the-fold on a webpage, critical API calls, or resources required for rendering.
-					HIGH = "high"
-				end
-				
-				# The `progressive` flag indicates that the response can be delivered incrementally (progressively) as data becomes available. This is particularly useful for large resources like images or video streams, where partial delivery improves the user experience by allowing content to render or play before the full response is received.
-				PROGRESSIVE = "progressive"
-				
 				# Initialize the priority header with the given value.
 				#
-				# @parameter value [String | Nil] the value of the priority header, if any.
+				# @parameter value [String | Nil] the value of the priority header, if any. The value should be a comma-separated string of directives.
 				def initialize(value = nil)
 					super(value&.downcase)
 				end
 				
 				# Add a value to the priority header.
+				#
+				# @parameter value [String] the directive to add to the header.
 				def << value
 					super(value.downcase)
 				end
 				
-				# Returns the urgency level if specified.
+				# The default urgency level if not specified.
+				DEFAULT_URGENCY = 3
+				
+				# The urgency level, if specified using `u=`. 0 is the highest priority, and 7 is the lowest.
+				#
+				# Note that when duplicate Dictionary keys are encountered, all but the last instance are ignored.
 				#
-				# @returns [String | Nil] the urgency level if specified, or `nil`.
-				def urgency
-					if value = self.find{|value| value.start_with?("urgency=")}
+				# @returns [Integer | Nil] the urgency level if specified, or `nil` if not present.
+				def urgency(default = DEFAULT_URGENCY)
+					if value = self.reverse_find{|value| value.start_with?("u=")}
 						_, level = value.split("=", 2)
-						
-						return level
+						return Integer(level)
 					end
+					
+					return default
 				end
 				
-				# @returns [Boolean] whether the request should be delivered progressively.
-				def progressive?
-					self.include?(PROGRESSIVE)
+				# Checks if the response should be delivered incrementally.
+				#
+				# The `i` directive, when present, indicates that the response can be delivered incrementally as data becomes available.
+				#
+				# @returns [Boolean] whether the request should be delivered incrementally.
+				def incremental?
+					self.include?("i")
 				end
 			end
 		end

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

@@ -39,6 +39,16 @@ module Protocol
 				def to_s
 					join(",")
 				end
+				
+				protected
+				
+				def reverse_find(&block)
+					reverse_each do |value|
+						return value if block.call(value)
+					end
+					
+					return nil
+				end
 			end
 		end
 	end

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.46.0"
+		VERSION = "0.47.1"
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.47.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -47,7 +47,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-11-28 00:00:00.000000000 Z
+date: 2024-12-04 00:00:00.000000000 Z
 dependencies: []
 description:
 email: