protocol-multipart 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 891a0cd8210426411b1b44e2304bdfb282ab907adf1f3bf53089b2ecd6407a44
-  data.tar.gz: 7d24bcf5941c609e11dea28e1554e03c8696282a90f5d344c3aad580fa1484de
+  metadata.gz: 6a837f15946884597a70197efe8b11ecb4826bdb7c504eee9a60fe1b1d6e0666
+  data.tar.gz: 0c0c373cddf15634d278db2dc3ab8fea3db9055712d719356c4507ea68c2022c
 SHA512:
-  metadata.gz: f515cd40482a06d977d689f2d43a917aef4193f5bbd2e23d0fe7b13fdc5984d42fbe5a8841736ac1d3deb1e9fa8ced71788ec17d5aacd4cedd2e17f3ac75219e
-  data.tar.gz: e96bc422119c3c7001b3e6588281964ebab9445a6a52e8293ffb1035f01172a2f77e6497db43f36b2cd7cf4cbc319714c8352c4ae4946d8d9dbc0bc87e7d5441
+  metadata.gz: '039281289f4c94fca34ba72ad62d58be53fba69571f355e6f5ceb1c01580900d8bbc7470ca167866c336f357d6568dfc8b2c63b766c1aed1dd0fd69b2b2d039d'
+  data.tar.gz: 821046db0d9fdbb001dc4dbcace537bdbbf5d04b80d0916643787f04741c53cbf5ba8bbb78b0a022cc19fbf43c9b81eb5639aaced247c06c4d2a864247d1efef

data/lib/protocol/multipart/byte_limit.rb

@@ -3,6 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2026, by Samuel Williams.
 
+require_relative "error"
+
 module Protocol
 	module Multipart
 		# Tracks consumed bytes against an optional maximum.
@@ -30,7 +32,7 @@ module Protocol
 				@size += size
 				
 				if @maximum and @size > @maximum
-					raise RangeError, "Multipart #{@name} exceeded limit of #{@maximum}!"
+					raise LimitError, "Multipart #{@name} exceeded limit of #{@maximum}!"
 				end
 				
 				return @size

data/lib/protocol/multipart/error.rb

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

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

@@ -15,20 +15,20 @@ module Protocol
 				CONTENT_TYPE = "multipart/form-data"
 				
 				# Initialize the form data parser.
-				# @parameter maximum_field_size [Integer | Nil] The maximum size of each buffered field.
-				# @parameter maximum_upload_size [Integer | Nil] The maximum size of each file upload.
-				# @parameter maximum_total_size [Integer | Nil] The maximum combined size of all fields and uploads.
-				# @parameter maximum_depth [Integer | Nil] The maximum depth of a bracketed form name.
+				# @parameter field_size_limit [Integer | Nil] The buffered field size limit.
+				# @parameter upload_size_limit [Integer | Nil] The file upload size limit.
+				# @parameter total_size_limit [Integer | Nil] The combined size limit for all fields and uploads.
+				# @parameter depth_limit [Integer | Nil] The bracketed form name depth limit.
 				# @parameter options [Hash] Limits passed to the underlying multipart parser.
-				def initialize(maximum_field_size: MAXIMUM_FIELD_SIZE, maximum_upload_size: MAXIMUM_UPLOAD_SIZE, maximum_total_size: MAXIMUM_TOTAL_SIZE, maximum_depth: Protocol::URL::FormData::Nested::MAXIMUM_DEPTH, **options)
-					if maximum_depth and maximum_depth < 0
+				def initialize(field_size_limit: FIELD_SIZE_LIMIT, upload_size_limit: UPLOAD_SIZE_LIMIT, total_size_limit: TOTAL_SIZE_LIMIT, depth_limit: Protocol::URL::FormData::Nested::DEPTH_LIMIT, **options)
+					if depth_limit and depth_limit < 0
 						raise ArgumentError, "Form data limits must be non-negative!"
 					end
 					
-					@maximum_field_size = maximum_field_size
-					@maximum_upload_size = maximum_upload_size
-					@maximum_total_size = maximum_total_size
-					@maximum_depth = maximum_depth
+					@field_size_limit = field_size_limit
+					@upload_size_limit = upload_size_limit
+					@total_size_limit = total_size_limit
+					@depth_limit = depth_limit
 					@options = options
 				end
 				
