protocol-http 0.42.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3dcfd47b74176108bc100b7fdbb649f8fcfd09e753e268f7cf2136f4d5871eb5
-  data.tar.gz: 68424943f3195c241b99494d21714ee5e3a4c56ed0fccefecaeb444382f74a2d
+  metadata.gz: 7bdd0ca9356d15e047333ae5e070710d5453bece234e484d236656edb984eb3b
+  data.tar.gz: eb605cfc6aa68422dd8142ba7e86fb0ec9eef55f8415e8cc0e9066af714a4aa7
 SHA512:
-  metadata.gz: 509aa00c0dbc0a39c9641593b481b549c3b0150b4ef1372ae7deb1468b43027399f1f024ae7c26ca30c06eb3ce46bb8720da613b199070fac03d5607e15f1d2e
-  data.tar.gz: 438fcedcbda571ba5f3d9e800105669801123444d359c9915a4c90ba2cd3139e17e3b40c116750ae0f731a2eb6094a99c447b6f62a7978d4bc7d4c8015e95538
+  metadata.gz: 493688f8e6e8a417bfdb49fd53103e07ccca2f164613e5cea2ce0298b4eb4c4e251add7c1873d178f38b1cfb984267e277c4388f60b9e36b013d1f8bac950b57
+  data.tar.gz: '0590a15ef7f6447efc5c84a0c6ce7e796a1b1b8d91975b10f895a5c0d9c450402f7adeb7b504785179e6fe68f776a7113050adc2458dc84e7f4330b6faec4774'

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.42.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.42.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-21 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.