protocol-url 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38bcf53ee312963527020be6c4a4c18697587ad4ecd75277552b1dbd744e0ec9
-  data.tar.gz: 85f2886788dfec25b6799f3c92d79f8bb31fbb5f48f3b017fca94993a21b507b
+  metadata.gz: 251219144c71f40dba05ef7ad726a20b17c94beb55733317a9378e000528575b
+  data.tar.gz: 81be14b9dd98770859406b28a658604ea356791173c4d352d52487735364dafe
 SHA512:
-  metadata.gz: c5870caa5923cc4918e909470522231f132946f3235a8b396dff155adcab311ab0a1743da9ae1de96c92d2427c6e61cb758760dc2a3133005c4b0929225a4af5
-  data.tar.gz: 820c6b061491cd83b553f38b5d53573cc641d76ad63be859e2835698e0b7242ae908763758b1730dd3b56a3f5a82dfe11d2f2de0cfafe12bd87ef66d4e405c17
+  metadata.gz: 48b8dcae7d84dacf3bb49ce45b84d308dd2c7f0377b97e84f4d9530d4a2467d04b16a76186b3859c8fc3052da50117b197dc6a5ebc503a2568126255c234c43c
+  data.tar.gz: 85c632aa585bec3155f294becdee9e904b8f424bab0ef95944c15e563c7e6a5ec2a26ad8a0941ad198ce50a65fec43c84187f76dc596c6dc4bbbd879dcef7b8d

data/lib/protocol/url/error.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Protocol
+	module URL
+		# Raised when URL processing exceeds a configured limit.
+		class LimitError < StandardError
+		end
+	end
+end

data/lib/protocol/url/form_data/nested.rb

@@ -4,19 +4,20 @@
 # Copyright, 2026, by Samuel Williams.
 
 require_relative "../encoding"
+require_relative "../error"
 
 module Protocol
 	module URL
 		module FormData
 			# Builds nested form data from names and values.
 			class Nested
-				# The default maximum depth of a bracketed form name.
-				MAXIMUM_DEPTH = 8
+				# The bracketed form name depth limit.
+				DEPTH_LIMIT = 8
 				
 				# Initialize the nested form data.
-				# @parameter maximum_depth [Integer | Nil] The maximum depth of a bracketed form name.
-				def initialize(maximum_depth: MAXIMUM_DEPTH)
-					@maximum_depth = maximum_depth
+				# @parameter depth_limit [Integer | Nil] The bracketed form name depth limit.
+				def initialize(depth_limit: DEPTH_LIMIT)
+					@depth_limit = depth_limit
 					@root = {}
 				end
 				
@@ -31,8 +32,8 @@ module Protocol
 						raise ArgumentError, "Invalid form data name: #{name.inspect}!"
 					end
 					
-					if @maximum_depth and keys.size > @maximum_depth
-						raise RangeError, "Form data depth exceeded limit of #{@maximum_depth}!"
+					if @depth_limit and keys.size > @depth_limit
+						raise LimitError, "Form data depth exceeded limit of #{@depth_limit}!"
 					end
 					
 					Encoding.assign(keys, value, @root)

data/lib/protocol/url/form_data/parser.rb

@@ -4,6 +4,7 @@
 # Copyright, 2026, by Samuel Williams.
 
 require_relative "nested"
+require_relative "../error"
 
 module Protocol
 	module URL
@@ -13,20 +14,20 @@ module Protocol
 			class Parser
 				CONTENT_TYPE = "application/x-www-form-urlencoded"
 				
-				# The default maximum encoded body size.
-				MAXIMUM_TOTAL_SIZE = 2 * 1024 * 1024
+				# The encoded body size limit.
+				SIZE_LIMIT = 2 * 1024 * 1024
 				
-				# The default maximum number of form pairs.
-				MAXIMUM_PAIR_COUNT = 1024
+				# The form pair count limit.
+				PAIR_COUNT_LIMIT = 1024
 				
 				# Initialize the form data parser.