@@ -66,7 +66,7 @@ module Protocol
 				def each(readable, boundary:)
 					return to_enum(__method__, readable, boundary:) unless block_given?
 					
-					total_limit = ByteLimit.new(@maximum_total_size, name: :total_size)
+					total_size_limit = ByteLimit.new(@total_size_limit, name: :total_size)
 					parser = Multipart::Parser.new(readable, boundary, **@options)
 					
 					parser.each do |part|
@@ -77,16 +77,16 @@ module Protocol
 						end
 						
 						if filename = disposition["filename"]
-							upload = Upload.new(part, filename, @maximum_upload_size, total_limit)
+							upload = Upload.new(part, filename, @upload_size_limit, total_size_limit)
 							yield name, upload
 							upload.discard
 						else
-							field_limit = ByteLimit.new(@maximum_field_size, name: :field_size)
+							field_size_limit = ByteLimit.new(@field_size_limit, name: :field_size)
 							value = String.new.b
 							
 							part.each do |chunk|
-								field_limit.consume(chunk.bytesize)
-								total_limit.consume(chunk.bytesize)
+								field_size_limit.consume(chunk.bytesize)
+								total_size_limit.consume(chunk.bytesize)
 								value << chunk
 							end
 							
@@ -98,7 +98,7 @@ module Protocol
 				private
 				
 				def make_result
-					return Protocol::URL::FormData::Nested.new(maximum_depth: @maximum_depth)
+					return Protocol::URL::FormData::Nested.new(depth_limit: @depth_limit)
 				end
 			end
 		end

data/lib/protocol/multipart/form_data.rb

@@ -16,27 +16,27 @@ module Protocol
 		class FormData < Mixed
 			include Escape
 			
-			# The default maximum size of a buffered form field.
-			MAXIMUM_FIELD_SIZE = 2 * 1024 * 1024
+			# The buffered form field size limit.
+			FIELD_SIZE_LIMIT = 2 * 1024 * 1024
 			
-			# The default maximum size of a streamed file upload.
-			MAXIMUM_UPLOAD_SIZE = 128 * 1024 * 1024
+			# The streamed file upload size limit.
+			UPLOAD_SIZE_LIMIT = 128 * 1024 * 1024
 			
-			# The default maximum combined size of all form fields and file uploads.
-			MAXIMUM_TOTAL_SIZE = 256 * 1024 * 1024
+			# The combined size limit for all form fields and file uploads.
+			TOTAL_SIZE_LIMIT = 256 * 1024 * 1024
 			
 			# A file upload yielded while parsing form data.
 			class Upload
 				# Initialize a streamed file upload.
 				# @parameter part [Parser::Part] The underlying multipart part.
 				# @parameter filename [String] The submitted filename.
-				# @parameter maximum_size [Integer | Nil] The maximum upload size.
-				# @parameter total_limit [ByteLimit] The shared form-data size limit.
-				def initialize(part, filename, maximum_size, total_limit)
+				# @parameter size_limit [Integer | Nil] The upload size limit.
+				# @parameter total_size_limit [ByteLimit] The shared form-data size limit.
+				def initialize(part, filename, size_limit, total_size_limit)
 					@part = part
 					@filename = filename
-					@limit = ByteLimit.new(maximum_size, name: :upload_size)
-					@total_limit = total_limit
+					@size_limit = ByteLimit.new(size_limit, name: :upload_size)
+					@total_size_limit = total_size_limit
 				end
 				
 				# The submitted filename.
@@ -49,7 +49,7 @@ module Protocol
 				
 				# The number of upload bytes consumed so far.
 				def size
-					@limit.size
+					@size_limit.size
 				end
 				
 				# Whether the complete upload has been consumed.
@@ -63,8 +63,8 @@ module Protocol
 					return to_enum(:each, chunk_size) unless block_given?
 					
 					@part.each(chunk_size) do |chunk|
