raptor 0.25.0 → 0.27.0

data/sig/generated/raptor/embedded.rbs

@@ -0,0 +1,93 @@
+# Generated from lib/raptor/embedded.rb with RBS::Inline
+
+module Raptor
+  # Serves an existing Rack application in the caller's process without
+  # installing signal handlers or changing process-wide configuration.
+  class Embedded
+    @worker: Worker?
+
+    @binder: Binder?
+
+    @stopped: bool
+
+    @started: bool
+
+    @lifecycle_available: AtomicConditionVariable
+
+    @lifecycle_owner: Atom
+
+    @log: bool
+
+    @binds: Array[String]
+
+    @options: Hash[Symbol, untyped]
+
+    @app: untyped
+
+    attr_reader port: Integer
+
+    attr_reader addresses: Array[String]
+
+    # Creates an in-process server. A port of zero selects an available port.
+    # Thread and protocol options follow the regular server configuration.
+    # Set log to report startup information.
+    #
+    # @rbs (untyped app, ?host: String, ?port: Integer, ?log: bool, **untyped options) -> void
+    def initialize: (untyped app, ?host: String, ?port: Integer, ?log: bool, **untyped options) -> void
+
+    # Starts serving and returns once the request-handling stack is ready.
+    # Startup errors are raised in the calling thread.
+    #
+    # @rbs () -> Embedded
+    def start: () -> Embedded
+
+    # Starts serving and waits until shutdown.
+    #
+    # @rbs () -> void
+    def run: () -> void
+
+    # Drains serving work while retaining the bound listeners for resume.
+    # Connections may queue, but requests are not served while paused.
+    # Existing keep-alive connections close. Repeated pauses have no effect.
+    #
+    # Pause before master forks and resume in the parent. Close the inherited
+    # instance before other worker boot hooks, and shut down when the plugin stops.
+    #
+    # @example From a plugin's start callback
+    #   @server = Raptor::Embedded.new(app, port: 9293).start
+    #   cluster.options[:before_fork] << proc { @server.pause }
+    #   cluster.options[:after_fork] << proc { @server.resume }
+    #   cluster.options[:before_worker_boot].unshift(proc { @server.shutdown })
+    #
+    # @rbs () -> Embedded
+    def pause: () -> Embedded
+
+    # Resumes serving on the retained listeners. Has no effect while running.
+    # Shutdown remains terminal. Startup failures release the listeners and propagate.
+    #
+    # @rbs () -> Embedded
+    def resume: () -> Embedded
+
+    # Drains requests and closes the server's sockets, threads, and Ractors.
+    # Calling shutdown more than once has no effect.
+    #
+    # @rbs () -> void
+    def shutdown: () -> void
+
+    # Waits across pauses until termination and propagates serving failures.
+    #
+    # @rbs () -> void
+    def join: () -> void
+
+    private
+
+    # @rbs () -> void
+    def start_worker: () -> void
+
+    # @rbs () -> void
+    def log_initialization: () -> void
+
+    # @rbs () { () -> untyped } -> untyped
+    def with_lifecycle: () { () -> untyped } -> untyped
+  end
+end

data/sig/generated/raptor/plugin.rbs

@@ -28,6 +28,7 @@ module Raptor
 
     # Starts in the master before workers fork. Override to open resources
     # and append callbacks to the cluster's lifecycle hook arrays.
+    # See {Cluster#initialize} for hooks and {Embedded#pause} for fork-safe Rack listeners.
     #
     # @rbs (Cluster cluster) -> void
     def start: (Cluster cluster) -> void

data/sig/generated/raptor/worker.rbs

