protocol-http 0.63.0 → 0.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12be9d363df2ffd17498996e847c26fd84e807b7602d16592fc12ee27365bf30
-  data.tar.gz: 9c39629fe635e04e829a831eaf7f886f8c99e267426e55e139bee65a138798b2
+  metadata.gz: 144524e37ab8f38f1391e711994fd1880cdce76b35586a757aa5745645ec95ee
+  data.tar.gz: 47caea36c05b7ae9bfedde624a614f9cfd4cee7b2471e0f18ccfa3645ed0b8f3
 SHA512:
-  metadata.gz: 737b7089fbf76a2a985af0e4f95f1c81d2dda4f86608ef269841e9a1c12c70199612856b8a406627520cd092f85cd9c652351b582cd15d13c81901b2e6a3a419
-  data.tar.gz: 2c33f92c8cb86b4aad6bd962798aea79741e3389fc2741f4eb27982e659500281a559e25e4e3cec08d0407932da25411fed00f2a993bb76e70182490fe2888be
+  metadata.gz: febc1afedb0368e12ec0293525e7221b8d223b9aaf9eb1e6d9987a232e05eef3492933d30ea912534bed0acf09db13e436227a049dd5db405b9f2ca6ccdff209
+  data.tar.gz: ed719d0d3d5dadb3ca0698d7fee3b56f0e80c3b6fa83e0b9f2cf05bb3dbe48587204e2ecc829b8404fe8407320fcde9f6a3aee14adf40b6dd62a2913ca60f65e

data/lib/protocol/http/request.rb

@@ -153,6 +153,28 @@ module Protocol
 				return false
 			end
 			
+			# Rewind the request body so it can be sent again.
+			# @returns [Boolean] Whether the request body was rewound.
+			def rewind!
+				if body = @body
+					return body.rewind
+				end
+				
+				# Requests without a body can be sent again immediately.
+				return true
+			end
+			
+			# Prepare the request body to be sent again, if it is safe to retry.
+			# @returns [Boolean] Whether the request was prepared for retry.
+			def retry!
+				# Only idempotent request methods can be retried safely.
+				if @method == Methods::POST || @method == Methods::PATCH || @method == Methods::CONNECT
+					return false
+				end
+				
+				return self.rewind!
+			end
+			
 			# Convert the request to a hash, suitable for serialization.
 			#
 			# @returns [Hash] The request as a hash.

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.63.0"
+		VERSION = "0.64.0"
 	end
 end

data/readme.md

@@ -30,6 +30,10 @@ Please see the [project documentation](https://socketry.github.io/protocol-http/
 
 Please see the [project releases](https://socketry.github.io/protocol-http/releases/index) for all releases.
 
+### v0.64.0
+
+  - Add `Protocol::HTTP::Request#rewind!` and `#retry!` for preparing requests to be sent again.
+
 ### v0.63.0
 
   - Add support for the HTTP `QUERY` method.
@@ -75,15 +79,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http/relea
   - Update `Headers#[]=` to use `coerce(value)` for smart conversion of user input.
   - Normalization (e.g., lowercasing) is applied by `parse`, `coerce`, and `<<` methods, but not by `new` when given arrays.
 
-### v0.55.0
-
-  - **Breaking**: Move `Protocol::HTTP::Header::QuotedString` to `Protocol::HTTP::QuotedString` for better reusability.
-  - **Breaking**: Handle cookie key/value pairs using `QuotedString` as per RFC 6265.
-      - Don't use URL encoding for cookie key/value.
-  - **Breaking**: Remove `Protocol::HTTP::URL` and `Protocol::HTTP::Reference` – replaced by `Protocol::URL` gem.
-      - `Protocol::HTTP::URL` -\> `Protocol::URL::Encoding`.
-      - `Protocol::HTTP::Reference` -\> `Protocol::URL::Reference`.
-
 ## See Also
 
   - [protocol-http1](https://github.com/socketry/protocol-http1) — HTTP/1 client/server implementation using this

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.64.0
+
+  - Add `Protocol::HTTP::Request#rewind!` and `#retry!` for preparing requests to be sent again.
+
 ## v0.63.0
 
   - Add support for the HTTP `QUERY` method.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.63.0
+  version: 0.64.0
 platform: ruby
 authors:
 - Samuel Williams