-						@limit.consume(chunk.bytesize)
-						@total_limit.consume(chunk.bytesize)
+						@size_limit.consume(chunk.bytesize)
+						@total_size_limit.consume(chunk.bytesize)
 						yield chunk
 					end
 					

data/lib/protocol/multipart/parser.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require "io/stream"
+require_relative "error"
 require_relative "headers"
 
 module Protocol
@@ -14,17 +15,17 @@ module Protocol
 			HEADER_PATTERN = /\A([!-9;-~]+):[ \t]*([^\x00-\x08\x0a-\x1f\x7f]*)\z/.freeze
 			private_constant :HEADER_PATTERN
 			
-			# The default maximum number of preamble bytes before the first boundary.
-			MAXIMUM_PREAMBLE_SIZE = 64 * 1024
+			# The preamble size limit.
+			PREAMBLE_SIZE_LIMIT = 64 * 1024
 			
-			# The default maximum number of header bytes in each part.
-			MAXIMUM_HEADER_SIZE = 64 * 1024
+			# The header size limit for each part.
+			HEADER_SIZE_LIMIT = 64 * 1024
 			
-			# The default maximum number of headers in each part.
-			MAXIMUM_HEADER_COUNT = 64
+			# The header count limit for each part.
+			HEADER_COUNT_LIMIT = 64
 			
-			# The default maximum number of parts.
-			MAXIMUM_PART_COUNT = 128
+			# The part count limit.
+			PART_COUNT_LIMIT = 128
 			
 			# Represents a single part within a multipart message.
 			class Part
@@ -163,12 +164,12 @@ module Protocol
 			#
 			# @parameter readable [IO, IO::Stream] The readable stream containing multipart data.
 			# @parameter boundary [String] The boundary string that separates the parts.
-			# @parameter maximum_preamble_size [Integer | Nil] The maximum preamble size, or nil for no limit.
-			# @parameter maximum_header_size [Integer | Nil] The maximum header size per part, or nil for no limit.
-			# @parameter maximum_header_count [Integer | Nil] The maximum header count per part, or nil for no limit.
-			# @parameter maximum_part_count [Integer | Nil] The maximum part count, or nil for no limit.
-			def initialize(readable, boundary, maximum_preamble_size: MAXIMUM_PREAMBLE_SIZE, maximum_header_size: MAXIMUM_HEADER_SIZE, maximum_header_count: MAXIMUM_HEADER_COUNT, maximum_part_count: MAXIMUM_PART_COUNT)
-				limits = [maximum_preamble_size, maximum_header_size, maximum_header_count, maximum_part_count]
+			# @parameter preamble_size_limit [Integer | Nil] The preamble size limit, or nil for no limit.
+			# @parameter header_size_limit [Integer | Nil] The header size limit per part, or nil for no limit.
+			# @parameter header_count_limit [Integer | Nil] The header count limit per part, or nil for no limit.
+			# @parameter part_count_limit [Integer | Nil] The part count limit, or nil for no limit.
+			def initialize(readable, boundary, preamble_size_limit: PREAMBLE_SIZE_LIMIT, header_size_limit: HEADER_SIZE_LIMIT, header_count_limit: HEADER_COUNT_LIMIT, part_count_limit: PART_COUNT_LIMIT)
+				limits = [preamble_size_limit, header_size_limit, header_count_limit, part_count_limit]
 				
 				if limits.any?{|limit| limit and limit < 0}
 					raise ArgumentError, "Multipart limits must be non-negative!"
@@ -176,10 +177,10 @@ module Protocol
 				
 				@readable = IO::Stream(readable)
 				@boundary = boundary
-				@maximum_preamble_size = maximum_preamble_size
-				@maximum_header_size = maximum_header_size
-				@maximum_header_count = maximum_header_count
-				@maximum_part_count = maximum_part_count
+				@preamble_size_limit = preamble_size_limit
+				@header_size_limit = header_size_limit
+				@header_count_limit = header_count_limit
+				@part_count_limit = part_count_limit
 				
 				@boundary_marker = "--#{@boundary}\r\n".freeze
 			end
@@ -195,12 +196,12 @@ module Protocol
 				
 				# Read lines until we find the first boundary:
 				while true
