io-event 1.16.2 → 1.16.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cc6abcf010ce881e4623a5736241660d1ebf6a84883767d761616ddcb23bf4e
-  data.tar.gz: 4a438756e87e8feaefaafb40014f36c2b240fbbd837d4581c657eb310cb9b95a
+  metadata.gz: 83f9faed054855a0c3a50ab469f315c1345a8af43641ab6c5630d648763fc55d
+  data.tar.gz: 78114e047cd897ed0192c262d099a93baea21d0c30ddb70cd57e4efc73a40889
 SHA512:
-  metadata.gz: b910e009ff697f179290d916e5914621d25a5478e0f09ac806563a0c3808b30fc28ca652042608e60625830468f37088943559c590112dfadb0d3a48d3b54688
-  data.tar.gz: c7501e4ef87e5c9744d666e43494b60b2b3c490d9e9cb55b75a87f7de199e1421b49ba0ce5e176cbaf230d6f3b8f838a5745cff81bac6f826328e7665de7a9e9
+  metadata.gz: 7cea5251f1c5b93b0235e2aa6aa69c65913e13de847a535eee21343060f744b2a810eb901b15b82bbb3c9979d60a620d4d89dfba349473ab6836e9c420985b9d
+  data.tar.gz: c8752f8a0bc9da0ca37ae420364a564c68ad4cb6020124f767677a854c7d81639e9e6daa46040d8fc575e02a7231ff5409d72833b8eb15ec72684b063b5d92d2

data/ext/extconf.rb

@@ -55,7 +55,7 @@ have_func("rb_io_descriptor")
 have_func("&rb_process_status_wait")
 have_func("rb_fiber_current")
 have_func("&rb_fiber_raise")
-have_func("epoll_pwait2") if enable_config("epoll_pwait2", true)
+have_func("epoll_pwait2(0, 0, 0, 0, 0)", "sys/epoll.h") if enable_config("epoll_pwait2", true)
 
 have_header("ruby/io/buffer.h")
 

data/lib/io/event/debug/selector.rb

@@ -107,6 +107,8 @@ module IO::Event
 				
 				@selector.close
 				@selector = nil
+				
+				@log&.flush
 			end
 			
 			# Transfer from the calling fiber to the selector.

data/lib/io/event/interrupt.rb

@@ -14,29 +14,34 @@ module IO::Event
 			@selector = selector
 			@input, @output = ::IO.pipe
 			
+			@output.sync = true
+			
 			@fiber = Fiber.new do
 				while true
 					if @selector.io_wait(@fiber, @input, IO::READABLE)
 						@input.read_nonblock(1)
 					end
 				end
+			rescue IOError
+				# This is expected on shutdown.
 			end
 			
 			@fiber.transfer
 		end
 		
-		# Send a sigle byte interrupt.
+		# Send a single byte interrupt.
 		def signal
-			@output.write(".")
-			@output.flush
-		rescue IOError
-			# Ignore.
+			# This must not block or enter blocking operations or raise an exception.
+			# Note that `Scheduler#unblock` defers exceptions, so `IOError` will not be raised by `@output.close` until later.
+			@output.write_nonblock(".", exception: false) rescue nil
 		end
 		
 		def close
+			# In principle, this should cause the fiber to exit:
 			@input.close
+			
+			# This may cause `signal` to raise an exception:
 			@output.close
-			# @fiber.raise(::Interrupt)
 		end
 	end
 	

data/lib/io/event/selector/select.rb

@@ -52,15 +52,19 @@ module IO::Event
 				@waiting = nil
 			end
 			
+			# An optional reference to a fiber which can be cleared before it is resumed.
 			Optional = Struct.new(:fiber) do
+				# Transfer control to the fiber if it is still available.
 				def transfer(*arguments)
 					fiber&.transfer(*arguments)
 				end
 				
+				# @returns [Boolean | Nil] Whether the referenced fiber is still alive.
 				def alive?
 					fiber&.alive?
 				end
 				
+				# Clear the referenced fiber.
 				def nullify
 					self.fiber = nil
 				end
@@ -111,7 +115,9 @@ module IO::Event
 				!@ready.empty?
 			end
 			
+			# A linked list node used to track fibers waiting for IO events.
 			Waiter = Struct.new(:fiber, :events, :tail) do