-				# @parameter maximum_total_size [Integer | Nil] The maximum encoded body size.
-				# @parameter maximum_pair_count [Integer | Nil] The maximum number of form pairs.
-				# @parameter maximum_depth [Integer | Nil] The maximum depth of a bracketed form name.
-				def initialize(maximum_total_size: MAXIMUM_TOTAL_SIZE, maximum_pair_count: MAXIMUM_PAIR_COUNT, maximum_depth: Nested::MAXIMUM_DEPTH)
-					@maximum_total_size = maximum_total_size
-					@maximum_pair_count = maximum_pair_count
-					@maximum_depth = maximum_depth
+				# @parameter size_limit [Integer | Nil] The encoded body size limit.
+				# @parameter pair_count_limit [Integer | Nil] The form pair count limit.
+				# @parameter depth_limit [Integer | Nil] The bracketed form name depth limit.
+				def initialize(size_limit: SIZE_LIMIT, pair_count_limit: PAIR_COUNT_LIMIT, depth_limit: Nested::DEPTH_LIMIT)
+					@size_limit = size_limit
+					@pair_count_limit = pair_count_limit
+					@depth_limit = depth_limit
 				end
 				
 				# Parse URL-encoded form data into a nested hash.
@@ -54,14 +55,14 @@ module Protocol
 					return to_enum(__method__, body) unless block_given?
 					
 					buffer = String.new.b
-					total_size = 0
+					size = 0
 					pair_count = 0
 					
 					while chunk = body.read
 						break if chunk.empty?
 						
-						total_size += chunk.bytesize
-						check_limit(:total_size, total_size, @maximum_total_size)
+						size += chunk.bytesize
+						check_limit(:size, size, @size_limit)
 						buffer << chunk
 						
 						while separator = buffer.index("&")
@@ -70,7 +71,7 @@ module Protocol
 							
 							unless assignment.empty?
 								pair_count += 1
-								check_limit(:pair_count, pair_count, @maximum_pair_count)
+								check_limit(:pair_count, pair_count, @pair_count_limit)
 								yield_pair(assignment) {|name, value| yield name, value}
 							end
 						end
@@ -78,7 +79,7 @@ module Protocol
 					
 					unless buffer.empty?
 						pair_count += 1
-						check_limit(:pair_count, pair_count, @maximum_pair_count)
+						check_limit(:pair_count, pair_count, @pair_count_limit)
 						yield_pair(buffer) {|name, value| yield name, value}
 					end
 					
@@ -88,7 +89,7 @@ module Protocol
 				private
 				
 				def make_result
-					return Nested.new(maximum_depth: @maximum_depth)
+					return Nested.new(depth_limit: @depth_limit)
 				end
 				
 				def yield_pair(assignment)
@@ -105,9 +106,9 @@ module Protocol
 					return Encoding.unescape(component.tr("+", " "))
 				end
 				
-				def check_limit(name, value, maximum)
-					if maximum and value > maximum
-						raise RangeError, "Form data #{name} exceeded limit of #{maximum}!"
+				def check_limit(name, value, limit)
+					if limit and value > limit
+						raise LimitError, "Form data #{name} exceeded limit of #{limit}!"
 					end
 				end
 			end

data/lib/protocol/url/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module URL
-		VERSION = "0.7.0"
+		VERSION = "0.9.0"
 	end
 end

data/lib/protocol/url.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require_relative "url/version"
+require_relative "url/error"
 require_relative "url/pattern"
 require_relative "url/encoding"
 require_relative "url/form_data/nested"

data/readme.md

@@ -34,6 +34,14 @@ This project is best served by a collaborative and respectful environment. Treat
 
 Please see the [project releases](https://socketry.github.io/protocol-url/releases/index) for all releases.
 
+### v0.9.0
+
+  - Add `Protocol::URL::LimitError` for configured processing limits.
+
+### v0.8.0
+
+  - Use consistent limit naming for form data parser constraints.
+
 ### v0.7.0
 
   - Allow `Protocol::URL::FormData::Parser#parse` to populate a supplied result object.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.9.0
+
+  - Add `Protocol::URL::LimitError` for configured processing limits.
+
+## v0.8.0
+
+  - Use consistent limit naming for form data parser constraints.
+
 ## v0.7.0
 
   - Allow `Protocol::URL::FormData::Parser#parse` to populate a supplied result object.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-url
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -45,6 +45,7 @@ files:
 - lib/protocol/url.rb
 - lib/protocol/url/absolute.rb
 - lib/protocol/url/encoding.rb
+- lib/protocol/url/error.rb
 - lib/protocol/url/form_data/nested.rb
 - lib/protocol/url/form_data/parser.rb
 - lib/protocol/url/path.rb