-					if line = read_line(preamble_size, @maximum_preamble_size, allowance: @boundary_marker.bytesize, chomp: false)
+					if line = read_line(preamble_size, @preamble_size_limit, allowance: @boundary_marker.bytesize, chomp: false)
 						if line == @boundary_marker
 							break
 						else
 							preamble_size += line.bytesize
-							check_limit(:preamble_size, preamble_size, @maximum_preamble_size)
+							check_limit(:preamble_size, preamble_size, @preamble_size_limit)
 						end
 					else
 						# End of stream reached without finding boundary:
@@ -212,7 +213,7 @@ module Protocol
 				
 				while true
 					part_count += 1
-					check_limit(:part_count, part_count, @maximum_part_count)
+					check_limit(:part_count, part_count, @part_count_limit)
 					
 					part = read_part
 					break unless part
@@ -234,18 +235,18 @@ module Protocol
 			
 			private
 			
-			def read_line(size, maximum, allowance: 0, chomp:)
-				if maximum
-					limit = maximum - size + allowance + 1
+			def read_line(size, limit, allowance: 0, chomp:)
+				if limit
+					limit = limit - size + allowance + 1
 					return @readable.gets("\r\n", limit, chomp: chomp)
 				else
 					return @readable.gets("\r\n", chomp: chomp)
 				end
 			end
 			
-			def check_limit(name, value, maximum)
-				if maximum and value > maximum
-					raise RangeError, "Multipart #{name} exceeded limit of #{maximum}!"
+			def check_limit(name, value, limit)
+				if limit and value > limit
+					raise LimitError, "Multipart #{name} exceeded limit of #{limit}!"
 				end
 			end
 			
@@ -255,18 +256,18 @@ module Protocol
 				header_count = 0
 				
 				# Read headers until empty line
-				while line = read_line(header_size, @maximum_header_size, allowance: 2, chomp: true)
+				while line = read_line(header_size, @header_size_limit, allowance: 2, chomp: true)
 					if line.empty?
 						break # End of headers
 					end
 					
 					header_size += line.bytesize + 2
-					check_limit(:header_size, header_size, @maximum_header_size)
+					check_limit(:header_size, header_size, @header_size_limit)
 					
 					if match = line.match(HEADER_PATTERN)
 						# Parse header line (name: value)
 						header_count += 1
-						check_limit(:header_count, header_count, @maximum_header_count)
+						check_limit(:header_count, header_count, @header_count_limit)
 						
 						fields << [match[1], match[2].strip]
 					else

data/lib/protocol/multipart/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module Multipart
-		VERSION = "0.3.0"
+		VERSION = "0.5.0"
 	end
 end

data/lib/protocol/multipart.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require_relative "multipart/version"
+require_relative "multipart/error"
 require_relative "multipart/byte_limit"
 require_relative "multipart/headers"
 require_relative "multipart/parser"

data/readme.md

@@ -6,6 +6,14 @@
 
 Please see the [project releases](https://socketry.github.io/protocol-multipart/releases/index) for all releases.
 
+### v0.5.0
+
+  - Add `Protocol::Multipart::LimitError` for configured processing limits.
+
+### v0.4.0
+
+  - Use consistent limit naming for multipart parser constraints.
+
 ### v0.3.0
 
   - Add a configurable `Protocol::Multipart::FormData::Parser` which parses a streaming body and explicit boundary into nested arguments.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.5.0
+
+  - Add `Protocol::Multipart::LimitError` for configured processing limits.
+
+## v0.4.0
+
+  - Use consistent limit naming for multipart parser constraints.
+
 ## v0.3.0
 
   - Add a configurable `Protocol::Multipart::FormData::Parser` which parses a streaming body and explicit boundary into nested arguments.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-multipart
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.9'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -87,6 +87,7 @@ files:
 - lib/protocol/multipart.rb
 - lib/protocol/multipart/boundary.rb
 - lib/protocol/multipart/byte_limit.rb
+- lib/protocol/multipart/error.rb
 - lib/protocol/multipart/escape.rb
 - lib/protocol/multipart/form_data.rb
 - lib/protocol/multipart/form_data/parser.rb