io-event 1.14.2 → 1.14.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0deb2b3991062957f5767ac97e9abf7fe72b20e2264d08fd81293c407f92024f
-  data.tar.gz: 93b9e08ea55f39b5b983b8627b91720047154a2f778d86fea620da54d5e3173c
+  metadata.gz: e9427c8ecb6a9bd50366bb9e83324a7777421b00e7e286d58579850d19c8cb70
+  data.tar.gz: a22a8091b388a3f737501f7048d743d898cd4e271c0cfef79e7d4003ebff38bb
 SHA512:
-  metadata.gz: 2e58ec44e475bad561ddd53797a1552037fc92a4602dd89f6af92148130d4486d7dca47b6ae09bf11373be7e393a1baea835ae29e3ea388da4d4189b1d87be47
-  data.tar.gz: 9040993cc15180b65f142a28529d6672dceb88de0ae887ca9f1815bf0e11d4fe7929a3295ec50110b6c7faab83728cf36bf5c51d564b377eca4af40b756e9140
+  metadata.gz: a929a416fd1ae9f790102275d571e637543cf3dd5f1520cb92032d2b7c0974774d557890a13631eac2f40d8257a5b75f5da0fd4bcce0ac96197ad824669ef941
+  data.tar.gz: 4d9ff031fb26b596a3e654b7525c9f6bf302006cb424c904dcf2045f4861bcd7158cebb3096b2739a76d5dd4ec2a4466dbe0b2f395aa675ef8c165aad3896f8a

data/context/getting-started.md

