io-event 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7265f0fb5702ae05b5d928a8efb9e5a5e877f62afc5c93d23fec26f8a3dd1437
-  data.tar.gz: 8ba9b4b0d4e95be1401b8952cccac1a9bcc93c7a0a40e843aea60f0015c791ad
+  metadata.gz: ec418d3289f8648ac13d7808bbe8d56b50a3b4cf518f61da116c56c3c345daa9
+  data.tar.gz: 8de6423981f2bfb2da54e0cd99e493787253a2c2c83bc644f72fffdcf52a295c
 SHA512:
-  metadata.gz: b4346972aa2dbe00b560e2a1e2cce32a50e9acafaa0c9253f12791c183f35bea8e3cffba93eb93147b4d975ef05edeffef84e0ed8bf29934fb39c70ea1320c6f
-  data.tar.gz: 41b6b53ca30bd0934c702c1ff0899e0e8a6bd3bc97a95f455b0d6cf0be28ff690b69575c44d92a784226edea27958cd43c486e9d907989859e298d602536078b
+  metadata.gz: 9fd70cf075b1703fd8e4659fa2adaf7381f7d5523e47e8700eeda233a01679c671ebb8197fd06f525da17b7a30332e996dd087874503f8ff7a594b8f88268554
+  data.tar.gz: c42e23c74e1069fb199fd1044b7fc487b8f1587294703a19362242bbbfa23c21fbba36a6a114fafb978ddc4cfcd2a21d2a6c7b7c3d3dc1c4a08094ca9b51bd2a

data/ext/extconf.rb

@@ -22,7 +22,7 @@ if ENV.key?("RUBY_DEBUG")
 	$CFLAGS << " -DRUBY_DEBUG -O0"
 end
 
-$srcs = ["io/event/event.c", "io/event/time.c", "io/event/fiber.c", "io/event/profiler.c", "io/event/selector/selector.c"]
+$srcs = ["io/event/event.c", "io/event/time.c", "io/event/fiber.c", "io/event/selector/selector.c"]
 $VPATH << "$(srcdir)/io/event"
 $VPATH << "$(srcdir)/io/event/selector"
 

data/ext/io/event/event.c

@@ -3,9 +3,7 @@
 
 #include "event.h"
 #include "fiber.h"
-#include "profiler.h"
 #include "selector/selector.h"