@@ -0,0 +1,77 @@
+# Generated from lib/raptor/worker.rb with RBS::Inline
+
+module Raptor
+  # Runs the request-handling stack shared by forked and embedded servers.
+  class Worker
+    @server_thread: Thread?
+
+    @server: Server?
+
+    @reactor_thread: Thread?
+
+    @http2_ractor_pool: RactorPool?
+
+    @http1_ractor_pool: RactorPool?
+
+    @http2: Http2?
+
+    @http1: Http1?
+
+    @stopped: bool
+
+    @worker_index: Integer?
+
+    @access_log_io: IO?
+
+    @http2_ractors: Integer
+
+    @http1_ractors: Integer
+
+    @options: Hash[Symbol, untyped]
+
+    @port: Integer
+
+    @listeners: Array[TCPServer | UNIXServer | Binder::SslListener | Binder::H2cListener]
+
+    @app: untyped
+
+    attr_reader requests: Integer
+
+    attr_reader reactor: Reactor?
+
+    attr_reader thread_pool: AtomicThreadPool?
+
+    # Creates a serving stack using the supplied listeners and configuration.
+    #
+    # @rbs (untyped app, listeners: Array[TCPServer | UNIXServer | Binder::SslListener | Binder::H2cListener], port: Integer, options: Hash[Symbol, untyped], http1_ractors: Integer, http2_ractors: Integer, ?access_log_io: IO?, ?worker_index: Integer?) -> void
+    def initialize: (untyped app, listeners: Array[TCPServer | UNIXServer | Binder::SslListener | Binder::H2cListener], port: Integer, options: Hash[Symbol, untyped], http1_ractors: Integer, http2_ractors: Integer, ?access_log_io: IO?, ?worker_index: Integer?) -> void
+
+    # Starts the application pool, protocol parsers, reactor, and acceptor.
+    #
+    # @rbs () -> void
+    def start: () -> void
+
+    # Returns whether both serving threads are still running.
+    #
+    # @rbs () -> bool
+    def running?: () -> bool
+
+    # Waits until serving stops, propagating background thread failures.
+    #
+    # @rbs () -> void
+    def join: () -> void
+
+    # Drains requests and releases the serving threads and parser Ractors.
+    # A seed keeps its listeners open for the cluster to manage.
+    #
+    # @rbs (?close_listeners: bool) -> void
+    def shutdown: (?close_listeners: bool) -> void
+
+    private
+
+    # Waits for app work to finish within the configured drain timeout.
+    #
+    # @rbs () -> void
+    def drain_thread_pool: () -> void
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: raptor
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Joshua Young
@@ -134,6 +134,7 @@ files:
 - ".buildkite/pipeline.yml"
 - ".dockerignore"
 - ".mise.toml"
+- AGENTS.md
 - Brewfile
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -161,6 +162,7 @@ files:
 - lib/raptor/cluster.rb
 - lib/raptor/control_server.rb
 - lib/raptor/detached_body.rb
+- lib/raptor/embedded.rb
 - lib/raptor/http.rb
 - lib/raptor/http1.rb
 - lib/raptor/http2.rb
@@ -173,6 +175,7 @@ files:
 - lib/raptor/systemd.rb
 - lib/raptor/thread_locals.rb
 - lib/raptor/version.rb
+- lib/raptor/worker.rb
 - sig/generated/rackup/handler/raptor.rbs
 - sig/generated/raptor.rbs
 - sig/generated/raptor/binder.rbs
@@ -180,6 +183,7 @@ files:
 - sig/generated/raptor/cluster.rbs
 - sig/generated/raptor/control_server.rbs
 - sig/generated/raptor/detached_body.rbs
+- sig/generated/raptor/embedded.rbs
 - sig/generated/raptor/http.rbs
 - sig/generated/raptor/http1.rbs
 - sig/generated/raptor/http2.rbs
@@ -192,6 +196,7 @@ files:
 - sig/generated/raptor/systemd.rbs
 - sig/generated/raptor/thread_locals.rbs
 - sig/generated/raptor/version.rbs
+- sig/generated/raptor/worker.rbs
 homepage: https://github.com/joshuay03/raptor
 licenses:
 - MIT