io-endpoint 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01c66c778ce2edc823029e630d48e6240d7540fc277604e47341fba40a2a0377
-  data.tar.gz: 4da0e58ab7270e0edde4442049dc6e6fc6a5b818798da77383c2e99ef6fa2cfe
+  metadata.gz: 7fd588de618301021d1fcc23188ab4f50ad2b4e4f4f36f996a36c8bfffe10028
+  data.tar.gz: 00375d72509321b8fcbb179dac71ff8a41469e7774048953618557b054556eda
 SHA512:
-  metadata.gz: 2b1cf8108ad055f3e40ec41e4ee82d510c72d2ae17bd49bc895c4944ada35a9d1c45e97ea44aab6a7bc75d8bdc0f5c808009fe5012d843e6b591af1fdbef62e9
-  data.tar.gz: 0e0eee1759843f2c045be325730706ee85c730603172b76c252955bb2121f3c962bb4a60fbf6617e67d7ebc50ba83b0b3e304ba7d9d2c468c0fa77dd35b0bc46
+  metadata.gz: 0fa3bd96abdb1b98fb191995867f5d325f98d760bd5d578c916c091ffc6ae0bc8294ee766410bd6b5a057840da37060aa5cad3471e82652bcc0912b9864b356d
+  data.tar.gz: 2166dc7b1b45a2c073b998997e16c8b5d64c9b4c42b4d930f20f58ae3005581721a5f7035e7b560f435ebdf752a657dbc73eeb9aa105ec6cf3729a1c4eefb4b6

data/lib/io/endpoint/ssl_endpoint.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2025, by Samuel Williams.
+# Copyright, 2023-2026, by Samuel Williams.
 
 require_relative "host_endpoint"
 require_relative "generic"

data/lib/io/endpoint/tls/configuration.rb

@@ -59,6 +59,37 @@ module IO::Endpoint
 			# @attribute [Symbol | Nil] The peer verification policy.
 			attr :verification
 			
+			# Compare configurations by their certificate material and verification policy.
+			# @parameter other [Object] The object to compare.
+			# @returns [Boolean] Whether both configurations have the same class and values.
+			def ==(other)
+				return other.instance_of?(self.class) &&
+					@trust_store.eql?(other.trust_store) &&
+					@certificate_chain.eql?(other.certificate_chain) &&
+					@private_key.eql?(other.private_key) &&
+					@verification.eql?(other.verification)
+			end
+			
+			alias eql? ==
+			
+			# Compute a hash from the configuration values. Freeze the configuration before using it as a hash key.
+			# @returns [Integer] The hash of the configuration.
+			def hash
+				return [self.class, @trust_store, @certificate_chain, @private_key, @verification].hash
+			end
+			
+			# Freeze the configuration and independent copies of its certificate material, without freezing caller-owned values.
+			# @returns [Configuration] This immutable configuration. Use `dup.freeze` to preserve the original configuration too.
+			def freeze
+				return self if frozen?
+				
+				@trust_store = @trust_store&.dup&.freeze
+				@certificate_chain = @certificate_chain&.map{|certificate| certificate.dup.freeze}&.freeze
+				@private_key = @private_key&.dup&.freeze
+				
+				super
+			end
+			
 			# Whether peer certificates should be verified.
 			# @returns [Boolean] Whether peer verification is enabled.
 			def verify_peer?

data/lib/io/endpoint/tls/trust_store.rb

@@ -55,6 +55,33 @@ module IO::Endpoint
 				@system_certificates
 			end
 			
+			# Compare trust stores by their ordered certificates and system certificate policy.
+			# @parameter other [Object] The object to compare.
+			# @returns [Boolean] Whether both trust stores have the same class and values.
+			def ==(other)
+				return other.instance_of?(self.class) &&
+					@certificates.eql?(other.certificates) &&
+					@system_certificates.eql?(other.system_certificates?)
+			end
+			
+			alias eql? ==
+			
+			# Compute a hash from the trust store values. Freeze the trust store before using it as a hash key.
+			# @returns [Integer] The hash of the trust store.
+			def hash
+				return [self.class, @certificates, @system_certificates].hash
+			end
+			
+			# Freeze the trust store and independent copies of its certificates, without freezing caller-owned values.
+			# @returns [TrustStore] This immutable trust store. Use `dup.freeze` to preserve the original trust store too.
+			def freeze
+				return self if frozen?
+				
+				@certificates = @certificates.map{|certificate| certificate.dup.freeze}.freeze
+				
+				super
+			end
+			
 			# Get a representation of the trust store without exposing certificate material.
 			# @returns [String] A redacted representation of the trust store.
 			def inspect

data/lib/io/endpoint/version.rb

@@ -7,6 +7,6 @@
 class IO
 	# @namespace
 	module Endpoint
-		VERSION = "0.18.0"
+		VERSION = "0.19.0"
 	end
 end

data/readme.md

@@ -16,6 +16,10 @@ Please see the [project documentation](https://socketry.github.io/io-endpoint) f
 
 Please see the [project releases](https://socketry.github.io/io-endpointreleases/index) for all releases.
 
+### v0.19.0
+
+  - Compare TLS configurations and trust stores by value, allowing equivalent configurations to share cache entries. Freezing them creates immutable certificate data without freezing caller-owned values.
+
 ### v0.18.0
 
   - The `openssl` gem 3.3.0 or newer is now required.
@@ -56,10 +60,6 @@ Please see the [project releases](https://socketry.github.io/io-endpointreleases
 
   - Uniform `#to_s` and `#inspect` implementations across all endpoints.
 
-### v0.13.1
-
-  - Fixed state leak between iterations of the accept loop.
-
 ## See Also
 
   - [async-io](https://github.com/socketry/async-io) — Where this implementation originally came from.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.19.0
+
+  - Compare TLS configurations and trust stores by value, allowing equivalent configurations to share cache entries. Freezing them creates immutable certificate data without freezing caller-owned values.
+
 ## v0.18.0
 
   - The `openssl` gem 3.3.0 or newer is now required.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-endpoint
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -103,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Provides a separation of concerns interface for IO endpoints.
 test_files: []