protocol-url 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38bcf53ee312963527020be6c4a4c18697587ad4ecd75277552b1dbd744e0ec9
-  data.tar.gz: 85f2886788dfec25b6799f3c92d79f8bb31fbb5f48f3b017fca94993a21b507b
+  metadata.gz: 0e251b8fa72bc3017a56cfa385bf2bc7b9e1e4ef8add2bcd12fb8321cc349c75
+  data.tar.gz: 700835c1db54aead624eb89003c7daa42d9ad992f7139c336e2a5293291db619
 SHA512:
-  metadata.gz: c5870caa5923cc4918e909470522231f132946f3235a8b396dff155adcab311ab0a1743da9ae1de96c92d2427c6e61cb758760dc2a3133005c4b0929225a4af5
-  data.tar.gz: 820c6b061491cd83b553f38b5d53573cc641d76ad63be859e2835698e0b7242ae908763758b1730dd3b56a3f5a82dfe11d2f2de0cfafe12bd87ef66d4e405c17
+  metadata.gz: 6285b5b91ba997d2f822fcc4ffd49b96dffcc1336483bd043f42a736dfb3bbe4e145e492044a201de1c8f0f3e363ae816d64af79e0412b2ce4715ec69e3b4d9c
+  data.tar.gz: 6e4c0817905afb9b17e8e0eceae42e7ea24d6c0af6a57773d7395355b2e7b597d043c9d7795ddf62194790f0a3f53f6346d7950598721c4b079e7a419e95f793

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

@@ -10,13 +10,13 @@ module Protocol
 		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 +31,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 RangeError, "Form data depth exceeded limit of #{@depth_limit}!"
 					end
 					
 					Encoding.assign(keys, value, @root)

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

@@ -13,20 +13,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 +54,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 +70,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 +78,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 +88,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 +105,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 RangeError, "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.8.0"
 	end
 end

data/readme.md

@@ -34,6 +34,10 @@ 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.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,9 @@
 # Releases
 
+## 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.8.0
 platform: ruby
 authors:
 - Samuel Williams