raptor 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c247b4c221d0f19ff1383ca0a4092a54bc12cd2f945655fa24e1ab49745eb70
-  data.tar.gz: cb932a7a048d87eb0913f8c0dbe52750ea4e525e4c4dc32e5fcc531af0daaf41
+  metadata.gz: a9d82dc0869e270278088d312d03a6ed914e494da5fb6b7bf6e41c03257ddf41
+  data.tar.gz: c113ab336b5ad9e5e72095e79af4702b5adb0efb46117ba43b6879fe2e4a728c
 SHA512:
-  metadata.gz: d8e1543054862e8a87c7261884348456da13d4432c3424687b74f506b884283d2773068b6beb10cbe9e209e969b98a918720861b3d0e05bc04d930ba38ec1921
-  data.tar.gz: f215cc4a92af86542d49f2c4772f0a65af09988779bbb1c44512ab075d4fb5c0758cb51d9765a0ee9d08fe340d31b42cea1610b021c443818fe40fbdcea63b93
+  metadata.gz: 365e09dbfcc7cbb265b8ac6569a66e66a0629ecfb4fd176164cb4c55b6f0223ef05f3e17f3318f7ec6cd58be94396996885b232c496e46620f42049ca9a1fe84
+  data.tar.gz: d6d2b9b18cd0da790c2f13fce8994f799bac41e94270f9c69f4b57241f6931d98a8ef81573e8257d1766dfde0a63807d2f06cf57fa4a44ef8f754533b733aeff

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-29
+
+- Load `raptor.rb` or `config/raptor.rb` by default when no config path is supplied
+- Honour the peer's HTTP/2 flow-control windows when sending `DATA` frames
+- Assemble HEADERS across `CONTINUATION` frames
+- Validate HTTP/2 stream IDs and emit `GOAWAY` on protocol errors
+- Offload TLS handshakes to the thread pool to keep the server thread responsive
+- Exit eager keep-alive loops on cluster shutdown
+- Apply the write timeout to HTTP/2 frame writes
+- Reject HPACK dynamic table size updates larger than 4096 bytes
+- Reject malformed HTTP/1.1 requests with a 400 response
+- Rescue unexpected errors in the reactor and pipeline collector
+
 ## [0.3.0] - 2026-05-25
 
 - Load cluster options from a Ruby config file via `--config`

data/README.md

@@ -1,6 +1,6 @@
 # Raptor
 
-Raptor is a high-performance, preloading, multi-process, multi-threaded Ruby 4+ web server implementing Rack 3+,
+Raptor is a high-performance, preloading, multi-process, multi-threaded Ruby 4+ web server implementing Rack 3.2+,
 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.
 