+				# @returns [Boolean | Nil] Whether the waiting fiber is still alive.
 				def alive?
 					self.fiber&.alive?
 				end
@@ -138,10 +144,12 @@ module IO::Event
 					tail&.dispatch(events, &reactivate)
 				end
 				
+				# Clear the waiting fiber so it will not be resumed.
 				def invalidate
 					self.fiber = nil
 				end
 				
+				# Iterate over each active waiting fiber and its requested events.
 				def each(&block)
 					if fiber = self.fiber
 						yield fiber, self.events

data/lib/io/event/selector.rb

@@ -3,12 +3,17 @@
 # Released under the MIT License.
 # Copyright, 2021-2026, by Samuel Williams.
 
+require_relative "native"
 require_relative "selector/select"
 require_relative "debug/selector"
 
 module IO::Event
 	# @namespace
 	module Selector
+		selectors = [:URing, :EPoll, :KQueue, :Select]
+		BEST = const_get(selectors.find{|name| const_defined?(name)})
+		private_constant :BEST
+		
 		# The default selector implementation, which is chosen based on the environment and available implementations.
 		#
 		# @parameter env [Hash] The environment to read configuration from.
@@ -16,16 +21,8 @@ module IO::Event
 		def self.default(env = ENV)
 			if name = env["IO_EVENT_SELECTOR"]&.to_sym
 				return const_get(name)
-			end
-			
-			if self.const_defined?(:URing)
-				URing
-			elsif self.const_defined?(:EPoll)
-				EPoll
-			elsif self.const_defined?(:KQueue)
-				KQueue
 			else
-				Select
+				BEST
 			end
 		end
 		

data/lib/io/event/timers.rb

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

data/lib/io/event/version.rb

@@ -7,6 +7,6 @@
 class IO
 	# @namespace
 	module Event
-		VERSION = "1.16.2"
+		VERSION = "1.16.4"
 	end
 end

data/readme.md

@@ -18,6 +18,14 @@ Please see the [project documentation](https://socketry.github.io/io-event/) for
 
 Please see the [project releases](https://socketry.github.io/io-event/releases/index) for all releases.
 
+### v1.16.4
+
+  - Correctly implement `Interrupt#signal` so that it is robust enough to be called by `Scheduler#unblock`.
+
+### v1.16.3
+
+  - Handle `IOError` raised while shutting down the pure Ruby interrupt pipe, so `IO::Event::Interrupt#close` does not leak expected shutdown errors from the interrupt fiber.
+
 ### v1.16.2
 
   - Improve timer heap performance by batching scheduled timer insertion, compacting cancelled timers during flush, and avoiding unnecessary heap rebuilds for small incremental inserts.
@@ -56,14 +64,6 @@ Please see the [project releases](https://socketry.github.io/io-event/releases/i
 
   - [Enhanced `IO::Event::PriorityHeap` with deletion and bulk insertion methods](https://socketry.github.io/io-event/releases/index#enhanced-io::event::priorityheap-with-deletion-and-bulk-insertion-methods)
 
-### v1.11.2
-
-  - Fix Windows build.
-
-### v1.11.1
-
-  - Fix `read_nonblock` when using the `URing` selector, which was not handling zero-length reads correctly. This allows reading available data without blocking.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v1.16.4
+
+  - Correctly implement `Interrupt#signal` so that it is robust enough to be called by `Scheduler#unblock`.
+
+## v1.16.3
+
+  - Handle `IOError` raised while shutting down the pure Ruby interrupt pipe, so `IO::Event::Interrupt#close` does not leak expected shutdown errors from the interrupt fiber.
+
 ## v1.16.2
 
   - Improve timer heap performance by batching scheduled timer insertion, compacting cancelled timers during flush, and avoiding unnecessary heap rebuilds for small incremental inserts.

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: io-event
 version: !ruby/object:Gem::Version
-  version: 1.16.2
+  version: 1.16.4
 platform: ruby
 authors:
 - Samuel Williams
 - Math Ieu
 - Wander Hillen
 - Jean Boussier
+- Tavian Barnes
 - Benoit Daloze
 - Bruno Sutic
 - Shizuo Fujita
-- Tavian Barnes
 - Alex Matchneer
 - Anthony Ross
 - Delton Ding