raptor 0.23.0 → 0.25.0

data/sig/generated/raptor/plugin.rbs

@@ -0,0 +1,52 @@
+# Generated from lib/raptor/plugin.rb with RBS::Inline
+
+module Raptor
+  # An extension, loaded from `raptor/plugin/<name>` or
+  # registered explicitly by application code.
+  class Plugin
+    class UnknownPlugin < LoadError
+    end
+
+    self.@registry: Hash[String, singleton(Plugin)]
+
+    # Registers a plugin class under a name.
+    #
+    # @rbs (String | Symbol name, singleton(Plugin) plugin) -> void
+    def self.register: (String | Symbol name, singleton(Plugin) plugin) -> void
+
+    # Defines and registers a plugin without a named subclass.
+    #
+    # @rbs (String | Symbol name) { () -> void } -> singleton(Plugin)
+    def self.create: (String | Symbol name) { () -> void } -> singleton(Plugin)
+
+    # Loads a registered plugin, requiring its conventional path if needed.
+    #
+    # @rbs (String | Symbol name) -> Plugin
+    def self.load: (String | Symbol name) -> Plugin
+
+    @threads: Array[Thread]?
+
+    # Starts in the master before workers fork. Override to open resources
+    # and append callbacks to the cluster's lifecycle hook arrays.
+    #
+    # @rbs (Cluster cluster) -> void
+    def start: (Cluster cluster) -> void
+
+    # Stops in the master after workers exit, including before hot restart.
+    # Also called if startup fails, so resources may be only partly opened.
+    #
+    # @rbs () -> void
+    def stop: () -> void
+
+    # Runs a block on a master-owned thread. Raptor stops and joins these
+    # threads after calling `stop`; use `ensure` in the block for cleanup.
+    #
+    # @rbs () { () -> void } -> Thread
+    def in_background: () { () -> void } -> Thread
+
+    # Calls the plugin's stop callback and joins its background threads.
+    #
+    # @rbs () -> void
+    def shutdown: () -> void
+  end
+end

data/sig/generated/raptor/reactor.rbs

@@ -56,8 +56,6 @@ module Raptor
 
       attr_accessor closing: bool
 
-      attr_accessor monitor: NIO::Monitor?
-
       attr_accessor timeout: TimeoutClient?
 
       attr_reader output: Array[String]
@@ -131,13 +129,17 @@ module Raptor
       def empty?: () -> bool
     end
 
-    @io_applied: AtomicConditionVariable
-
     @io_queue: AtomicQueue
 
     @queue: Queue[TCPSocket]
 
-    @selector: NIO::Selector
+    @ready: Array[[ TCPSocket, Integer ]]
+
+    @waiters: Hash[TCPSocket, [ Fiber, Integer ]]
+
+    @wakeup: Fiber?
+
+    @selector: untyped
 
     @http2_keepalive_timeout: Integer
 
@@ -159,6 +161,8 @@ module Raptor
 
     @http1: Http1
 
+    @io_applied: AtomicConditionVariable
+
     @timeouts: RedBlackTree[TimeoutClient]
 
     @id_to_socket: Hash[Integer, TCPSocket]
@@ -422,6 +426,11 @@ module Raptor
 
     private
 
+    # Wakes the event loop, including work queued before it starts waiting.
+    #
+    # @rbs () -> void
+    def wakeup: () -> void
+
     # Returns whether shutdown has no registrations or writes left to drain.
     #
     # @return [Boolean]
@@ -603,7 +612,12 @@ module Raptor
     # @return [void]
     #
     # @rbs (Integer id, ConnectionIO io) -> void
-    def update_monitor: (Integer id, ConnectionIO io) -> void
+    def update_interests: (Integer id, ConnectionIO io) -> void
+
+    # Waits for a connection's next readable or writable event.
+    #
+    # @rbs (TCPSocket socket, Integer events) -> void
+    def wait_for_io: (TCPSocket socket, Integer events) -> void
 
     # Starts or refreshes one connection's non-blocking write deadline.
     #
@@ -625,13 +639,12 @@ module Raptor
     # Removes a socket from selector tracking.
     #
     # @param socket [TCPSocket] socket to deregister
-    # @param io [ConnectionIO, nil] connection I/O state
     # @return [void]
     #
-    # @rbs (TCPSocket socket, ConnectionIO? io) -> void
-    def deregister: (TCPSocket socket, ConnectionIO? io) -> void
+    # @rbs (TCPSocket socket) -> void
+    def deregister: (TCPSocket socket) -> void
 
-    # Registers a socket with the NIO selector and sets up timeout tracking.
+    # Registers a socket for readiness and sets up timeout tracking.
     #
     # @param socket [TCPSocket] the socket to register
     # @return [void]
@@ -661,20 +674,22 @@ module Raptor
     # Dispatches readable and writable events without allowing application
     # threads to take ownership of HTTP/2 sockets.
     #
-    # @param monitor [NIO::Monitor] ready selector monitor
+    # @param socket [TCPSocket] ready client socket
+    # @param events [Integer] readiness events
     # @return [void]
     #
-    # @rbs (NIO::Monitor monitor) -> void
-    def handle_monitor: (NIO::Monitor monitor) -> void
+    # @rbs (TCPSocket socket, Integer events) -> void
+    def handle_ready: (TCPSocket socket, Integer events) -> void
 
     # Handles readiness for an HTTP/1.x detached response.
     #
-    # @param monitor [NIO::Monitor] ready selector monitor
+    # @param socket [TCPSocket] ready client socket
+    # @param events [Integer] readiness events
     # @param id [Integer] unique connection identifier
     # @return [void]
     #
-    # @rbs (NIO::Monitor monitor, Integer id) -> void
-    def handle_http1_detached_monitor: (NIO::Monitor monitor, Integer id) -> void
+    # @rbs (TCPSocket socket, Integer events, Integer id) -> void
+    def handle_http1_detached_ready: (TCPSocket socket, Integer events, Integer id) -> void
 
     # Deregisters a readable socket and resumes its idle keep-alive
     # connection or queues its bytes for parsing.

data/sig/generated/raptor.rbs

@@ -4,6 +4,6 @@
 #
 # Raptor is a high-performance, preloading, multi-process, multi-threaded Ruby 4+ web server
 # implementing Rack 3+, leveraging Ractors for parallel HTTP/1.1 and HTTP/2 request processing,
-# native C extensions for HTTP parsing and HPACK compression, and NIO for non-blocking I/O.
+# native C extensions for HTTP parsing and HPACK compression, and io-event for non-blocking I/O.
 module Raptor
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: raptor
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Joshua Young
@@ -24,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.2.0
 - !ruby/object:Gem::Dependency
-  name: nio4r
+  name: io-event
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -141,6 +141,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/assets/profile_picture.png
+- docs/assets/startup_output.svg
 - docs/raptor-vs-puma.md
 - docs/talk.md
 - exe/raptor
@@ -163,6 +165,7 @@ files:
 - lib/raptor/http1.rb
 - lib/raptor/http2.rb
 - lib/raptor/log.rb
+- lib/raptor/plugin.rb
 - lib/raptor/reactor.rb
 - lib/raptor/reuseport_bpf.rb
 - lib/raptor/server.rb
@@ -181,6 +184,7 @@ files:
 - sig/generated/raptor/http1.rbs
 - sig/generated/raptor/http2.rbs
 - sig/generated/raptor/log.rbs
+- sig/generated/raptor/plugin.rbs
 - sig/generated/raptor/reactor.rbs
 - sig/generated/raptor/reuseport_bpf.rbs
 - sig/generated/raptor/server.rbs