protocol-http 0.41.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea35499964efa19071138a56a3dfd9b909200c17a96c8eeee65ba8df8c703021
-  data.tar.gz: e027f09f741d018b567e1428cb7db4bc3241a585e58bf07b8ca4ce9475e64102
+  metadata.gz: 7bdd0ca9356d15e047333ae5e070710d5453bece234e484d236656edb984eb3b
+  data.tar.gz: eb605cfc6aa68422dd8142ba7e86fb0ec9eef55f8415e8cc0e9066af714a4aa7
 SHA512:
-  metadata.gz: 7d717e61a264fe4614c94fd380807b11dc393646b442a16502527bb59642e7bbb21dca3f3e4e6f3fabe7426c6ae14f6bb59722eb5b4e0d8747b13ed3a2c4c523
-  data.tar.gz: ad0693100a420b1bdfed9439c115a240269bdae9f233b17a54d7c0cadd185f59f364ce8653999da1215fcd99976b5a96803addff78d3c51af5ad6a62a025200c
+  metadata.gz: 493688f8e6e8a417bfdb49fd53103e07ccca2f164613e5cea2ce0298b4eb4c4e251add7c1873d178f38b1cfb984267e277c4388f60b9e36b013d1f8bac950b57
+  data.tar.gz: '0590a15ef7f6447efc5c84a0c6ce7e796a1b1b8d91975b10f895a5c0d9c450402f7adeb7b504785179e6fe68f776a7113050adc2458dc84e7f4330b6faec4774'

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

@@ -33,12 +33,12 @@ module Protocol
 				end
 				
 				def close(error = nil)
-					super.tap do
-						if @callback
-							@callback.call(error)
-							@callback = nil
-						end
+					if @callback
+						@callback.call(error)
+						@callback = nil
 					end
+					
+					super
 				end
 			end
 		end

data/lib/protocol/http/peer.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2017-2024, by Samuel Williams.
+
+module Protocol
+	module HTTP
+		# Provide a well defined, cached representation of a peer (address).
+		class Peer
+			def self.for(io)
+				if address = io.remote_address
+					return new(address)
+				end
+			end
+			
+			def initialize(address)
+				@address = address
+				
+				if address.ip?
+					@ip_address = @address.ip_address
+				end
+			end
+			
+			attr :address
+			attr :ip_address
+			
+			alias remote_address address
+		end
+	end
+end

data/lib/protocol/http/request.rb

@@ -64,6 +64,13 @@ module Protocol
 			# @attribute [Proc] a callback which is called when an interim response is received.
 			attr_accessor :interim_response
 			
+			# A request that is generated by a server, may choose to include the peer (address) associated with the request. It should be implemented by a sub-class.
+			#
+			# @returns [Peer | Nil] The peer (address) associated with the request.
+			def peer
+				nil
+			end
+			
 			# Send the request to the given connection.
 			def call(connection)
 				connection.call(self)

data/lib/protocol/http/response.rb

@@ -52,6 +52,13 @@ module Protocol
 			# @attribute [String | Array(String) | Nil] The protocol, e.g. `"websocket"`, etc.
 			attr_accessor :protocol
 			
+			# A response that is generated by a client, may choose to include the peer (address) associated with the response. It should be implemented by a sub-class.
+			#
+			# @returns [Peer | Nil] The peer (address) associated with the response.
+			def peer
+				nil
+			end
+			
 			# Whether the response is considered a hijack: the connection has been taken over by the application and the server should not send any more data.
 			def hijack?
 				false

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.41.0"
+		VERSION = "0.43.0"
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.41.0
+  version: 0.43.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -47,7 +47,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-10-17 00:00:00.000000000 Z
+date: 2024-11-09 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -88,6 +88,7 @@ files:
 - lib/protocol/http/methods.rb
 - lib/protocol/http/middleware.rb
 - lib/protocol/http/middleware/builder.rb
+- lib/protocol/http/peer.rb
 - lib/protocol/http/reference.rb
 - lib/protocol/http/request.rb
 - lib/protocol/http/response.rb
@@ -117,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Provides abstractions to handle HTTP protocols.