io-endpoint 0.17.1 → 0.17.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a1fd8b9900456445fa95fc7de22135fc86c96c9ed05586acec98c492de11ab7
-  data.tar.gz: b179c79964d3fba2d92753fc4494fd0fa2a88bcb825dc20561a61784adc60fec
+  metadata.gz: af9622a36778938631f679dda8abc06668454c5693551761173757b2df01ec76
+  data.tar.gz: e3d58e00ad0e067628d53d7950fd4a801a588fe7935e53f74d0bdc3e5f810e8a
 SHA512:
-  metadata.gz: 6370da98fec490d732f957fd5cf947396551bed010d88211a4e6684529d4ea930bff17753ae672c3cc8e482315f96bd2d31ee4365a77bb85476fa12da23ace4f
-  data.tar.gz: c478357360832dd7c225979f2531025025f711fca06616b4efd2a7398d700a1c248021a5d2be6749fd9b5dc5950cd04a953ac383527c8d2cb301745ee5ac5038
+  metadata.gz: a341c62ee7a064bc18cdecb7fcfc08cc40b2a9f863baf12b0423d8389af1c0cf90b21025d78b4dce04e7abe3007f2c32ef0e0bb6f46bc9cecaee620d1e29a967
+  data.tar.gz: f1abb49094a40133a3861d55a58be3efb2d868ad40cddf27b33a080e4596a872f422e7a2c70cca0ead57ebff47b193c5b823ef55c7cd8cac5fd5c855ae9749a1

data/lib/io/endpoint/address_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 "socket"
 
@@ -28,6 +28,8 @@ module IO::Endpoint
 				"inet:#{@address.inspect_sockaddr}"
 			when Socket::AF_INET6
 				"inet6:#{@address.inspect_sockaddr}"
+			when Socket::AF_UNIX
+				"unix:#{@address.unix_path}"
 			else
 				"address:#{@address.inspect_sockaddr}"
 			end

data/lib/io/endpoint/host_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 "address_endpoint"
 
@@ -31,7 +31,6 @@ module IO::Endpoint
 			"\#<#{self.class} name=#{nodename.inspect} service=#{service.inspect} family=#{family.inspect} type=#{socktype.inspect} protocol=#{protocol.inspect} flags=#{flags.inspect}>"
 		end
 		
-		
 		# @attribute [Array] The host specification array.
 		attr :specification
 		

data/lib/io/endpoint/unix_endpoint.rb

@@ -1,22 +1,44 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2025, by Samuel Williams.
+# Copyright, 2023-2026, by Samuel Williams.
+# Copyright, 2026, by Delton Ding.
+
+require "digest"
+require "fileutils"
+require "tmpdir"
 
 require_relative "address_endpoint"
 
 module IO::Endpoint
 	# This class doesn't exert ownership over the specified unix socket and ensures exclusive access by using `flock` where possible.
 	class UNIXEndpoint < AddressEndpoint
+		# Compute a stable temporary UNIX socket path for an overlong path.
+		# @parameter path [String] The original (possibly overlong) path.
+		# @returns [String] A short, stable path suitable for {Address.unix}.
+		def self.short_path_for(path)
+			# We need to ensure the path is absolute and canonical, otherwise the SHA1 hash will not be consistent:
+			path = File.expand_path(path)
+			
+			# We then use the SHA1 hash of the path to create a short, stable path:
+			File.join(Dir.tmpdir, Digest::SHA1.hexdigest(path) + ".ipc")
+		end
+		
 		# Initialize a new UNIX domain socket endpoint.
 		# @parameter path [String] The path to the UNIX socket.
 		# @parameter type [Integer] The socket type (defaults to Socket::SOCK_STREAM).
 		# @parameter options [Hash] Additional options to pass to the parent class.
 		def initialize(path, type = Socket::SOCK_STREAM, **options)
-			# I wonder if we should implement chdir behaviour in here if path is longer than 104 characters.
-			super(Address.unix(path, type), **options)
-			
 			@path = path
+			
+			begin
+				address = Address.unix(path, type)
+			rescue ArgumentError
+				path = self.class.short_path_for(path)
+				address = Address.unix(path, type)
+			end
+			
+			super(address, **options)
 		end
 		
 		# Get a string representation of the UNIX endpoint.
@@ -28,11 +50,28 @@ module IO::Endpoint
 		# Get a detailed string representation of the UNIX endpoint.
 		# @returns [String] A detailed string representation including the path.
 		def inspect