@@ -31,9 +31,9 @@ run proc { |_env| [200, { "content-type" => "text/plain" }, ["Hello, World!"]] }
 ```
 > bundle exec raptor -t 3 -w 4 hello_world.ru
 Raptor Cluster initializing:
-├─ Version: 0.3.0
-├─ Ruby Version: ruby 4.0.4 (2026-05-12 revision b89eb1bcbf) +YJIT +PRISM [arm64-darwin23]
-├─ Master PID: 31504
+├─ Version: 0.4.0
+├─ Ruby Version: ruby 4.0.5 (2026-05-20 revision 64336ffd0e) +YJIT +PRISM [arm64-darwin23]
+├─ Master PID: 26456
 │  └─ 4 worker processes
 │     ├─ 1 server thread
 │     ├─ 1 reactor thread
@@ -42,10 +42,10 @@ Raptor Cluster initializing:
 │     ├─ 3 worker threads
 │     └─ 1 stats thread
 └─ Listening on 0.0.0.0:9292
-[31506] Worker 0 booted
-[31507] Worker 1 booted
-[31508] Worker 2 booted
-[31509] Worker 3 booted
+[26459] Worker 0 booted
+[26460] Worker 1 booted
+[26461] Worker 2 booted
+[26462] Worker 3 booted
 ```
 
 ```
@@ -62,15 +62,15 @@ Also works with `rackup` and `rails server`:
 
 ## (Micro) Benchmarks
 
-Raptor 0.3.0 vs Puma 8.0.1:
+Raptor 0.4.0 vs Puma 8.0.1:
 
 | Protocol              | Raptor       | Puma         |
 | --------------------- | ------------ | ------------ |
-| HTTP/1.1              | 20.3k req/s  | 20.8k req/s  |
-| HTTP/1.1 (keep-alive) | 60.9k req/s  | 45.4k req/s  |
-| HTTP/2                | 22.9k req/s  | N/A          |
+| HTTP/1.1              | ~20k req/s   | ~21k req/s   |
+| HTTP/1.1 (keep-alive) | ~60k req/s   | ~45k req/s   |
+| HTTP/2                | ~23k req/s   | N/A          |
 
-> Ruby 4.0.4 +YJIT, macOS Apple Silicon. 4 workers, 3 threads, 12 concurrent connections.
+> Ruby 4.0.5 +YJIT, macOS Apple Silicon. 4 workers, 3 threads, 12 concurrent connections.
 
 ## Development
 

data/ext/raptor_http2/raptor_http2.c

@@ -457,6 +457,7 @@ static int hpack_decode_header_block(const uint8_t *buf, size_t len,
       /* dynamic table size update (RFC 7541 6.3) */
       uint64_t new_size;
       if (hpack_decode_int(buf, len, &pos, 5, &new_size) < 0) return -1;
+      if (new_size > HTTP2_DEFAULT_HEADER_TABLE_SIZE) return -1;
       *max_table_size = (long)new_size;
       *dyn_table = dynamic_table_evict(*dyn_table, *max_table_size);
 

data/lib/rackup/handler/raptor.rb

@@ -69,7 +69,8 @@ module Rackup
         end
 
         cli_defaults = ::Raptor::CLI::DEFAULT_OPTIONS
-        config = options[:Config] ? ::Raptor::CLI.load_config_file(options[:Config]) : {}
+        config_path = options[:Config] || ::Raptor::CLI.default_config_path
+        config = config_path ? ::Raptor::CLI.load_config_file(config_path) : {}
 
         binds = if options[:Host] || options[:Port]
           host = options[:Host] || defaults[:Host]
@@ -88,7 +89,7 @@ module Rackup
           client: cli_defaults[:client].merge(config[:client] || {})
         }
 
-        [:rackup, :on_error, :stats_file, :pidfile].each do |key|
+        [:rackup, :on_error, :stats_file, :pid_file].each do |key|
           result[key] = config[key] if config.key?(key)
         end
 

data/lib/raptor/cli.rb

@@ -40,9 +40,11 @@ module Raptor
         body_spool_threshold: 1024 * 1024,
       },
       stats_file: "tmp/raptor.json",
-      pidfile: nil,
+      pid_file: nil,
     }.freeze
 
+    DEFAULT_CONFIG_PATHS = ["raptor.rb", "config/raptor.rb"].freeze
+
     # Loads a configuration file and returns the hash it evaluates to.
     #
     # The file is evaluated at the top level so constants like `Raptor::*` resolve
@@ -61,6 +63,20 @@ module Raptor
       config
     end
 
+    # Returns the first existing path in {DEFAULT_CONFIG_PATHS} resolved
+    # against `root`, or nil if none exist.
+    #
+    # Used to pick up a project-local config file when no `-c`/`--config`
+    # flag was supplied.
+    #
+    # @param root [String] directory to resolve the default paths against
+    # @return [String, nil] the config path, or nil if no default file exists
+    #
+    # @rbs (?String root) -> String?
+    def self.default_config_path(root = Dir.pwd)
+      DEFAULT_CONFIG_PATHS.find { |path| File.exist?(File.join(root, path)) }
+    end
+
     # @rbs @command: Symbol
     # @rbs @options: Hash[Symbol, untyped]
     # @rbs @parser: OptionParser
@@ -92,7 +108,7 @@ module Raptor
       @options = DEFAULT_OPTIONS.dup
       @options[:client] = @options[:client].dup
 
-      apply_config_file(extract_config_path(argv))
+      apply_config_file(extract_config_path(argv) || self.class.default_config_path)
 
       @parser = create_parser
       @parser.parse!(argv)
@@ -235,8 +251,8 @@ module Raptor
           @options[:stats_file] = path
         end
 
-        opts.on("--pidfile PATH", String, "Pidfile path (default: none)") do |path|
-          @options[:pidfile] = path
+        opts.on("--pid-file PATH", String, "PID file path (default: none)") do |path|
+          @options[:pid_file] = path
         end
 
         opts.on("--help", "Show this help") do

data/lib/raptor/cluster.rb

@@ -60,7 +60,7 @@ module Raptor
     # @rbs @client_options: Hash[Symbol, Integer]
     # @rbs @on_error: ^(Hash[String, untyped]?, Exception) -> void | nil
     # @rbs @stats_file: String?
-    # @rbs @pidfile: String?
+    # @rbs @pid_file: String?
     # @rbs @binder: Binder
     # @rbs @server_port: Integer
     # @rbs @app: untyped
@@ -86,7 +86,7 @@ module Raptor
     # @option options [Hash] :client client configuration
     # @option options [#call] :on_error callback invoked with (env, exception) when the Rack app raises
     # @option options [String, nil] :stats_file path to write per-worker stats JSON, or nil to disable
-    # @option options [String, nil] :pidfile path to write the master PID to, or nil to disable
+    # @option options [String, nil] :pid_file path to write the master PID to, or nil to disable
     # @return [void]
     #
     # @rbs (Hash[Symbol, untyped] options) -> void
@@ -97,7 +97,7 @@ module Raptor
       @client_options = options[:client]
       @on_error = options[:on_error]
       @stats_file = options[:stats_file]
-      @pidfile = options[:pidfile]
+      @pid_file = options[:pid_file]
 
       @binder = Binder.new(options[:binds])
       @server_port = @binder.server_port
@@ -135,7 +135,7 @@ module Raptor
       trap("USR1") { log_stats }
       trap("USR2") { @phased_restart_requested = true }
 
-      File.open(@pidfile, File::CREAT | File::EXCL | File::WRONLY) { |file| file.write(Process.pid.to_s) } if @pidfile
+      File.open(@pid_file, File::CREAT | File::EXCL | File::WRONLY) { |file| file.write(Process.pid.to_s) } if @pid_file
 
       @worker_count.times { |index| spawn_worker(index) }
 
@@ -159,7 +159,7 @@ module Raptor
       @workers.values.each { |pid| Process.wait(pid) rescue nil }
       stats_file_thread&.join
       File.delete(@stats_file) rescue nil if @stats_file
-      File.delete(@pidfile) rescue nil if @pidfile
+      File.delete(@pid_file) rescue nil if @pid_file
       @stats.unmap
     end
 
@@ -288,17 +288,22 @@ module Raptor
         size: @ractor_count,
         worker: request.http_parser_worker
       ) do |parsed_result|
-        if parsed_result[:protocol] == :http2
-          http2.handle_parsed_request(parsed_result, reactor, thread_pool)
-        else
-          request.handle_parsed_request(parsed_result, reactor, thread_pool)
+        begin
+          if parsed_result[:protocol] == :http2
+            http2.handle_parsed_request(parsed_result, reactor, thread_pool)
+          else
+            request.handle_parsed_request(parsed_result, reactor, thread_pool)
+          end
+        rescue => error
+          warn "#{Thread.current.name} rescued:"
+          warn error.full_message
         end
       end
 
       reactor = Reactor.new(thread_pool, ractor_pool, client_options: @client_options)
       reactor_thread = reactor.run
 
-      server = Server.new(@binder, reactor, thread_pool, request)
+      server = Server.new(@binder, reactor, thread_pool, request, client_options: @client_options)
       server_thread = server.run
 
       puts "[#{Process.pid}] Worker #{index} booted"
@@ -333,6 +338,7 @@ module Raptor
       reactor.shutdown
       reactor_thread.join
       ractor_pool.shutdown
+      request.shutdown
       thread_pool.shutdown
       stats_thread.join
     end