quicsilver 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e879e4531621883da97721256a2b0db478ba995d8bf54c93ddf959fca9cd36d
-  data.tar.gz: 579023d40239d8c7a77671be44fb37265d735f864a13072887598406908c0aae
+  metadata.gz: eb40bd31dbb1c684ae68ec9b8a5f9fd0caee6972d360dc2be67984e473fdd15a
+  data.tar.gz: 2f46305042b7253d9fedc0018947404d6f27b045aef43be7a03ec32d3fe0bb8d
 SHA512:
-  metadata.gz: 25c070017404e15d673cfcb267ef90722dd255af0c68dd3488f1065ebe8fcc84614054b7ae3b5b0e2cd1bc74ca725a7ddd4e0500b80f849580ebef3306705443
-  data.tar.gz: 61f273afb32f2a45d07bc2f634a8f6d52973654b4e874ed01dd87a674126046f2e332741ca464b6f41a025e206064172a9614c602bb7285dab0b68b6efa7d09a
+  metadata.gz: 48810a1f5a78021b027cb416bca181388b23889456e61c4c05702bd228f15da52026c25b2eedf375473054133300c62efd88c486367ddb987490676c8575a302
+  data.tar.gz: 7ebe3bdb83efaf1854655f6553e324ee4c425c4b2d202e76cb2c2adce0bfd814e567003fb2b315cb6b373acf8cfed8fb7f08dffa3859e4e103e3480d4877d8c6