-			"\#<#{self.class} path=#{@path.inspect}>"
+			target_path = @address.unix_path
+			
+			if @path == target_path
+				"\#<#{self.class} path=#{@path.inspect}>"
+			else
+				"\#<#{self.class} path=#{@path.inspect} target=#{target_path.inspect}>"
+			end
 		end
 		
 		# @attribute [String] The path to the UNIX socket.
-		attr :path
+		def path
+			@path
+		end
+		
+		# Check if a symlink is used for this endpoint.
+		#
+		# A symlink is created when the original path exceeds the system's maximum UNIX socket path length and a shorter temporary path is used for the actual socket.
+		#
+		# @returns [Boolean] True if the original path differs from the socket path, indicating a symlink is required.
+		def symlink?
+			File.symlink?(@path)
+		end
 		
 		# Check if the socket is currently bound and accepting connections.
 		# @returns [Boolean] True if the socket is bound and accepting connections, false otherwise.
@@ -52,16 +91,61 @@ module IO::Endpoint
 		# @returns [Array(Socket)] The bound socket.
 		# @raises [Errno::EADDRINUSE] If the socket is still in use by another process.
 		def bind(...)
-			super
+			result = super
+			create_symlink_if_required!
+			return result
 		rescue Errno::EADDRINUSE
 			# If you encounter EADDRINUSE from `bind()`, you can check if the socket is actually accepting connections by attempting to `connect()` to it. If the socket is still bound by an active process, the connection will succeed. Otherwise, it should be safe to `unlink()` the path and try again.
 			if !bound?
-				File.unlink(@path) rescue nil
+				unlink_stale_paths!
 				retry
 			else
 				raise
 			end
 		end
+		
+		# Read a symlink, returning nil if the file does not exist.
+		#
+		# @parameter path [String] The path to the symlink.
+		# @returns [String | Nil] The target of the symlink, or nil if the file does not exist.
+		private def read_link(path)
+			File.readlink(path)
+		rescue # Errno::ENOENT, Errno::EINVAL
+			# The file is not a symlink, or the symlink is invalid.
+			nil
+		end
+		
+		# Create a symlink to the actual socket path if required.
+		private def create_symlink_if_required!
+			# Ensure the directory exists:
+			FileUtils.mkdir_p(File.dirname(@path))
+			
+			# This is the actual path we want to use for the socket:
+			target_path = @address.unix_path
+			
+			# If it's the same as the original path, we are done:
+			return if @path == target_path
+			
+			# Otherwise, we need might need to create a symlink:
+			if read_link(target_path) == @path
+				return
+			else
+				File.unlink(@path) rescue nil
+			end
+			
+			# Create symlink at @path (original long path) pointing to target_path (short socket path)
+			File.symlink(target_path, @path)
+		end
+		
+		private def unlink_stale_paths!
+			File.unlink(@path) rescue nil
+			
+			target_path = @address.unix_path
+			
+			if @path != target_path
+				File.unlink(target_path) rescue nil
+			end
+		end
 	end
 	
 	# @parameter path [String]

data/lib/io/endpoint/version.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2025, by Samuel Williams.
+# Copyright, 2023-2026, by Samuel Williams.
 
 # @namespace
 class IO
 	# @namespace
 	module Endpoint
-		VERSION = "0.17.1"
+		VERSION = "0.17.2"
 	end
 end

data/lib/io/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 "endpoint/version"
 require_relative "endpoint/generic"

data/license.md

@@ -1,6 +1,7 @@
 # MIT License
 
 Copyright, 2023-2026, by Samuel Williams.  
+Copyright, 2026, by Delton Ding.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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.17.2
+
+  - When the unix path is bigger than what can fit into `struct sockaddr_un`, a shorter temporary path will be used instead and a symlink created at the original path.
+
 ### v0.17.1
 
   - Add `#to_s` and `#inspect` for `IO::Endpoint::NamedEndpoints`.
@@ -54,10 +58,6 @@ Please see the [project releases](https://socketry.github.io/io-endpointreleases
 
   - Propagate options assigned to composite endpoint to nested endpoints.
 
-### v0.12.0
-
-  - Expose `size` and internal endpoints for composite endpoint.
-
 ## 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.17.2
+
+  - When the unix path is bigger than what can fit into `struct sockaddr_un`, a shorter temporary path will be used instead and a symlink created at the original path.
+
 ## v0.17.1
 
   - Add `#to_s` and `#inspect` for `IO::Endpoint::NamedEndpoints`.

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: io-endpoint
 version: !ruby/object:Gem::Version
-  version: 0.17.1
+  version: 0.17.2
 platform: ruby
 authors:
 - Samuel Williams
+- Delton Ding
 bindir: bin
 cert_chain:
 - |