-#include <complex.h>
 
 void Init_IO_Event(void)
 {
@@ -16,7 +14,6 @@ void Init_IO_Event(void)
 	VALUE IO_Event = rb_define_module_under(rb_cIO, "Event");
 	
 	Init_IO_Event_Fiber(IO_Event);
-	Init_IO_Event_Profiler(IO_Event);
 	
 	VALUE IO_Event_Selector = rb_define_module_under(IO_Event, "Selector");
 	Init_IO_Event_Selector(IO_Event_Selector);

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

@@ -1035,7 +1035,25 @@ VALUE IO_Event_Selector_EPoll_wakeup(VALUE self) {
 	return Qfalse;
 }
 
+static int IO_Event_Selector_EPoll_supported_p(void) {
+	int fd = epoll_create1(EPOLL_CLOEXEC);
+	
+	if (fd < 0) {
+		rb_warn("epoll_create1() was available at compile time but failed at run time: %s\n", strerror(errno));
+		
+		return 0;
+	}
+	
+	close(fd);
+	
+	return 1;
+}
+
 void Init_IO_Event_Selector_EPoll(VALUE IO_Event_Selector) {
+	if (!IO_Event_Selector_EPoll_supported_p()) {
+		return;
+	}
+	
 	VALUE IO_Event_Selector_EPoll = rb_define_class_under(IO_Event_Selector, "EPoll", rb_cObject);
 	
 	rb_define_alloc_func(IO_Event_Selector_EPoll, IO_Event_Selector_EPoll_allocate);

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

@@ -1045,7 +1045,26 @@ VALUE IO_Event_Selector_KQueue_wakeup(VALUE self) {
 	return Qfalse;
 }
 
+
+static int IO_Event_Selector_KQueue_supported_p(void) {
+	int fd = kqueue();
+	
+	if (fd < 0) {
+		rb_warn("kqueue() was available at compile time but failed at run time: %s\n", strerror(errno));
+		
+		return 0;
+	}
+	
+	close(fd);
+	
+	return 1;
+}
+
 void Init_IO_Event_Selector_KQueue(VALUE IO_Event_Selector) {
+	if (!IO_Event_Selector_KQueue_supported_p()) {
+		return;
+	}
+	
 	VALUE IO_Event_Selector_KQueue = rb_define_class_under(IO_Event_Selector, "KQueue", rb_cObject);
 	
 	rb_define_alloc_func(IO_Event_Selector_KQueue, IO_Event_Selector_KQueue_allocate);

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

@@ -1175,7 +1175,26 @@ VALUE IO_Event_Selector_URing_wakeup(VALUE self) {
 
 #pragma mark - Native Methods
 
+static int IO_Event_Selector_URing_supported_p(void) {
+	struct io_uring ring;
+	int result = io_uring_queue_init(32, &ring, 0);
+	
+	if (result < 0) {
+		rb_warn("io_uring_queue_init() was available at compile time but failed at run time: %s\n", strerror(-result));
+		
+		return 0;
+	}
+	
+	io_uring_queue_exit(&ring);
+	
+	return 1;
+}
+
 void Init_IO_Event_Selector_URing(VALUE IO_Event_Selector) {
+	if (!IO_Event_Selector_URing_supported_p()) {
+		return;
+	}
+	
 	VALUE IO_Event_Selector_URing = rb_define_class_under(IO_Event_Selector, "URing", rb_cObject);
 	
 	rb_define_alloc_func(IO_Event_Selector_URing, IO_Event_Selector_URing_allocate);

data/lib/io/event/version.rb

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

data/readme.md

@@ -1,4 +1,4 @@
-# ![Event](logo.svg)
+# ![IO::Event](logo.svg)
 
 Provides low level cross-platform primitives for constructing event loops, with support for `select`, `kqueue`, `epoll` and `io_uring`.
 
@@ -18,13 +18,18 @@ 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.10.0
+
+  - `IO::Event::Profiler` is moved to dedicated gem: [fiber-profiler](https://github.com/socketry/fiber-profiler).
+  - Perform runtime checks for native selectors to ensure they are supported in the current environment. While compile-time checks determine availability, restrictions like seccomp and SELinux may still prevent them from working.
+
 ### v1.9.0
 
-  - [Improved `IO::Event::Profiler` for detecting stalls.](https://socketry.github.io/io-event/releases/index#improved-io::event::profiler-for-detecting-stalls.)
+  - Improved `IO::Event::Profiler` for detecting stalls.
 
 ### v1.8.0
 
-  - [Detecting fibers that are stalling the event loop.](https://socketry.github.io/io-event/releases/index#detecting-fibers-that-are-stalling-the-event-loop.)
+  - Detecting fibers that are stalling the event loop.
 
 ### v1.7.5
 

data/releases.md

@@ -1,56 +1,17 @@
 # Releases
 
-## v1.9.0
-
-### Improved `IO::Event::Profiler` for detecting stalls.
-
-A new `IO::Event::Profiler` class has been added to help detect stalls in the event loop. The previous approach was insufficient to detect all possible stalls. This new approach uses the `RUBY_EVENT_FIBER_SWITCH` event to track context switching by the scheduler, and can detect stalls no matter how they occur.
-
-``` ruby
-profiler = IO::Event::Profiler.new
+## v1.10.0
 
-profiler.start
-		
-Fiber.new do
-	sleep 1.0
-end.transfer
+  - `IO::Event::Profiler` is moved to dedicated gem: [fiber-profiler](https://github.com/socketry/fiber-profiler).
+  - Perform runtime checks for native selectors to ensure they are supported in the current environment. While compile-time checks determine availability, restrictions like seccomp and SELinux may still prevent them from working.
 
-profiler.stop
-```
-
-A default profiler is exposed using `IO::Event::Profiler.default` which is controlled by the following environment variables:
-
-  - `IO_EVENT_PROFILER=true` - Enable the profiler, otherwise `IO::Event::Profiler.default` will return `nil`.
-  - `IO_EVENT_PROFILER_LOG_THRESHOLD` - Specify the threshold in seconds for logging a stall. Defaults to `0.01`.
-  - `IO_EVENT_PROFILER_TRACK_CALLS` - Track the method call for each event, in order to log specifically which method is causing the stall. Defaults to `true`.
+## v1.9.0
 
-The previous environment variables `IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD` and `IO_EVENT_SELECTOR_STALL_LOG` no longer have any effect.
+  - Improved `IO::Event::Profiler` for detecting stalls.
 
 ## v1.8.0
 
-### Detecting fibers that are stalling the event loop.
-
-A new (experimental) feature for detecting fiber stalls has been added. This feature is disabled by default and can be enabled by setting the `IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD` to `true` or a floating point number representing the threshold in seconds.
-
-When enabled, the event loop will measure and profile user code when resuming a fiber. If the fiber takes too long to return back to the event loop, the event loop will log a warning message with a profile of the fiber's execution.
-
-    > cat test.rb 
-    #!/usr/bin/env ruby
-    
-    require_relative "lib/async"
-    
-    Async do
-    	Fiber.blocking do
-    		sleep 1
-    	end
-    end
-    
-    > IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD=true bundle exec ./test.rb
-    Fiber stalled for 1.003 seconds
-    	/home/samuel/Developer/socketry/async/test.rb:6 in '#<Class:Fiber>#blocking' (1s)
-    		/home/samuel/Developer/socketry/async/test.rb:7 in 'Kernel#sleep' (1s)
-
-There is a performance overhead to this feature, so it is recommended to only enable it when debugging performance issues.
+  - Detecting fibers that are stalling the event loop.
 
 ## v1.7.5
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-event
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -46,7 +46,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-02-10 00:00:00.000000000 Z
+date: 2025-03-12 00:00:00.000000000 Z
 dependencies: []
 executables: []
 extensions:
@@ -63,8 +63,6 @@ files:
 - ext/io/event/interrupt.c
 - ext/io/event/interrupt.h
 - ext/io/event/list.h
-- ext/io/event/profiler.c
-- ext/io/event/profiler.h
 - ext/io/event/selector/epoll.c
 - ext/io/event/selector/epoll.h
 - ext/io/event/selector/kqueue.c
@@ -81,7 +79,6 @@ files:
 - lib/io/event/interrupt.rb
 - lib/io/event/native.rb
 - lib/io/event/priority_heap.rb
-- lib/io/event/profiler.rb
 - lib/io/event/selector.rb
 - lib/io/event/selector/nonblock.rb
 - lib/io/event/selector/select.rb

data/ext/io/event/profiler.c

@@ -1,505 +0,0 @@
-// Released under the MIT License.
-// Copyright, 2025, by Samuel Williams.
-
-#include "profiler.h"
-
-#include "time.h"
-#include "fiber.h"
-#include "array.h"
-
-#include <ruby/debug.h>
-#include <stdio.h>
-
-VALUE IO_Event_Profiler = Qnil;
-
-struct IO_Event_Profiler_Call {
-	struct timespec enter_time;
-	struct timespec exit_time;
-	
-	size_t nesting;
-	
-	rb_event_flag_t event_flag;
-	ID id;
-	
-	VALUE klass;
-	const char *path;
-	int line;
-	
-	struct IO_Event_Profiler_Call *parent;
-};
-
-struct IO_Event_Profiler {
-	// Configuration:
-	float log_threshold;
-	int track_calls;
-	
-	// Whether or not the profiler is currently running:
-	int running;
-	
-	// Whether or not to capture call data:
-	int capture;
-	
-	size_t stalls;
-	
-	// From this point on, the state of any profile in progress:
-	struct timespec start_time;
-	struct timespec stop_time;
-	
-	// The depth of the call stack:
-	size_t nesting;
-	
-	// The current call frame:
-	struct IO_Event_Profiler_Call *current;
-	
-	struct IO_Event_Array calls;
-};
-
-void IO_Event_Profiler_reset(struct IO_Event_Profiler *profiler) {
-	profiler->nesting = 0;
-	profiler->current = NULL;
-	IO_Event_Array_truncate(&profiler->calls, 0);
-}
-
-void IO_Event_Profiler_Call_initialize(struct IO_Event_Profiler_Call *call) {
-	call->enter_time.tv_sec = 0;
-	call->enter_time.tv_nsec = 0;
-	call->exit_time.tv_sec = 0;
-	call->exit_time.tv_nsec = 0;
-	
-	call->nesting = 0;
-	
-	call->event_flag = 0;
-	call->id = 0;
-	
-	call->path = NULL;
-	call->line = 0;
-}
-
-void IO_Event_Profiler_Call_free(struct IO_Event_Profiler_Call *call) {
-	if (call->path) {
-		free((void*)call->path);
-		call->path = NULL;
-	}
-}
-
-static void IO_Event_Profiler_mark(void *ptr) {
-	struct IO_Event_Profiler *profiler = (struct IO_Event_Profiler*)ptr;
-	
-	// If `klass` is stored as a VALUE in calls, we need to mark them here:
-	for (size_t i = 0; i < profiler->calls.limit; i += 1) {
-		struct IO_Event_Profiler_Call *call = profiler->calls.base[i];
-		rb_gc_mark_movable(call->klass);
-	}
-}
-
-static void IO_Event_Profiler_compact(void *ptr) {
-	struct IO_Event_Profiler *profiler = (struct IO_Event_Profiler*)ptr;
-	
-	// If `klass` is stored as a VALUE in calls, we need to update their locations here:
-	for (size_t i = 0; i < profiler->calls.limit; i += 1) {
-			struct IO_Event_Profiler_Call *call = profiler->calls.base[i];
-			call->klass = rb_gc_location(call->klass);
-	}
-}
-
-static void IO_Event_Profiler_free(void *ptr) {
-	struct IO_Event_Profiler *profiler = (struct IO_Event_Profiler*)ptr;
-	
-	IO_Event_Array_free(&profiler->calls);
-	
-	free(profiler);
-}
-
-static size_t IO_Event_Profiler_memsize(const void *ptr) {
-	const struct IO_Event_Profiler *profiler = (const struct IO_Event_Profiler*)ptr;
-	return sizeof(*profiler) + IO_Event_Array_memory_size(&profiler->calls);
-}
-
-const rb_data_type_t IO_Event_Profiler_Type = {
-	.wrap_struct_name = "IO::Event::Profiler",
-	.function = {
-		.dmark = IO_Event_Profiler_mark,
-		.dcompact = IO_Event_Profiler_compact,
-		.dfree = IO_Event_Profiler_free,
-		.dsize = IO_Event_Profiler_memsize,
-	},
-	.flags = RUBY_TYPED_FREE_IMMEDIATELY | RUBY_TYPED_WB_PROTECTED,
-};
-
-struct IO_Event_Profiler *IO_Event_Profiler_get(VALUE self) {
-	struct IO_Event_Profiler *profiler;
-	TypedData_Get_Struct(self, struct IO_Event_Profiler, &IO_Event_Profiler_Type, profiler);
-	return profiler;
-}
-
-VALUE IO_Event_Profiler_allocate(VALUE klass) {
-	struct IO_Event_Profiler *profiler = ALLOC(struct IO_Event_Profiler);
-	
-	// Initialize the profiler state:
-	profiler->running = 0;
-	profiler->capture = 0;
-	profiler->stalls = 0;
-	profiler->nesting = 0;
-	profiler->current = NULL;
-	
-	profiler->calls.element_initialize = (void (*)(void*))IO_Event_Profiler_Call_initialize;
-	profiler->calls.element_free = (void (*)(void*))IO_Event_Profiler_Call_free;
-	IO_Event_Array_initialize(&profiler->calls, 0, sizeof(struct IO_Event_Profiler_Call));
-	
-	return TypedData_Wrap_Struct(klass, &IO_Event_Profiler_Type, profiler);
-}
-
-int IO_Event_Profiler_p(void) {
-	const char *enabled = getenv("IO_EVENT_PROFILER");
-	
-	if (enabled && strcmp(enabled, "true") == 0) {
-		return 1;
-	}
-	
-	return 0;
-}
-
-float IO_Event_Profiler_default_log_threshold(void) {
-	const char *log_threshold = getenv("IO_EVENT_PROFILER_LOG_THRESHOLD");
-	
-	if (log_threshold) {
-		return strtof(log_threshold, NULL);
-	} else {
-		return 0.01;
-	}
-}
-
-int IO_Event_Profiler_default_track_calls(void) {
-	const char *track_calls = getenv("IO_EVENT_PROFILER_TRACK_CALLS");
-	
-	if (track_calls && strcmp(track_calls, "false") == 0) {
-		return 0;
-	} else {
-		return 1;
-	}
-}
-
-VALUE IO_Event_Profiler_initialize(int argc, VALUE *argv, VALUE self) {
-	struct IO_Event_Profiler *profiler = IO_Event_Profiler_get(self);
-	VALUE log_threshold, track_calls;
-	
-	rb_scan_args(argc, argv, "02", &log_threshold, &track_calls);
-	
-	if (RB_NIL_P(log_threshold)) {
-		profiler->log_threshold = IO_Event_Profiler_default_log_threshold();
-	} else {
-		profiler->log_threshold = NUM2DBL(log_threshold);
-	}
-	
-	if (RB_NIL_P(track_calls)) {
-		profiler->track_calls = IO_Event_Profiler_default_track_calls();
-	} else {
-		profiler->track_calls = RB_TEST(track_calls);
-	}
-	
-	return self;
-}
-
-VALUE IO_Event_Profiler_default(VALUE klass) {
-	if (!IO_Event_Profiler_p()) {
-		return Qnil;
-	}
-	
-	VALUE profiler = IO_Event_Profiler_allocate(klass);
-	
-	struct IO_Event_Profiler *profiler_data = IO_Event_Profiler_get(profiler);
-	profiler_data->log_threshold = IO_Event_Profiler_default_log_threshold();
-	profiler_data->track_calls = IO_Event_Profiler_default_track_calls();
-	
-	return profiler;
-}
-
-VALUE IO_Event_Profiler_new(float log_threshold, int track_calls) {
-	VALUE profiler = IO_Event_Profiler_allocate(IO_Event_Profiler);
-	
-	struct IO_Event_Profiler *profiler_data = IO_Event_Profiler_get(profiler);
-	profiler_data->log_threshold = log_threshold;
-	profiler_data->track_calls = track_calls;
-	
-	return profiler;
-}
-
-int event_flag_call_p(rb_event_flag_t event_flags) {
-	return event_flags & (RUBY_EVENT_CALL | RUBY_EVENT_C_CALL | RUBY_EVENT_B_CALL);
-}
-
-int event_flag_return_p(rb_event_flag_t event_flags) {
-	return event_flags & (RUBY_EVENT_RETURN | RUBY_EVENT_C_RETURN | RUBY_EVENT_B_RETURN);
-}
-
-const char *event_flag_name(rb_event_flag_t event_flag) {
-	switch (event_flag) {
-		case RUBY_EVENT_CALL: return "call";
-		case RUBY_EVENT_C_CALL: return "c-call";
-		case RUBY_EVENT_B_CALL: return "b-call";
-		case RUBY_EVENT_RETURN: return "return";
-		case RUBY_EVENT_C_RETURN: return "c-return";
-		case RUBY_EVENT_B_RETURN: return "b-return";
-		default: return "unknown";
-	}
-}
-
-static struct IO_Event_Profiler_Call* profiler_event_record_call(struct IO_Event_Profiler *profiler, rb_event_flag_t event_flag, ID id, VALUE klass) {
-	struct IO_Event_Profiler_Call *call = IO_Event_Array_push(&profiler->calls);
-	
-	call->event_flag = event_flag;
-
-	call->parent = profiler->current;
-	profiler->current = call;
-
-	call->nesting = profiler->nesting;
-	profiler->nesting += 1;
-
-	if (id) {
-		call->id = id;
-		call->klass = klass;
-	} else {
-		rb_frame_method_id_and_class(&call->id, &call->klass);
-	}
-
-	const char *path = rb_sourcefile();
-	if (path) {
-		call->path = strdup(path);
-	}
-	call->line = rb_sourceline();
-	
-	return call;
-}
-
-void IO_Event_Profiler_fiber_switch(struct IO_Event_Profiler *profiler);
-
-static void IO_Event_Profiler_callback(rb_event_flag_t event_flag, VALUE data, VALUE self, ID id, VALUE klass) {
-	struct IO_Event_Profiler *profiler = IO_Event_Profiler_get(data);
-	
-	if (event_flag & RUBY_EVENT_FIBER_SWITCH) {
-		IO_Event_Profiler_fiber_switch(profiler);
-		return;
-	}
-	
-	// We don't want to capture data if we're not running:
-	if (!profiler->capture) return;
-	
-	if (event_flag_call_p(event_flag)) {
-		struct IO_Event_Profiler_Call *call = profiler_event_record_call(profiler, event_flag, id, klass);
-		IO_Event_Time_current(&call->enter_time);
-	}
-	
-	else if (event_flag_return_p(event_flag)) {
-		struct IO_Event_Profiler_Call *call = profiler->current;
-		
-		// We may encounter returns without a preceeding call. This isn't an error, but we should pretend like the call started at the beginning of the profiling session:
-		if (call == NULL) {
-			struct IO_Event_Profiler_Call *last_call = IO_Event_Array_last(&profiler->calls);
-			call = profiler_event_record_call(profiler, event_flag, id, klass);
-			
-			if (last_call) {
-				call->enter_time = last_call->enter_time;
-			} else {
-				call->enter_time = profiler->start_time;
-			}
-		}
-		
-		IO_Event_Time_current(&call->exit_time);
-		
-		profiler->current = call->parent;
-		
-		// We may encounter returns without a preceeding call.
-		if (profiler->nesting > 0)
-			profiler->nesting -= 1;
-	}
-}
-
-VALUE IO_Event_Profiler_start(VALUE self) {
-	struct IO_Event_Profiler *profiler = IO_Event_Profiler_get(self);
-	
-	if (profiler->running) return Qfalse;
-	
-	profiler->running = 1;
-	
-	IO_Event_Profiler_reset(profiler);
-	IO_Event_Time_current(&profiler->start_time);
-	
-	rb_event_flag_t event_flags = RUBY_EVENT_FIBER_SWITCH;
-	
-	if (profiler->track_calls) {
-		event_flags |= RUBY_EVENT_CALL | RUBY_EVENT_RETURN;
-		event_flags |= RUBY_EVENT_C_CALL | RUBY_EVENT_C_RETURN;
-		// event_flags |= RUBY_EVENT_B_CALL | RUBY_EVENT_B_RETURN;
-	}
-	
-	VALUE thread = rb_thread_current();
-	rb_thread_add_event_hook(thread, IO_Event_Profiler_callback, event_flags, self);
-	
-	return self;
-}
-
-VALUE IO_Event_Profiler_stop(VALUE self) {
-	struct IO_Event_Profiler *profiler = IO_Event_Profiler_get(self);
-	
-	if (!profiler->running) return Qfalse;
-	
-	profiler->running = 0;
-	
-	VALUE thread = rb_thread_current();
-	rb_thread_remove_event_hook_with_data(thread, IO_Event_Profiler_callback, self);
-	
-	IO_Event_Time_current(&profiler->stop_time);
-	IO_Event_Profiler_reset(profiler);
-	
-	return self;
-}
-
-static inline float IO_Event_Profiler_duration(struct IO_Event_Profiler *profiler) {
-	struct timespec duration;
-	
-	IO_Event_Time_current(&profiler->stop_time);
-	IO_Event_Time_elapsed(&profiler->start_time, &profiler->stop_time, &duration);
-	
-	return IO_Event_Time_duration(&duration);
-}
-
-void IO_Event_Profiler_print(struct IO_Event_Profiler *profiler, FILE *restrict stream);
-
-void IO_Event_Profiler_finish(struct IO_Event_Profiler *profiler) {
-	profiler->capture = 0;
-	
-	struct IO_Event_Profiler_Call *current = profiler->current;
-	while (current) {
-		IO_Event_Time_current(&current->exit_time);
-		
-		current = current->parent;
-	}
-}
-
-void IO_Event_Profiler_fiber_switch(struct IO_Event_Profiler *profiler)
-{
-	float duration = IO_Event_Profiler_duration(profiler);
-	
-	if (profiler->capture) {
-		IO_Event_Profiler_finish(profiler);
-		
-		if (duration > profiler->log_threshold) {
-			profiler->stalls += 1;
-			IO_Event_Profiler_print(profiler, stderr);
-		}
-	}
-	
-	IO_Event_Profiler_reset(profiler);
-	
-	if (!IO_Event_Fiber_blocking(IO_Event_Fiber_current())) {
-		// Reset the start time:
-		IO_Event_Time_current(&profiler->start_time);
-		
-		profiler->capture = 1;
-	}
-}
-
-static const float IO_EVENT_PROFILER_PRINT_MINIMUM_PROPORTION = 0.01;
-
-void IO_Event_Profiler_print_tty(struct IO_Event_Profiler *profiler, FILE *restrict stream) {
-	struct timespec total_duration = {};
-	IO_Event_Time_elapsed(&profiler->start_time, &profiler->stop_time, &total_duration);
-	
-	fprintf(stderr, "Fiber stalled for %.3f seconds\n", IO_Event_Time_duration(&total_duration));
-	
-	size_t skipped = 0;
-	
-	for (size_t i = 0; i < profiler->calls.limit; i += 1) {
-		struct IO_Event_Profiler_Call *call = profiler->calls.base[i];
-		struct timespec duration = {};
-		IO_Event_Time_elapsed(&call->enter_time, &call->exit_time, &duration);
-		
-		// Skip calls that are too short to be meaningful:
-		if (IO_Event_Time_proportion(&duration, &total_duration) < IO_EVENT_PROFILER_PRINT_MINIMUM_PROPORTION) {
-			skipped += 1;
-			continue;
-		}
-		
-		for (size_t i = 0; i < call->nesting; i += 1) {
-			fputc('\t', stream);
-		}
-		
-		VALUE class_inspect = rb_inspect(call->klass);
-		const char *name = rb_id2name(call->id);
-		
-		fprintf(stream, "%s:%d in %s '%s#%s' (" IO_EVENT_TIME_PRINTF_TIMESPEC "s)\n", call->path, call->line, event_flag_name(call->event_flag), RSTRING_PTR(class_inspect), name, IO_EVENT_TIME_PRINTF_TIMESPEC_ARGUMENTS(duration));
-	}
-	
-	if (skipped > 0) {
-		fprintf(stream, "Skipped %zu calls that were too short to be meaningful.\n", skipped);
-	}
-}
-
-void IO_Event_Profiler_print_json(struct IO_Event_Profiler *profiler, FILE *restrict stream) {
-	struct timespec total_duration = {};
-	IO_Event_Time_elapsed(&profiler->start_time, &profiler->stop_time, &total_duration);
-	
-	fputc('{', stream);
-	
-	fprintf(stream, "\"duration\":" IO_EVENT_TIME_PRINTF_TIMESPEC, IO_EVENT_TIME_PRINTF_TIMESPEC_ARGUMENTS(total_duration));
-	
-	size_t skipped = 0;
-	
-	fprintf(stream, ",\"calls\":[");
-	int first = 1;
-	
-	for (size_t i = 0; i < profiler->calls.limit; i += 1) {
-		struct IO_Event_Profiler_Call *call = profiler->calls.base[i];
-		struct timespec duration = {};
-		IO_Event_Time_elapsed(&call->enter_time, &call->exit_time, &duration);
-		
-		// Skip calls that are too short to be meaningful:
-		if (IO_Event_Time_proportion(&duration, &total_duration) < IO_EVENT_PROFILER_PRINT_MINIMUM_PROPORTION) {
-			skipped += 1;
-			continue;
-		}
-		
-		VALUE class_inspect = rb_inspect(call->klass);
-		const char *name = rb_id2name(call->id);
-		
-		fprintf(stream, "%s{\"path\":\"%s\",\"line\":%d,\"class\":\"%s\",\"method\":\"%s\",\"duration\":" IO_EVENT_TIME_PRINTF_TIMESPEC ",\"nesting\":%zu}", first ? "" : ",", call->path, call->line, RSTRING_PTR(class_inspect), name, IO_EVENT_TIME_PRINTF_TIMESPEC_ARGUMENTS(duration), call->nesting);
-		
-		first = 0;
-	}
-	
-	fprintf(stream, "]");
-	
-	if (skipped > 0) {
-		fprintf(stream, ",\"skipped\":%zu", skipped);
-	}
-	
-	fprintf(stream, "}\n");
-}
-
-void IO_Event_Profiler_print(struct IO_Event_Profiler *profiler, FILE *restrict stream) {
-	if (isatty(fileno(stream))) {
-		IO_Event_Profiler_print_tty(profiler, stream);
-	} else {
-		IO_Event_Profiler_print_json(profiler, stream);
-	}
-}
-
-VALUE IO_Event_Profiler_stalls(VALUE self) {
-	struct IO_Event_Profiler *profiler = IO_Event_Profiler_get(self);
-	
-	return SIZET2NUM(profiler->stalls);
-}
-
-void Init_IO_Event_Profiler(VALUE IO_Event) {
-	IO_Event_Profiler = rb_define_class_under(IO_Event, "Profiler", rb_cObject);
-	rb_define_alloc_func(IO_Event_Profiler, IO_Event_Profiler_allocate);
-	
-	rb_define_singleton_method(IO_Event_Profiler, "default", IO_Event_Profiler_default, 0);
-	
-	rb_define_method(IO_Event_Profiler, "initialize", IO_Event_Profiler_initialize, -1);
-	
-	rb_define_method(IO_Event_Profiler, "start", IO_Event_Profiler_start, 0);
-	rb_define_method(IO_Event_Profiler, "stop", IO_Event_Profiler_stop, 0);
-	
-	rb_define_method(IO_Event_Profiler, "stalls", IO_Event_Profiler_stalls, 0);
-}

data/ext/io/event/profiler.h

@@ -1,8 +0,0 @@
-// Released under the MIT License.
-// Copyright, 2025, by Samuel Williams.
-
-#pragma once
-
-#include <ruby.h>
-
-void Init_IO_Event_Profiler(VALUE IO_Event);

data/lib/io/event/profiler.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
-
-require_relative "native"
-
-module IO::Event
-	unless self.const_defined?(:Profiler)
-		module Profiler
-			# The default profiler, if the platform supports it.
-			# Use `IO_EVENT_PROFILER=true` to enable it.
-			def self.default
-				nil
-			end
-		end
-	end
-end