protocol-http 0.35.0 → 0.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b60538bc2a8f661748e6a70b92bf46932440e56f69e0cb22348fa14b0c59706f
-  data.tar.gz: 9a6629a169c0afff229eed8b660fc94c918cc9f0a953e5251b5f5f283e4e28fa
+  metadata.gz: c826c247a1168e14cb7b5e0b216019b622574c801852cda2a4102f0a041d0694
+  data.tar.gz: 9661992d2f755a4743b8998889e84c3ff3c826769256ccfc8a48f697ddc0463b
 SHA512:
-  metadata.gz: 707f195fa9b7b2bfe446b6a2132dfe608570ec8fed696c8df558686e80da07c5026fac90941109dc7d743e3806daf8fdfb4d28ce051ba1412242b8fde4f45a99
-  data.tar.gz: 41a940d1dee93bc30d90fc0ae63fa34103d82379862c502a2ec11ec6f06521491e8eb6586ef43707957ff8ebc7f7016e893ad3b88751e93fdcf14976de8227d2
+  metadata.gz: 7c37d338e02b8b9dc2540be13bad83d37df2f07a6082f3ace8aadc3f7dd357c0b77bae9508bd7a7f2ff4aecf51ef99efa7a94fa09214a510f1616ca34b9f16c0
+  data.tar.gz: f3588dde1d19541c9e5ee9e8c3d13d7f42d7976419f7cf3d0af2e7451445619d79c7f897699e1d20fd5569afed5c7cf7ec9b15e6c5d6a05647422dff6a38b508

data/lib/protocol/http/body/buffered.rb

@@ -59,6 +59,8 @@ module Protocol
 				# Ensure that future reads return nil, but allow for rewinding.
 				def close(error = nil)
 					@index = @chunks.length
+					
+					return nil
 				end
 				
 				def clear
@@ -90,6 +92,10 @@ module Protocol
 					end
 				end
 				
+				def discard
+					self.close
+				end
+				
 				def write(chunk)
 					@chunks << chunk
 				end

data/lib/protocol/http/body/readable.rb

@@ -133,6 +133,16 @@ module Protocol
 					Buffered.read(self)
 				end
 				
+				# Discard the body as efficiently as possible.
+				#
+				# The default implementation simply reads all chunks until the body is empty.
+				#
+				# Useful for discarding the body when it is not needed, but preserving the underlying connection.
+				def discard
+					while chunk = self.read
+					end
+				end
+				
 				def as_json(...)
 					{
 						class: self.class.name,

data/lib/protocol/http/body/reader.rb

@@ -40,6 +40,14 @@ module Protocol
 					end
 				end
 				
+				# Discard the body as efficiently as possible.
+				def discard
+					if body = @body
+						@body = nil
+						body.discard
+					end
+				end
+				
 				# Buffer the entire request/response body.
 				# @returns [Reader] itself.
 				def buffered!

data/lib/protocol/http/body/wrapper.rb

@@ -59,6 +59,10 @@ module Protocol
 					@body.read
 				end
 				
+				def discard
+					@body.discard
+				end
+				
 				def as_json(...)
 					{
 						class: self.class.name,

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.35.0"
+		VERSION = "0.36.0"
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.35.0
+  version: 0.36.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -47,7 +47,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-09-16 00:00:00.000000000 Z
+date: 2024-09-17 00:00:00.000000000 Z
 dependencies: []
 description:
 email: