io-event 1.14.3 → 1.14.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 153dd5fa3b8e1b61e31f0304ac5b0c3dd274a877899b7569d092865219cd18e8
-  data.tar.gz: 5eae7ea5c192e2df1e3c02738dc76a6c3072ad0265eee78b26ee74a17ce43697
+  metadata.gz: f6141a80c8923fb24a4073f61f45a2e2f8065e4f2b415108caa39229efe37d0b
+  data.tar.gz: 298a552f835530283020945d5005912263d0dc3042271fbc5eeb84d3f00b8bda
 SHA512:
-  metadata.gz: 9b85b8d27de9d9319fcba699b6c939670a898210170f842ff7381a8f0446d04c1ca7da3f994265ce77cd2631ee621cbcb6943d39eb386045a169675d87a7d8f3
-  data.tar.gz: 3b4482cbe17cef909e01fb1701b30320f46497c97a3a7c77fe1c11da33cfd4eb20353dcc68476b25c147f410e217b42a45c9a1c0ee14e8dca1f54ceaf0051619
+  metadata.gz: 64566ccf2e42e38dde477984ae4c511d2c673b1869e266f49ecda467ddcccef28167a345dcca11126e05e0345ebe58b550981e1c135ca982a8ad7b56d5748418
+  data.tar.gz: c56c85168138319c4c527843484bfbbd7a3b685e72bf546aa32e6c01d6476ccc32e3f073aa1062d8699e916eba1d78de7fe263caff00db376c522c220ddc1aa1

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

@@ -2,9 +2,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.
 # 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/epoll.c

@@ -147,7 +147,7 @@ void IO_Event_Selector_EPoll_Type_free(void *_selector)
 	
 	IO_Event_Array_free(&selector->descriptors);
 	
-	free(selector);
+	xfree(selector);
 }
 
 static

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

@@ -146,7 +146,7 @@ void IO_Event_Selector_KQueue_Type_free(void *_selector)
 	
 	IO_Event_Array_free(&selector->descriptors);
 	
-	free(selector);
+	xfree(selector);
 }
 
 static

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

@@ -116,7 +116,7 @@ void IO_Event_Selector_URing_Type_free(void *_selector)
 	
 	IO_Event_Array_free(&selector->completions);
 	
-	free(selector);
+	xfree(selector);
 }
 
 static

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

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::WRITABLE)
-								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::WRITABLE)
-								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.3"
+		VERSION = "1.14.5"
 	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,10 @@ 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.  
+Copyright, 2026, by John Hawthorn.  
 
 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.4
+
+  - Allow `epoll_pwait2` to be disabled via `--disable-epoll_pwait2`.
+
 ### v1.14.3
 
   - Fix several implementation bugs that could cause deadlocks on blocking writes.
@@ -55,10 +59,6 @@ Please see the [project releases](https://socketry.github.io/io-event/releases/i
 
   - Detecting fibers that are stalling the event loop.
 
-### v1.7.5
-
-  - Fix `process_wait` race condition on EPoll that could cause a hang.
-
 ## Contributing
 
 We welcome contributions to this project.
@@ -69,6 +69,23 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
+### Running Tests
+
+To run the test suite:
+
+``` shell
+bundle exec bake build
+bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
+
 ### Developer Certificate of Origin
 
 In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v1.14.4
+
+  - Allow `epoll_pwait2` to be disabled via `--disable-epoll_pwait2`.
+
 ## v1.14.3
 
   - Fix several implementation bugs that could cause deadlocks on blocking writes.
@@ -56,10 +60,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.3
+  version: 1.14.5
 platform: ruby
 authors:
 - Samuel Williams
@@ -14,8 +14,12 @@ authors:
 - Alex Matchneer
 - Anthony Ross
 - Delton Ding
+- John Hawthorn
+- Luke Gruber
 - Pavel Rosický
+- Stan Hu
 - Stanislav (Stas) Katkov
+- William T. Nelson
 bindir: bin
 cert_chain:
 - |
@@ -109,14 +113,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: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: An event loop.
 test_files: []