evt 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcbae12e6f731dbbd29a341c60bbb41ef1fabb6095b0bc581f1bce0a51d6a729
-  data.tar.gz: 46497ea730a052a6c8e0a390fa031e8b81dd7b2eb84f05152e85df286db9f20a
+  metadata.gz: f49f37d3240b1878b00acaeea453e00c9dae2a96c8c7f12889836d653d6b1835
+  data.tar.gz: 2af4b0238768dcb2b4112eaff379cad3899633eab69017517f36d5d51ba1fae7
 SHA512:
-  metadata.gz: 782544e4c98db9600fbacdeef1fdf85748494ed75e7ca4edbc154d483bf09da6ce4ff764600695368e6b7e47c26c0415523d303f74f1174b8c6c41e5130ac6b7
-  data.tar.gz: e763ec572a4289c1c14ed83503502ffa4ffd346a239e30510fe699eb46e72cbf5fad07e67caa3f8b416a5a42c2851bc483cc81d418e9dd02550afac39d8751a2
+  metadata.gz: 58222d04ff91f47667697fd63d6d235d85c8204e09a82ac18dbd05b27d37eb79d6bcda034117684e2d49cd0cd67d2818df5264a4f73751851f1ebefdbe3a9de2
+  data.tar.gz: 17c54e28beb805e30a3883446a807c5114287ba3c37b402a85dcba013f2910e8aca7d29c17efe527dd050a971f224ff0e8f4f2aacd36ef8cbe7970ff8aa06d56

data/.github/workflows/build.yml

@@ -0,0 +1,21 @@
+name: Build
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+jobs:
+  build:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@master
+        with:
+          ruby-version: '3.0'
+          bundler-cache: false
+      - name: Install Dependencies
+        run: |
+          gem install bundler
+          bundle install --jobs 4 --retry 3
+      - name: Build
+        run: rake build

data/.github/workflows/test.yml

@@ -37,18 +37,4 @@ jobs:
           DISABLE_KQUEUE: ${{ matrix.disable-kqueue }}
         run: rake compile
       - name: Test
-        run: rake
-  build:
-    runs-on: ubuntu-20.04
-    steps:
-      - uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@master
-        with:
-          ruby-version: '3.0'
-          bundler-cache: false
-      - name: Install Dependencies
-        run: |
-          gem install bundler
-          bundle install --jobs 4 --retry 3
-      - name: Build
-        run: gem build evt.gemspec
+        run: rake test

data/README.md

@@ -4,7 +4,8 @@ The Event Library that designed for Ruby 3.0 Fiber Scheduler.
 
 **This gem is still under development, APIs and features are not stable. Advices and PRs are highly welcome.**
 