data/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        ruby-version: ["3.2"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@55283cc23133118229fd3f97f9336ee23a179fcf # v1.146.0
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+    - name: Build MSQUIC
+      run: bundle exec rake build_msquic
+    - name: Compile
+      run: bundle exec rake compile
+    - name: Run tests
+      run: bundle exec rake

data/.gitignore

@@ -8,5 +8,7 @@
 /tmp/
 /vendor/*
 /certs/*
+/certificates/*
 *.bundle
-lib/quicsilver/quicsilver.bundle
+lib/quicsilver/quicsilver.bundle
+*.gem

data/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2025-12-17
+
+### Added
+- Graceful shutdown with GOAWAY frames (RFC 9114 compliant)
+- Streaming response support for lazy/chunked bodies
+- Flow control settings for backpressure management
+- Client HTTP verb helpers: `get`, `post`, `patch`, `delete`, `head`
+- Integration test suite
+- Benchmarking examples for Rails
+
+### Fixed
+- Memory leak: send buffers now freed on SEND_COMPLETE callback
+- Segfault in event loop when client_obj was invalid
+- Content-Type header handling for Rack compatibility
+- String concatenation performance using StringIO
+
+### Changed
+- `server.start` now blocks until shutdown (no separate `wait_for_connections` needed)
+- Refactored to global event loop architecture
+- Simplified server internals with Connection and QuicStream classes
+- Replaced debug puts with proper logging
+
+### Limitations
+- No server push or trailer support
+- No dynamic QPACK table (static table only)
+- Client does not reuse connections
+
 ## [0.1.0] - 2025-10-28
 
 ### Added
@@ -15,8 +42,3 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - QPACK header compression (static table support)
 - Bidirectional request/response streams
 - Request body buffering for large payloads
-
-### Limitations
-This is still in prototype, it has the following known limitations:
-- No server push, GOAWAY, or trailer support
-- Limited error handling

data/Gemfile.lock

@@ -2,11 +2,20 @@ PATH
   remote: .
   specs:
     quicsilver (0.1.0)
+      localhost (~> 1.6)
+      rack (~> 3.0)
+      rackup (~> 2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    localhost (1.6.0)
     minitest (5.25.5)
+    minitest-focus (1.4.0)
+      minitest (>= 4, < 6)
+    rack (3.2.4)
+    rackup (2.2.1)
+      rack (>= 3)
     rake (10.5.0)
     rake-compiler (1.3.0)
       rake
@@ -19,6 +28,7 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 2.0)
   minitest (~> 5.0)
+  minitest-focus (~> 1.3)
   quicsilver!
   rake (~> 10.0)
   rake-compiler (~> 1.2)

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Haroon Ahmed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -2,7 +2,7 @@
 
 HTTP/3 server for Ruby with Rack support.
 
-Disclaimer: currenly in early prototype.
+**Status:** Experimental (v0.2.0)
 
 ## Installation
 
@@ -15,89 +15,68 @@ rake compile
 
 ## Quick Start
 
-### 1. Set up certificates
-
-```bash
-bash examples/setup_certs.sh
-```
-
-### 2. Run a Rack app over HTTP/3
+### Server
 
 ```ruby
 require "quicsilver"
 
-# Define your Rack app
 app = ->(env) {
-  path = env['PATH_INFO']
-
-  case path
+  case env['PATH_INFO']
   when '/'
-    [200, {'Content-Type' => 'text/plain'}, ["Hello HTTP/3!"]]
+    [200, {'content-type' => 'text/plain'}, ["Hello HTTP/3!"]]
   when '/api/users'
-    [200, {'Content-Type' => 'application/json'}, ['{"users": ["alice", "bob"]}']]
+    [200, {'content-type' => 'application/json'}, ['{"users": ["alice", "bob"]}']]
   else
-    [404, {'Content-Type' => 'text/plain'}, ["Not Found"]]
+    [404, {'content-type' => 'text/plain'}, ["Not Found"]]
   end
 }
 
-# Start HTTP/3 server with Rack app
 server = Quicsilver::Server.new(4433, app: app)
-server.start
-server.wait_for_connections
+server.start  # Blocks until shutdown
 ```
 
-### 3. Test with the client
-
-```bash
-ruby examples/minimal_http3_client.rb
-```
-
-## Usage
-
-### Rack HTTP/3 Server
+### Client
 
 ```ruby
 require "quicsilver"
 
-app = ->(env) {
-  [200, {'Content-Type' => 'text/html'}, ["<h1>Hello from HTTP/3!</h1>"]]
-}
+client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
+client.connect
 
-server = Quicsilver::Server.new(4433, app: app)
-server.start
-server.wait_for_connections
+response = client.get("/api/users")
+puts response[:body]
+
+response = client.post("/api/users", body: '{"name": "charlie"}')
+
+client.disconnect
 ```
 
-### HTTP/3 Client
+## Usage with Rails
 
-```ruby
-require "quicsilver"
+```bash
+rackup -s quicsilver -p 4433
+```
 
-client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
-client.connect
+## Configuration
 
-# Send HTTP/3 request
-request = Quicsilver::HTTP3::RequestEncoder.new(
-  method: 'GET',
-  path: '/api/users',
-  authority: 'example.com'
+```ruby
+server = Quicsilver::Server.new(4433,
+  app: app,
+  address: "0.0.0.0",
+  idle_timeout: 10_000,           # Connection idle timeout (ms)
+  initial_window_size: 65536,     # Flow control window
+  max_streams_bidi: 100,          # Max concurrent requests
+  cert_path: "/path/to/cert.pem", # TLS certificate
+  key_path: "/path/to/key.pem"    # TLS private key
 )
-client.send_data(request.encode)
-
-client.disconnect
 ```
 
 ## Development
 
 ```bash
-# Run tests
-rake test
-
-# Build extension
-rake compile
-
-# Clean build artifacts
-rake clean
+rake compile  # Build C extension
+rake test     # Run tests (122 passing)
+rake clean    # Clean build artifacts
 ```
 
 ## License

data/benchmarks/benchmark.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+# Usage: REQUESTS=1000 CONNECTIONS=10 ruby benchmarks/benchmark.rb
+
+require 'bundler/setup'
+require 'quicsilver'
+require 'benchmark'
+
+REQUESTS    = ENV.fetch('REQUESTS', 1000).to_i
+CONNECTIONS = ENV.fetch('CONNECTIONS', 1).to_i
+HOST        = ENV.fetch('HOST', '127.0.0.1')
+PORT        = ENV.fetch('PORT', 4433).to_i
+
+puts "Quicsilver HTTP/3 Benchmark"
+puts "=" * 50
+puts "Target: #{HOST}:#{PORT}"
+puts "Requests: #{REQUESTS} | Connections: #{CONNECTIONS}"
+puts "=" * 50
+
+results = []
+mutex = Mutex.new
+
+elapsed = Benchmark.realtime do
+  threads = CONNECTIONS.times.map do |conn_id|
+    Thread.new do
+      client = Quicsilver::Client.new(HOST, PORT, unsecure: true)
+      client.connect
+
+      local_times = []
+      per_conn = REQUESTS / CONNECTIONS
+
+      per_conn.times do |i|
+        start = Time.now
+        begin
+          client.get("/")
+          local_times << (Time.now - start)
+        rescue
+          local_times << nil
+        end
+        print "." if conn_id == 0 && i % (per_conn / 10).clamp(1, 100) == 0
+      end
+
+      client.disconnect
+      mutex.synchronize { results.concat(local_times) }
+    end
+  end
+  threads.each(&:join)
+end
+
+times = results.compact
+failed = results.count(&:nil?)
+
+puts "\n" + "=" * 50
+puts "RESULTS"
+puts "=" * 50
+puts "Total:    #{elapsed.round(3)}s"
+puts "Req/sec:  #{(REQUESTS / elapsed).round(2)}"
+puts "Success:  #{times.size} | Failed: #{failed}"
+
+if times.any?
+  sorted = times.sort
+  puts "Latency:  avg=#{(times.sum / times.size * 1000).round(2)}ms " \
+       "min=#{(sorted.first * 1000).round(2)}ms " \
+       "max=#{(sorted.last * 1000).round(2)}ms"
+  puts "          p50=#{(sorted[sorted.size / 2] * 1000).round(2)}ms " \
+       "p95=#{(sorted[(sorted.size * 0.95).to_i] * 1000).round(2)}ms " \
+       "p99=#{(sorted[(sorted.size * 0.99).to_i] * 1000).round(2)}ms"
+end
+puts "=" * 50

data/benchmarks/quicsilver_server.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+require 'localhost/authority'
+require 'json'
+
+SIMPLE_APP = lambda do |env|
+  case env['PATH_INFO']
+  when '/'
+    [200, {'Content-Type' => 'text/plain'}, ['OK']]
+  when '/json'
+    body = JSON.generate({status: 'ok', timestamp: Time.now.to_i})
+    [200, {'Content-Type' => 'application/json'}, [body]]
+  when '/echo'
+    [200, {'Content-Type' => 'text/plain'}, [env['REQUEST_METHOD']]]
+  else
+    [404, {'Content-Type' => 'text/plain'}, ['Not Found']]
+  end
+end
+
+port = ENV["PORT"] || 4433
+default_host = ENV["HOST"] || "0.0.0.0"
+
+authority = Localhost::Authority.fetch
+cert_file = authority.certificate_path
+key_file = authority.key_path
+
+config = ::Quicsilver::ServerConfiguration.new(cert_file, key_file)
+
+server = ::Quicsilver::Server.new(
+  port.to_i,
+  address: default_host,
+  app: SIMPLE_APP,
+  server_configuration: config
+)
+
+puts "Starting Quicsilver on port #{port}..."
+
+trap("INT") do
+  puts "\nStopping server..."
+  server.stop
+  exit
+end
+
+server.start  # Blocks until shutdown

data/examples/minimal_http3_server.rb

@@ -6,12 +6,6 @@ require "quicsilver"
 puts "🚀 Minimal HTTP/3 Server Example"
 puts "=" * 40
 
-# First, set up certificates if they don't exist
-unless File.exist?("certs/server.crt") && File.exist?("certs/server.key")
-  puts "📝 Setting up certificates..."
-  system("bash examples/setup_certs.sh")
-end
-
 # Create and start the server
 server = Quicsilver::Server.new(4433)
 

data/examples/rack_http3_server.rb

@@ -6,12 +6,6 @@ require "quicsilver"
 puts "🚀 Rack HTTP/3 Server Example"
 puts "=" * 40
 
-# First, set up certificates if they don't exist
-unless File.exist?("certs/server.crt") && File.exist?("certs/server.key")
-  puts "📝 Setting up certificates..."
-  system("bash examples/setup_certs.sh")
-end
-
 # Define a simple Rack app
 app = ->(env) {
   path = env['PATH_INFO']

data/examples/simple_client_test.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+
+puts "🔌 Simple HTTP/3 Client Test"
+puts "=" * 40
+
+begin
+  client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
+
+  client.connect
+
+  response = client.get("/posts")
+
+  puts "Status: #{response[:status]}"
+  puts "Headers: #{response[:headers].inspect}"
+  puts "Body: #{response[:body]}"
+
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+  puts e.backtrace.first(10)
+ensure
+  client&.disconnect
+  puts "👋 Done"
+end