File: peer.rb

package info (click to toggle)
ruby-protocol-http 0.55.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 840 kB
  • sloc: ruby: 6,904; makefile: 4
file content (39 lines) | stat: -rw-r--r-- 983 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2024-2025, by Samuel Williams.

module Protocol
	module HTTP
		# Provide a well defined, cached representation of a peer (address).
		class Peer
			# Create a new peer object for the given IO object, using the remote address if available.
			#
			# @returns [Peer | Nil] The peer object, or nil if the remote address is not available.
			def self.for(io)
				if address = io.remote_address
					return new(address)
				end
			end
			
			# Initialize the peer with the given address.
			#
			# @parameter address [Addrinfo] The remote address of the peer.
			def initialize(address)
				@address = address
				
				if address.ip?
					@ip_address = @address.ip_address
				end
			end
			
			# @attribute [Addrinfo] The remote address of the peer.
			attr :address
			
			# @attribute [String] The IP address of the peer, if available.
			attr :ip_address
			
			alias remote_address address
		end
	end
end