@@ -22,8 +22,8 @@ $ bundle add io-event
 This example shows how to perform a blocking operation 
 
 ```ruby
-require 'fiber'
-require 'io/event'
+require "fiber"
+require "io/event"
 
 selector = IO::Event::Selector.new(Fiber.current)
 input, output = IO.pipe

data/ext/extconf.rb

@@ -5,6 +5,7 @@
 # Copyright, 2021-2025, by Samuel Williams.
 # Copyright, 2023, by Math Ieu.
 # Copyright, 2025, by Stanislav (Stas) Katkov.
+# Copyright, 2026, by Stan Hu.
 
 return if RUBY_DESCRIPTION =~ /jruby/
 
@@ -54,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")
+have_func("epoll_pwait2") if enable_config("epoll_pwait2", true)
 
 have_header("ruby/io/buffer.h")
 

data/ext/io/event/selector/kqueue.c

@@ -728,7 +728,7 @@ VALUE io_write_loop(VALUE _arguments) {
 			break;
 		} else if (length > 0 && IO_Event_try_again(errno)) {
 			if (DEBUG_IO_WRITE) fprintf(stderr, "IO_Event_Selector_KQueue_io_wait(fd=%d, length=%zu)\n", arguments->descriptor, length);
-			IO_Event_Selector_KQueue_io_wait(arguments->self, arguments->fiber, arguments->io, RB_INT2NUM(IO_EVENT_READABLE));
+			IO_Event_Selector_KQueue_io_wait(arguments->self, arguments->fiber, arguments->io, RB_INT2NUM(IO_EVENT_WRITABLE));
 		} else {
 			if (DEBUG_IO_WRITE) fprintf(stderr, "io_write_loop(fd=%d, length=%zu) -> errno=%d\n", arguments->descriptor, length, errno);
 			return rb_fiber_scheduler_io_result(-1, errno);
@@ -737,7 +737,7 @@ VALUE io_write_loop(VALUE _arguments) {
 		maximum_size = size - offset;
 	}
 	
-	if (DEBUG_IO_READ) fprintf(stderr, "io_write_loop(fd=%d, length=%zu) -> %zu\n", arguments->descriptor, length, offset);
+	if (DEBUG_IO_WRITE) fprintf(stderr, "io_write_loop(fd=%d, length=%zu) -> %zu\n", arguments->descriptor, length, offset);
 	return rb_fiber_scheduler_io_result(total, 0);
 };
 

data/ext/io/event/selector/selector.c

@@ -29,7 +29,7 @@ VALUE IO_Event_Selector_process_status_wait(rb_pid_t pid, int flags)
 int IO_Event_Selector_nonblock_set(int file_descriptor)
 {
 #ifdef _WIN32
-	rb_w32_set_nonblock(file_descriptor);
+	return rb_w32_set_nonblock(file_descriptor);
 #else
 	// Get the current mode:
 	int flags = fcntl(file_descriptor, F_GETFL, 0);

data/ext/io/event/selector/uring.c

@@ -988,6 +988,10 @@ VALUE IO_Event_Selector_URing_io_close(VALUE self, VALUE io) {
 		io_uring_prep_close(sqe, descriptor);
 		io_uring_sqe_set_data(sqe, NULL);
 		io_uring_submit_now(selector);
+		
+		// It would be nice to explore not flushing immediately, but instead deferring to the next select cycle.
+		// The problem with this approach is that if the user expects the file descriptor to be closed immediately, (e.g. before fork), it may not be closed in time.
+		// io_uring_submit_pending(selector);
 	} else {
 		close(descriptor);
 	}
@@ -1101,13 +1105,19 @@ unsigned select_process_completions(struct IO_Event_Selector_URing *selector) {
 		}
 		
 		io_uring_cq_advance(ring, 1);
-		// This marks the waiting operation as "complete":
-		IO_Event_Selector_URing_Completion_release(selector, completion);
 		
+		VALUE fiber = 0;
 		if (waiting && waiting->fiber) {
 			assert(waiting->result != -ECANCELED);
 			
-			IO_Event_Selector_loop_resume(&selector->backend, waiting->fiber, 0, NULL);
+			fiber = waiting->fiber;
+		}
+
+		// This marks the waiting operation as "complete":
+		IO_Event_Selector_URing_Completion_release(selector, completion);
+		
+		if (fiber) {
+			IO_Event_Selector_loop_resume(&selector->backend, fiber, 0, NULL);
 		}
 	}
 	

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

@@ -1,9 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
-
-require_relative "../support"
+# Copyright, 2021-2026, by Samuel Williams.
 
 module IO::Event
 	# @namespace
@@ -128,6 +126,12 @@ module IO::Event
 				@selector.ready?
 			end
 			
+			# Run the given blocking operation and wait for its completion.
+			def blocking_operation_wait(operation)
+				log("Waiting for blocking operation #{operation.inspect}")
+				@selector.blocking_operation_wait(operation)
+			end
+			
 			# Wait for the given process, forwarded to the underlying selector.
 			def process_wait(*arguments)
 				log("Waiting for process with #{arguments.inspect}")

data/lib/io/event/priority_heap.rb

@@ -2,7 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2021, by Wander Hillen.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 class IO
 	module Event
@@ -152,7 +152,7 @@ class IO
 				original_size = @contents.size
 				
 				# Filter out elements that match the condition - O(n)
-				@contents.reject! {|element| yield(element)}
+				@contents.reject!{|element| yield(element)}
 				
 				# If we removed elements, rebuild the heap - O(n)
 				if @contents.size < original_size
@@ -166,7 +166,7 @@ class IO
 			# Validate the heap invariant. Every element except the root must not be smaller than its parent element. Note that it MAY be equal.
 			def valid?
 				# Notice we skip index 0 on purpose, because it has no parent:
-				(1..(@contents.size - 1)).all? {|index| @contents[index] >= @contents[(index - 1) / 2]}
+				(1..(@contents.size - 1)).all?{|index| @contents[index] >= @contents[(index - 1) / 2]}
 			end
 			
 			private

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

@@ -1,11 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 # Copyright, 2023, by Math Ieu.
 
 require_relative "../interrupt"
-require_relative "../support"
 
 module IO::Event
 	module Selector
@@ -184,127 +183,64 @@ module IO::Event
 				errno == EAGAIN or errno == EWOULDBLOCK
 			end
 			
-			if Support.fiber_scheduler_v3?
-				# Ruby 3.3+, full IO::Buffer support.
+			# Read from the given IO to the buffer.
+			#
+			# @parameter length [Integer] The minimum number of bytes to read.
+			# @parameter offset [Integer] The offset into the buffer to read to.
+			def io_read(fiber, io, buffer, length, offset = 0)
+				total = 0
 				
-				# Read from the given IO to the buffer.
-				#
-				# @parameter length [Integer] The minimum number of bytes to read.
-				# @parameter offset [Integer] The offset into the buffer to read to.
-				def io_read(fiber, io, buffer, length, offset = 0)
-					total = 0
-					
-					Selector.nonblock(io) do
-						while true
-							result = Fiber.blocking{buffer.read(io, 0, offset)}
-							
-							if result < 0
-								if length > 0 and again?(result)
-									self.io_wait(fiber, io, IO::READABLE)
-								else
-									return result
-								end
-							elsif result == 0
-								break
+				Selector.nonblock(io) do
+					while true
+						result = Fiber.blocking{buffer.read(io, 0, offset)}
+						
+						if result < 0
+							if length > 0 and again?(result)
+								self.io_wait(fiber, io, IO::READABLE)
 							else
-								total += result
-								break if total >= length
-								offset += result
+								return result
 							end
+						elsif result == 0
+							break
+						else
+							total += result
+							break if total >= length
+							offset += result
 						end
 					end
-					
-					return total
 				end
 				
-				# Write to the given IO from the buffer.
-				#
-				# @parameter length [Integer] The minimum number of bytes to write.
-				# @parameter offset [Integer] The offset into the buffer to write from.
-				def io_write(fiber, io, buffer, length, offset = 0)
-					total = 0
-					
-					Selector.nonblock(io) do
-						while true
-							result = Fiber.blocking{buffer.write(io, 0, offset)}
-							
-							if result < 0
-								if length > 0 and again?(result)
-									self.io_wait(fiber, io, IO::READABLE)
-								else
-									return result
-								end
-							elsif result == 0
-								break result
+				return total
+			end
+			
+			# Write to the given IO from the buffer.
+			#
+			# @parameter length [Integer] The minimum number of bytes to write.
+			# @parameter offset [Integer] The offset into the buffer to write from.
+			def io_write(fiber, io, buffer, length, offset = 0)
+				total = 0
+				
+				Selector.nonblock(io) do
+					while true
+						result = Fiber.blocking{buffer.write(io, 0, offset)}
+						
+						if result < 0
+							if length > 0 and again?(result)
+								self.io_wait(fiber, io, IO::WRITABLE)
 							else
-								total += result
-								break if total >= length
-								offset += result
-							end
-						end
-					end
-					
-					return total
-				end
-			elsif Support.fiber_scheduler_v2?
-				# Ruby 3.2, most IO::Buffer support, but slightly clunky read/write methods.
-				def io_read(fiber, io, buffer, length, offset = 0)
-					total = 0
-					
-					Selector.nonblock(io) do
-						maximum_size = buffer.size - offset
-						while maximum_size > 0
-							result = Fiber.blocking{buffer.read(io, maximum_size, offset)}
-							
-							if again?(result)
-								if length > 0
-									self.io_wait(fiber, io, IO::READABLE)
-								else
-									return result
-								end
-							elsif result < 0
 								return result
-							else
-								total += result
-								offset += result
-								break if total >= length
 							end
-							
-							maximum_size = buffer.size - offset
+						elsif result == 0
+							break result
+						else
+							total += result
+							break if total >= length
+							offset += result
 						end
 					end
-					
-					return total
 				end
 				
-				def io_write(fiber, io, buffer, length, offset = 0)
-					total = 0
-					
-					Selector.nonblock(io) do
-						maximum_size = buffer.size - offset
-						while maximum_size > 0
-							result = Fiber.blocking{buffer.write(io, maximum_size, offset)}
-							
-							if again?(result)
-								if length > 0
-									self.io_wait(fiber, io, IO::READABLE)
-								else
-									return result
-								end
-							elsif result < 0
-								return result
-							else
-								total += result
-								offset += result
-								break if total >= length
-							end
-							
-							maximum_size = buffer.size - offset
-						end
-					end
-					
-					return total
-				end
+				return total
 			end
 			
 			# Wait for a process to change state.

data/lib/io/event/selector.rb

@@ -1,11 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "selector/select"
 require_relative "debug/selector"
-require_relative "support"
 
 module IO::Event
 	# @namespace

data/lib/io/event/support.rb

@@ -1,50 +1,16 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2025, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
 
 class IO
 	module Event
-		# Helper methods for detecting support for various features.
+		# @namespace
 		module Support
-			# Some features are only availble if the IO::Buffer class is available.
-			#
-			# @returns [Boolean] Whether the IO::Buffer class is available.
+			# Check if the `IO::Buffer` class is available.
 			def self.buffer?
 				IO.const_defined?(:Buffer)
 			end
-			
-			# More advanced read/write methods and blocking controls were introduced in Ruby 3.2.
-			#
-			# To be removed on 31 Mar 2026.
-			def self.fiber_scheduler_v2?
-				if RUBY_VERSION >= "3.2"
-					return true if RUBY_VERSION >= "3.2.6"
-					
-					# Some interface changes were back-ported incorrectly and released in 3.2.5 <https://github.com/ruby/ruby/pull/10778> - Specifically "Improvements to IO::Buffer read/write/pread/pwrite." is missing correct size calculation.
-					return false if RUBY_VERSION >= "3.2.5"
-					
-					# Feature detection:
-					IO.const_defined?(:Buffer) and Fiber.respond_to?(:blocking) and IO::Buffer.instance_method(:read).arity == -1
-				end
-			end
-			
-			# Updated inferfaces for read/write and IO::Buffer were introduced in Ruby 3.3, including pread/pwrite.
-			#
-			# To become the default 31 Mar 2026.
-			def self.fiber_scheduler_v3?
-				return true if RUBY_VERSION >= "3.3"
-				
-				if fiber_scheduler_v2?
-					# Feature detection if required:
-					begin
-						IO::Buffer.new.slice(0, 0).write(STDOUT)
-						return true
-					rescue
-						return false
-					end
-				end
-			end
 		end
 	end
 end

data/lib/io/event/version.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 # @namespace
 class IO
 	# @namespace
 	module Event
-		VERSION = "1.14.2"
+		VERSION = "1.14.4"
 	end
 end

data/lib/io/event.rb

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "event/version"
+require_relative "event/support"
 require_relative "event/selector"
 require_relative "event/timers"
 require_relative "event/native"

data/license.md

@@ -1,7 +1,7 @@
 # MIT License
 
 Copyright, 2021, by Wander Hillen.  
-Copyright, 2021-2025, by Samuel Williams.  
+Copyright, 2021-2026, by Samuel Williams.  
 Copyright, 2021, by Delton Ding.  
 Copyright, 2021-2024, by Benoit Daloze.  
 Copyright, 2022, by Alex Matchneer.  
@@ -12,6 +12,9 @@ Copyright, 2024, by Anthony Ross.
 Copyright, 2024-2025, by Shizuo Fujita.  
 Copyright, 2024, by Jean Boussier.  
 Copyright, 2025, by Stanislav (Stas) Katkov.  
+Copyright, 2025, by Luke Gruber.  
+Copyright, 2026, by William T. Nelson.  
+Copyright, 2026, by Stan Hu.  
 
 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

@@ -18,6 +18,10 @@ 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.14.3
+
+  - Fix several implementation bugs that could cause deadlocks on blocking writes.
+
 ### v1.14.0
 
   - [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)

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v1.14.3
+
+  - Fix several implementation bugs that could cause deadlocks on blocking writes.
+
 ## v1.14.0
 
 ### Enhanced `IO::Event::PriorityHeap` with deletion and bulk insertion methods
@@ -52,10 +56,10 @@ class MyScheduler
 	def initialize
 		@worker_pool = IO::Event::WorkerPool.new
 	end
-
-  def blocking_operation_wait(operation)
-    @worker_pool.call(operation)
-  end
+	
+	def blocking_operation_wait(operation)
+		@worker_pool.call(operation)
+	end
 end
 
 # Usage with automatic offloading

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-event
 version: !ruby/object:Gem::Version
-  version: 1.14.2
+  version: 1.14.4
 platform: ruby
 authors:
 - Samuel Williams
@@ -14,8 +14,11 @@ authors:
 - Alex Matchneer
 - Anthony Ross
 - Delton Ding
+- Luke Gruber
 - Pavel Rosický
+- Stan Hu
 - Stanislav (Stas) Katkov
+- William T. Nelson
 bindir: bin
 cert_chain:
 - |
@@ -109,14 +112,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.6
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: An event loop.
 test_files: []