-[![CI Tests](https://github.com/dsh0416/evt/workflows/CI%20Tests/badge.svg)](https://github.com/dsh0416/evt/actions?query=workflow%3A%22CI+Tests%22)
+[![CI Tests](https://github.com/dsh0416/evt/workflows/CI%20Tests/badge.svg)](https://github.com/dsh0416/evt/actions?query=workflow%3A%22Build%22)
+[![Build](https://github.com/dsh0416/evt/workflows/Build/badge.svg)](https://github.com/dsh0416/evt/actions?query=workflow%3A%22CI+Tests%22)
 [![Gem Version](https://badge.fury.io/rb/evt.svg)](https://rubygems.org/gems/evt)
 [![Downloads](https://ruby-gem-downloads-badge.herokuapp.com/evt?type=total)](https://rubygems.org/gems/evt)
 
@@ -69,8 +70,6 @@ Fiber.schedule do
   wr.close
 end
 
-scheduler.run
-
 # "Hello World"
 ```
 

data/Rakefile

@@ -11,6 +11,7 @@ Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
   t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
 end
 
 task :default => :test

data/evt.gemspec

@@ -18,10 +18,11 @@ Gem::Specification.new do |spec|
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|.vscode)/}) }
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|examples|.vscode)/}) }
   end
   spec.require_paths = ["lib"]
   spec.extensions = ['ext/evt/extconf.rb']
 
   spec.add_development_dependency 'rake-compiler', '~> 1.0'
+  spec.add_development_dependency 'simplecov', '~> 0.20.0'
 end

data/ext/evt/epoll.h

@@ -1,14 +1,14 @@
 #ifndef EPOLL_H
-#define EPOLL_G
+#define EPOLL_H
 #include "evt.h"
 
 #if HAVE_SYS_EPOLL_H
-VALUE method_scheduler_init(VALUE self) {
+VALUE method_scheduler_epoll_init(VALUE self) {
     rb_iv_set(self, "@epfd", INT2NUM(epoll_create(1))); // Size of epoll is ignored after Linux 2.6.8.
     return Qnil;
 }
 
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
+VALUE method_scheduler_epoll_register(VALUE self, VALUE io, VALUE interest) {
     struct epoll_event event;
     ID id_fileno = rb_intern("fileno");
     int epfd = NUM2INT(rb_iv_get(self, "@epfd"));
@@ -31,7 +31,7 @@ VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
     return Qnil;
 }
 
-VALUE method_scheduler_deregister(VALUE self, VALUE io) {
+VALUE method_scheduler_epoll_deregister(VALUE self, VALUE io) {
     ID id_fileno = rb_intern("fileno");
     int epfd = NUM2INT(rb_iv_get(self, "@epfd"));
     int fd = NUM2INT(rb_funcall(io, id_fileno, 0));
@@ -39,7 +39,7 @@ VALUE method_scheduler_deregister(VALUE self, VALUE io) {
     return Qnil;
 }
 
-VALUE method_scheduler_wait(VALUE self) {
+VALUE method_scheduler_epoll_wait(VALUE self) {
     int n, epfd, i, event_flag, timeout;
     VALUE next_timeout, obj_io, readables, writables, result;
     ID id_next_timeout = rb_intern("next_timeout");
@@ -82,7 +82,7 @@ VALUE method_scheduler_wait(VALUE self) {
     return result;
 }
 
-VALUE method_scheduler_backend(VALUE klass) {
+VALUE method_scheduler_epoll_backend(VALUE klass) {
     return rb_str_new_cstr("epoll");
 }
 #endif

data/ext/evt/evt.c

@@ -9,31 +9,37 @@ void Init_evt_ext()
     rb_ext_ractor_safe(true);
 #endif
     Evt = rb_define_module("Evt");
-    Scheduler = rb_define_class_under(Evt, "Scheduler", rb_cObject);
-    Payload = rb_define_class_under(Scheduler, "Payload", rb_cObject);
+    Bundled = rb_define_class_under(Evt, "Bundled", rb_cObject);
+    Payload = rb_define_class_under(Bundled, "Payload", rb_cObject);
     Fiber = rb_define_class("Fiber", rb_cObject);
-    rb_define_singleton_method(Scheduler, "backend", method_scheduler_backend, 0);
-    rb_define_method(Scheduler, "init_selector", method_scheduler_init, 0);
-    rb_define_method(Scheduler, "register", method_scheduler_register, 2);
-    rb_define_method(Scheduler, "deregister", method_scheduler_deregister, 1);
-    rb_define_method(Scheduler, "wait", method_scheduler_wait, 0);
-
-#if HAVELIBURING_H
-    rb_define_method(Scheduler, "io_read", method_scheduler_io_read, 4);
-    rb_define_method(Scheduler, "io_write", method_scheduler_io_write, 4);
+#if HAVE_LIBURING_H
+    rb_define_singleton_method(Bundled, "uring_backend", method_scheduler_uring_backend, 0);
+    rb_define_method(Bundled, "uring_init_selector", method_scheduler_uring_init, 0);
+    rb_define_method(Bundled, "uring_register", method_scheduler_uring_register, 2);
+    rb_define_method(Bundled, "uring_wait", method_scheduler_uring_wait, 0);
+    rb_define_method(Bundled, "uring_io_read", method_scheduler_uring_io_read, 4);
+    rb_define_method(Bundled, "uring_io_write", method_scheduler_uring_io_write, 4);
+#endif
+#if HAVE_SYS_EPOLL_H
+    rb_define_singleton_method(Bundled, "epoll_backend", method_scheduler_epoll_backend, 0);
+    rb_define_method(Bundled, "epoll_init_selector", method_scheduler_epoll_init, 0);
+    rb_define_method(Bundled, "epoll_register", method_scheduler_epoll_register, 2);
+    rb_define_method(Bundled, "epoll_deregister", method_scheduler_epoll_deregister, 1);
+    rb_define_method(Bundled, "epoll_wait", method_scheduler_epoll_wait, 0);
 #endif
+#if HAVE_SYS_EVENT_H
+    rb_define_singleton_method(Bundled, "kqueue_backend", method_scheduler_kqueue_backend, 0);
+    rb_define_method(Bundled, "kqueue_init_selector", method_scheduler_kqueue_init, 0);
+    rb_define_method(Bundled, "kqueue_register", method_scheduler_kqueue_register, 2);
+    rb_define_method(Bundled, "kqueue_wait", method_scheduler_kqueue_wait, 0);
+#endif
+    rb_define_singleton_method(Bundled, "select_backend", method_scheduler_select_backend, 0);
+    rb_define_method(Bundled, "select_wait", method_scheduler_select_wait, 0);
 }
 
-#if HAVE_LIBURING_H
-    #include "uring.h"
-#elif HAVE_SYS_EPOLL_H
-    #include "epoll.h"
-#elif HAVE_SYS_EVENT_H
-    #include "kqueue.h"
-#elif HAVE_WINDOWS_H
-    #include "select.h"
-    // #include "iocp.h"
-#else
-    #include "select.h"
-#endif
+#include "uring.h"
+#include "epoll.h"
+#include "kqueue.h"
+// #include "iocp.h"
+#include "select.h"
 #endif

data/ext/evt/evt.h

@@ -4,29 +4,22 @@
 #include <ruby.h>
 
 VALUE Evt = Qnil;
-VALUE Scheduler = Qnil;
+VALUE Bundled = Qnil;
 VALUE Payload = Qnil;
 VALUE Fiber = Qnil;
 
 void Init_evt_ext();
-VALUE method_scheduler_init(VALUE self);
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest);
-VALUE method_scheduler_deregister(VALUE self, VALUE io);
-VALUE method_scheduler_wait(VALUE self);
-VALUE method_scheduler_backend(VALUE klass);
-#if HAVE_LIBURING_H
-VALUE method_scheduler_io_read(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length);
-VALUE method_scheduler_io_write(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length);
-#endif
-
-#if HAV_WINDOWS_H
-VALUE method_scheduler_io_read(VALUE io, VALUE buffer, VALUE offset, VALUE length);
-VALUE method_scheduler_io_write(VALUE io, VALUE buffer, VALUE offset, VALUE length);
-#endif
 
 #if HAVE_LIBURING_H
-    #include <liburing.h>
+    VALUE method_scheduler_uring_init(VALUE self);
+    VALUE method_scheduler_uring_register(VALUE self, VALUE io, VALUE interest);
+    VALUE method_scheduler_uring_deregister(VALUE self, VALUE io);
+    VALUE method_scheduler_uring_wait(VALUE self);
+    VALUE method_scheduler_uring_backend(VALUE klass);
+    VALUE method_scheduler_uring_io_read(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length);
+    VALUE method_scheduler_uring_io_write(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length);
 
+    #include <liburing.h>
     #define URING_ENTRIES 64
     #define URING_MAX_EVENTS 64
 
@@ -49,13 +42,26 @@ VALUE method_scheduler_io_write(VALUE io, VALUE buffer, VALUE offset, VALUE leng
         .data = NULL,
         .flags = RUBY_TYPED_FREE_IMMEDIATELY,
     };
-#elif HAVE_SYS_EPOLL_H
+#endif
+#if HAVE_SYS_EPOLL_H
+    VALUE method_scheduler_epoll_init(VALUE self);
+    VALUE method_scheduler_epoll_register(VALUE self, VALUE io, VALUE interest);
+    VALUE method_scheduler_epoll_deregister(VALUE self, VALUE io);
+    VALUE method_scheduler_epoll_wait(VALUE self);
+    VALUE method_scheduler_epoll_backend(VALUE klass);
     #include <sys/epoll.h>
     #define EPOLL_MAX_EVENTS 64
-#elif HAVE_SYS_EVENT_H
+#endif
+#if HAVE_SYS_EVENT_H
+    VALUE method_scheduler_kqueue_init(VALUE self);
+    VALUE method_scheduler_kqueue_register(VALUE self, VALUE io, VALUE interest);
+    VALUE method_scheduler_kqueue_deregister(VALUE self, VALUE io);
+    VALUE method_scheduler_kqueue_wait(VALUE self);
+    VALUE method_scheduler_kqueue_backend(VALUE klass);
     #include <sys/event.h>
     #define KQUEUE_MAX_EVENTS 64
-#elif HAVE_WINDOWS_H
+#endif
+#if HAVE_WINDOWS_H
     // #include <Windows.h>
     // #define IOCP_MAX_EVENTS 64
 
@@ -79,4 +85,6 @@ VALUE method_scheduler_io_write(VALUE io, VALUE buffer, VALUE offset, VALUE leng
     //     .flags = RUBY_TYPED_FREE_IMMEDIATELY,
     // };
 #endif
+    VALUE method_scheduler_select_wait(VALUE self);
+    VALUE method_scheduler_select_backend(VALUE klass);
 #endif

data/ext/evt/iocp.h

@@ -11,13 +11,13 @@ size_t iocp_payload_size(const void* data) {
     return sizeof(HANDLE);
 }
 
-VALUE method_scheduler_init(VALUE self) {
+VALUE method_scheduler_iocp_init(VALUE self) {
     HANDLE iocp = CreateIoCompletionPort(INVALID_HANDLE_VALUE, NULL, 0, 0);
     rb_iv_set(self, "@iocp", TypedData_Wrap_Struct(Payload, &type_iocp_payload, iocp));
     return Qnil;
 }
 
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
+VALUE method_scheduler_iocp_register(VALUE self, VALUE io, VALUE interest) {
     HANDLE iocp;
     VALUE iocp_obj = rb_iv_get(self, "@iocp");
     struct iocp_data* data;
@@ -47,11 +47,7 @@ VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
     return Qnil;
 }
 
-VALUE method_scheduler_deregister(VALUE self, VALUE io) {
-    return Qnil;
-}
-
-VALUE method_scheduler_wait(VALUE self) {
+VALUE method_scheduler_iocp_wait(VALUE self) {
     ID id_next_timeout = rb_intern("next_timeout");
     ID id_push = rb_intern("push");
     VALUE iocp_obj = rb_iv_get(self, "@iocp");
@@ -119,7 +115,7 @@ VALUE method_scheduler_wait(VALUE self) {
     return result;
 }
 
-VALUE method_scheduler_backend(VALUE klass) {
+VALUE method_scheduler_iocp_backend(VALUE klass) {
     return rb_str_new_cstr("iocp");
 }
 #endif

data/ext/evt/kqueue.h

@@ -4,12 +4,12 @@
 
 #if HAVE_SYS_EVENT_H
 
-VALUE method_scheduler_init(VALUE self) {
+VALUE method_scheduler_kqueue_init(VALUE self) {
     rb_iv_set(self, "@kq", INT2NUM(kqueue()));
     return Qnil;
 }
 
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
+VALUE method_scheduler_kqueue_register(VALUE self, VALUE io, VALUE interest) {
     struct kevent event;
     u_short event_flags = 0;
     ID id_fileno = rb_intern("fileno");
@@ -32,12 +32,7 @@ VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
     return Qnil;
 }
 
-VALUE method_scheduler_deregister(VALUE self, VALUE io) {
-    // One-shot mode
-    return Qnil;
-}
-
-VALUE method_scheduler_wait(VALUE self) {
+VALUE method_scheduler_kqueue_wait(VALUE self) {
     int n, kq, i;
     u_short event_flags = 0;
     struct kevent events[KQUEUE_MAX_EVENTS];
@@ -80,7 +75,7 @@ VALUE method_scheduler_wait(VALUE self) {
     return result;
 }
 
-VALUE method_scheduler_backend(VALUE klass) {
+VALUE method_scheduler_kqueue_backend(VALUE klass) {
     return rb_str_new_cstr("kqueue");
 }
 #endif

data/ext/evt/select.h

@@ -2,19 +2,7 @@
 #define SELECT_H
 #include "evt.h"
 
-VALUE method_scheduler_init(VALUE self) {
-    return Qnil;
-}
-
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
-    return Qnil;
-}
-
-VALUE method_scheduler_deregister(VALUE self, VALUE io) {
-    return Qnil;
-}
-
-VALUE method_scheduler_wait(VALUE self) {
+VALUE method_scheduler_select_wait(VALUE self) {
     // return IO.select(@readable.keys, @writable.keys, [], next_timeout)
     VALUE readable, writable, readable_keys, writable_keys, next_timeout;
     ID id_select = rb_intern("select");
@@ -30,7 +18,7 @@ VALUE method_scheduler_wait(VALUE self) {
     return rb_funcall(rb_cIO, id_select, 4, readable_keys, writable_keys, rb_ary_new(), next_timeout);
 }
 
-VALUE method_scheduler_backend(VALUE klass) {
+VALUE method_scheduler_select_backend(VALUE klass) {
     return rb_str_new_cstr("ruby");
 }
 #endif

data/ext/evt/uring.h

@@ -12,7 +12,7 @@ size_t uring_payload_size(const void* data) {
     return sizeof(struct io_uring);
 }
 
-VALUE method_scheduler_init(VALUE self) {
+VALUE method_scheduler_uring_init(VALUE self) {
     int ret;
     struct io_uring* ring;
     ring = xmalloc(sizeof(struct io_uring));
@@ -24,7 +24,7 @@ VALUE method_scheduler_init(VALUE self) {
     return Qnil;
 }
 
-VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
+VALUE method_scheduler_uring_register(VALUE self, VALUE io, VALUE interest) {
     VALUE ring_obj;
     struct io_uring* ring;
     struct io_uring_sqe *sqe;
@@ -60,12 +60,7 @@ VALUE method_scheduler_register(VALUE self, VALUE io, VALUE interest) {
     return Qnil;
 }
 
-VALUE method_scheduler_deregister(VALUE self, VALUE io) {
-    // io_uring runs under oneshot mode. No need to deregister.
-    return Qnil;
-}
-
-VALUE method_scheduler_wait(VALUE self) {
+VALUE method_scheduler_uring_wait(VALUE self) {
     struct io_uring* ring;
     struct io_uring_cqe *cqes[URING_MAX_EVENTS];
     struct uring_data *data;
@@ -122,7 +117,7 @@ VALUE method_scheduler_wait(VALUE self) {
     return result;
 }
 
-VALUE method_scheduler_io_read(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length) {
+VALUE method_scheduler_uring_io_read(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length) {
     struct io_uring* ring;
     struct uring_data *data;
     char* read_buffer;
@@ -160,7 +155,7 @@ VALUE method_scheduler_io_read(VALUE self, VALUE io, VALUE buffer, VALUE offset,
     return result;
 }
 
-VALUE method_scheduler_io_write(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length) {
+VALUE method_scheduler_uring_io_write(VALUE self, VALUE io, VALUE buffer, VALUE offset, VALUE length) {
     struct io_uring* ring;
     struct uring_data *data;
     char* write_buffer;
@@ -192,7 +187,7 @@ VALUE method_scheduler_io_write(VALUE self, VALUE io, VALUE buffer, VALUE offset
     return length;
 }
 
-VALUE method_scheduler_backend(VALUE klass) {
+VALUE method_scheduler_uring_backend(VALUE klass) {
     return rb_str_new_cstr("liburing");
 }
 

data/lib/evt.rb

@@ -1,6 +1,15 @@
 # frozen_string_literal: true
 
+require 'fiber'
+require 'socket'
+require 'io/nonblock'
 require_relative 'evt/version'
+require_relative 'evt/backends/bundled'
+require_relative 'evt/backends/epoll'
+require_relative 'evt/backends/iocp'
+require_relative 'evt/backends/kqueue'
+require_relative 'evt/backends/select'
+require_relative 'evt/backends/uring'
 require_relative 'evt/scheduler'
 require_relative 'evt_ext'
 

data/lib/evt/backends/bundled.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+class Evt::Bundled
+  MAXIMUM_TIMEOUT = 5
+
+  def initialize
+    @readable = {}
+    @writable = {}
+    @waiting = {}
+    @iovs = {}
+    
+    @lock = Mutex.new
+    @blocking = 0
+    @ready = []
+  
+    init_selector
+  end
+
+  attr_reader :readable
+  attr_reader :writable
+  attr_reader :waiting
+
+  def next_timeout
+    _fiber, timeout = @waiting.min_by{|key, value| value}
+
+    if timeout
+      offset = timeout - current_time
+      return 0 if offset < 0
+      return offset if offset < MAXIMUM_TIMEOUT
+    end
+
+    MAXIMUM_TIMEOUT
+  end
+
+  def run
+    while @readable.any? or @writable.any? or @waiting.any? or @iovs.any? or @blocking.positive?
+      readable, writable, iovs = self.wait
+
+      readable&.each do |io|
+        fiber = @readable.delete(io)
+        fiber&.resume
+      end
+
+      writable&.each do |io|
+        fiber = @writable.delete(io)
+        fiber&.resume
+      end
+
+      unless iovs.nil?
+        iovs&.each do |io|
+          fiber = @iovs.delete(io)
+          fiber&.resume
+        end
+      end
+
+      if @waiting.any?
+        time = current_time
+        waiting, @waiting = @waiting, {}
+
+        waiting.each do |fiber, timeout|
+          if timeout <= time
+            fiber.resume
+          else
+            @waiting[fiber] = timeout
+          end
+        end
+      end
+
+      if @ready.any?
+        ready = nil
+
+        @lock.synchronize do
+          ready, @ready = @ready, []
+        end
+
+        ready.each do |fiber|
+          fiber.resume
+        end
+      end
+    end
+  end
+
+  def current_time
+    Process.clock_gettime(Process::CLOCK_MONOTONIC)
+  end
+
+  # Wait for the given file descriptor to match the specified events within
+  # the specified timeout.
+  # @parameter event [Integer] A bit mask of `IO::READABLE`,
+  #   `IO::WRITABLE` and `IO::PRIORITY`.
+  # @parameter timeout [Numeric] The amount of time to wait for the event in seconds.
+  # @returns [Integer] The subset of events that are ready.
+  def io_wait(io, events, duration)
+    # TODO: IO::PRIORITY
+    @readable[io] = Fiber.current unless (events & IO::READABLE).zero?
+    @writable[io] = Fiber.current unless (events & IO::WRITABLE).zero?
+    self.register(io, events)
+    Fiber.yield
+    self.deregister(io)
+    true
+  end
+
+  # Sleep the current task for the specified duration, or forever if not
+  # specified.
+  # @param duration [Numeric] The amount of time to sleep in seconds.
+  def kernel_sleep(duration = nil)
+    self.block(:sleep, duration)
+    true
+  end
+
+  # Block the calling fiber.
+  # @parameter blocker [Object] What we are waiting on, informational only.
+  # @parameter timeout [Numeric | Nil] The amount of time to wait for in seconds.
+  # @returns [Boolean] Whether the blocking operation was successful or not.
+  def block(blocker, timeout = nil)
+    if timeout
+      @waiting[Fiber.current] = current_time + timeout
+      begin
+        Fiber.yield
+      ensure
+        @waiting.delete(Fiber.current)
+      end
+    else
+      @blocking += 1
+      begin
+        Fiber.yield
+      ensure
+        @blocking -= 1
+      end
+    end
+  end
+
+  # Unblock the specified fiber.
+  # @parameter blocker [Object] What we are waiting on, informational only.
+  # @parameter fiber [Fiber] The fiber to unblock.
+  # @reentrant Thread safe.
+  def unblock(blocker, fiber)
+    @lock.synchronize do
+      @ready << fiber
+    end
+  end
+
+  # Invoked when the thread exits.
+  def close
+    self.run
+  end
+
+  # Intercept the creation of a non-blocking fiber.
+  # @returns [Fiber]
+  def fiber(&block)
+    fiber = Fiber.new(blocking: false, &block)
+    fiber.resume
+    fiber
+  end
+end

data/lib/evt/backends/epoll.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class Evt::Epoll < Evt::Bundled
+  def self.available?
+    self.respond_to?(:epoll_backend)
+  end
+
+  def self.backend
+    self.epoll_backend
+  end
+
+  def init_selector
+    epoll_init_selector
+  end
+
+  def register(io, interest)
+    epoll_register(io, interest)
+  end
+
+  def deregister(io)
+    epoll_deregister(io)
+  end
+
+  def wait
+    epoll_wait
+  end
+end

data/lib/evt/backends/iocp.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+class Evt::Iocp < Evt::Bundled
+  ##
+  # IOCP is totally disabled for now
+  def self.available?
+    false
+  end
+
+  def init_selector
+    # Placeholder
+  end
+
+  def register(io, interest)
+    # Placeholder
+  end
+
+  def deregister(io)
+    # Placeholder
+  end
+
+  def io_read(io, buffer, offset, length)
+    # Placeholder
+  end
+
+  def io_write(io, buffer, offset, length)
+    # Placeholder
+  end
+
+  def wait
+    # Placeholder
+  end
+end

data/lib/evt/backends/kqueue.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class Evt::Kqueue < Evt::Bundled
+  def self.available?
+    self.respond_to?(:kqueue_backend)
+  end
+
+  def self.backend
+    self.kqueue_backend
+  end
+
+  def init_selector
+    kqueue_init_selector
+  end
+
+  def register(io, interest)
+    kqueue_register(io, interest)
+  end
+
+  def deregister(io)
+    # Kqueue running under one-shot mode, no need to deregister
+  end
+
+  def wait
+    kqueue_wait
+  end
+end

data/lib/evt/backends/select.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class Evt::Select < Evt::Bundled
+  def self.available?
+    self.respond_to?(:select_backend)
+  end
+
+  def self.backend
+    self.select_backend
+  end
+
+  def init_selector
+    # Select is stateless
+  end
+
+  def register(io, interest)
+    # Select is stateless
+  end
+
+  def deregister(io)
+    # Select is stateless
+  end
+
+  def wait
+    select_wait
+  end
+end

data/lib/evt/backends/uring.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+class Evt::Uring < Evt::Bundled
+  def self.available?
+    self.respond_to?(:uring_backend)
+  end
+
+  def self.backend
+    self.uring_backend
+  end
+
+  def init_selector
+    uring_init_selector
+  end
+
+  def register(io, interest)
+    uring_register(io, register)
+  end
+
+  def deregister(io)
+    # io_uring running under one-shot mode, no need to deregister
+  end
+
+  def io_read(io, buffer, offset, length)
+    uring_io_read(io, buffer, offset, length)
+  end
+
+  def io_write(io, buffer, offset, length)
+    uring_io_write(io, buffer, offset, length)
+  end
+
+  def wait
+    uring_wait
+  end
+end

data/lib/evt/scheduler.rb

@@ -1,121 +1,36 @@
 # frozen_string_literal: true
 
-require 'fiber'
-require 'socket'
-require 'io/nonblock'
-
+##
+# The major class for Ruby Fiber Scheduler
+# @example
+#   scheduler = Evt::Scheduler.new
+#   Fiber.set_scheduler scheduler
+#   scheduler.run
 class Evt::Scheduler
-  def initialize
-    @readable = {}
-    @writable = {}
-    @iovs = {}
-    @waiting = {}
-    
-    @lock = Mutex.new
-    @locking = 0
-    @ready = []
-
-    @ios = ObjectSpace::WeakMap.new
-    init_selector
-  end
-
-  attr_reader :readable
-  attr_reader :writable
-  attr_reader :waiting
-
-  def next_timeout
-    _fiber, timeout = @waiting.min_by{|key, value| value}
-
-    if timeout
-      offset = timeout - current_time
-      offset < 0 ? 0 : offset
-    end
-  end
-
-  def run
-    while @readable.any? or @writable.any? or @waiting.any? or @iovs.any? or @locking.positive?
-      readable, writable, iovs = self.wait
-
-      readable&.each do |io|
-        fiber = @readable.delete(io)
-        fiber&.resume
-      end
-
-      writable&.each do |io|
-        fiber = @writable.delete(io)
-        fiber&.resume
-      end
-
-      unless iovs.nil?
-        iovs&.each do |io|
-          fiber = @iovs.delete(io)
-          fiber&.resume
-        end
-      end
-
-      if @waiting.any?
-        time = current_time
-        waiting = @waiting
-        @waiting = {}
-
-        waiting.each do |fiber, timeout|
-          if timeout <= time
-            fiber.resume
-          else
-            @waiting[fiber] = timeout
-          end
-        end
-      end
-
-      if @ready.any?
-        ready = nil
-
-        @lock.synchronize do
-          ready, @ready = @ready, []
-        end
-
-        ready.each do |fiber|
-          fiber.resume
-        end
+  class << self
+    BACKENDS = [
+      Evt::Uring,
+      Evt::Epoll,
+      Evt::Kqueue,
+      Evt::Iocp,
+      Evt::Select,
+    ].freeze
+
+    ##
+    # Returns the fastest possible scheduler
+    # Use the backend scheduler directly if you want to choose it yourself
+    def new
+      BACKENDS.each do |backend|
+        return backend.new if backend.available?
       end
     end
-  end
-
-  def current_time
-    Process.clock_gettime(Process::CLOCK_MONOTONIC)
-  end
-
-  def io_wait(io, events, duration)
-    @readable[io] = Fiber.current unless (events & IO::READABLE).zero?
-    @writable[io] = Fiber.current unless (events & IO::WRITABLE).zero?
-    self.register(io, events)
-    Fiber.yield
-    self.deregister(io)
-    true
-  end
-
-  def kernel_sleep(duration = nil)
-    @waiting[Fiber.current] = current_time + duration if duration.nil?
-    Fiber.yield
-    true
-  end
-
-  def mutex_lock(mutex)
-    @locking += 1
-    Fiber.yield
-  ensure
-    @locking -= 1
-  end
 
-  def mutex_unlock(mutex, fiber)
-    @lock.synchronize do
-      @ready << fiber
+    ##
+    # Returns all available backends on this machine
+    def availables
+      BACKENDS.filter do |backend|
+        backend.available?
+      end
     end
   end
-
-  def fiber(&block)
-    fiber = Fiber.new(blocking: false, &block)
-    fiber.resume
-    fiber
-  end
 end

data/lib/evt/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Evt
-  VERSION = "0.2.3"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: evt
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.0
 platform: ruby
 authors:
 - Delton Ding
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.0
 description: A low-level Event Handler designed for Ruby 3 Scheduler for better performance
 email:
 - dsh0416@gmail.com
@@ -32,6 +46,7 @@ extensions:
 - ext/evt/extconf.rb
 extra_rdoc_files: []
 files:
+- ".github/workflows/build.yml"
 - ".github/workflows/test.yml"
 - ".gitignore"
 - CODE_OF_CONDUCT.md
@@ -49,6 +64,12 @@ files:
 - ext/evt/select.h
 - ext/evt/uring.h
 - lib/evt.rb
+- lib/evt/backends/bundled.rb
+- lib/evt/backends/epoll.rb
+- lib/evt/backends/iocp.rb
+- lib/evt/backends/kqueue.rb
+- lib/evt/backends/select.rb
+- lib/evt/backends/uring.rb
 - lib/evt/scheduler.rb
 - lib/evt/version.rb
 homepage: https://github.com/dsh0416/evt