quicsilver 0.2.0 → 0.4.0

data/lib/quicsilver.rb

@@ -2,19 +2,50 @@
 
 require "logger"
 require_relative "quicsilver/version"
-require_relative "quicsilver/client"
-require_relative "quicsilver/connection"
-require_relative "quicsilver/event_loop"
-require_relative "quicsilver/quic_stream"
-require_relative "quicsilver/listener_data"
-require_relative "quicsilver/request_registry"
-require_relative "quicsilver/server"
-require_relative "quicsilver/server_configuration"
-require_relative "quicsilver/http3"
-require_relative "quicsilver/http3/request_parser"
-require_relative "quicsilver/http3/request_encoder"
-require_relative "quicsilver/http3/response_encoder"
-require_relative "quicsilver/quicsilver"
+
+# Protocol layer
+require_relative "quicsilver/protocol/frames"
+require_relative "quicsilver/protocol/priority"
+require_relative "quicsilver/protocol/qpack/encoder"
+require_relative "quicsilver/protocol/request_parser"
+require_relative "quicsilver/protocol/request_encoder"
+require_relative "quicsilver/protocol/response_parser"
+require_relative "quicsilver/protocol/response_encoder"
+require_relative "quicsilver/protocol/stream_input"
+require_relative "quicsilver/protocol/stream_output"
+require_relative "quicsilver/protocol/adapter"
+require_relative "quicsilver/protocol/control_stream_parser"
+require "protocol/rack"
+
+# Transport layer
+require_relative "quicsilver/transport/stream"
+require_relative "quicsilver/transport/stream_event"
+require_relative "quicsilver/transport/inbound_stream"
+require_relative "quicsilver/transport/event_loop"
+require_relative "quicsilver/transport/configuration"
+require_relative "quicsilver/transport/connection"
+
+# Server
+require_relative "quicsilver/server/listener_data"
+require_relative "quicsilver/server/request_registry"
+require_relative "quicsilver/server/request_handler"
+require_relative "quicsilver/server/server"
+
+# Client
+require_relative "quicsilver/client/request"
+require_relative "quicsilver/client/connection_pool"
+require_relative "quicsilver/client/client"
+
+# C extension
+# Load precompiled binary if available, fall back to native extension
+begin
+  ruby_version = /(\d+\.\d+)/.match(RUBY_VERSION)
+  require_relative "quicsilver/#{ruby_version}/quicsilver"
+rescue LoadError
+  require_relative "quicsilver/quicsilver"
+end
+
+# Rackup handler
 require_relative "rackup/handler/quicsilver"
 
 module Quicsilver
@@ -41,4 +72,14 @@ module Quicsilver
       end
     end
   end
-end
+
+  # Release pooled client connections on process exit.
+  # Closes connection handles so the OS doesn't leak UDP sockets.
+  # MsQuic itself is cleaned up by the OS when the process exits.
+  at_exit do
+    begin
+      Client.close_pool
+    rescue StandardError # rubocop:disable Lint/SuppressedException
+    end
+  end
+end

data/lib/rackup/handler/quicsilver.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "quicsilver"
 require "rackup/handler"
 require "localhost"
 
@@ -36,7 +35,7 @@ module Quicsilver
         end
       end
 
-      config = ::Quicsilver::ServerConfiguration.new(cert_file, key_file)
+      config = ::Quicsilver::Transport::Configuration.new(cert_file, key_file)
 
       server = ::Quicsilver::Server.new(
         normalized_options[:port],

data/quicsilver.gemspec

@@ -11,6 +11,7 @@ Gem::Specification.new do |spec|
   spec.summary       = %q{HTTP/3 server implementation for Ruby}
   spec.description   = %q{HTTP/3 server implementation for Ruby}
   spec.homepage      = "https://github.com/hahmed/quicsilver"
+  spec.license       = "MIT"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -28,21 +29,30 @@ 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)/}) }
+    files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|vendor)/}) }
+    # Include precompiled binaries if present
+    files += Dir["lib/quicsilver/libmsquic*"]
+    files += Dir["lib/quicsilver/quicsilver.{bundle,so}"]
+    files
   end
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
-  spec.required_ruby_version = ">= 3.2.0"
+  spec.required_ruby_version = ">= 3.4.0"
 
   spec.extensions = ['ext/quicsilver/extconf.rb']
 
   spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency 'rake-compiler', '~> 1.2'
   spec.add_development_dependency 'rake-compiler-dock', '~> 1.3'
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "minitest-focus", "~> 1.3"
+  spec.add_development_dependency "benchmark-ips", "~> 2.12"
+  spec.add_dependency "protocol-http", "~> 0.49"
+  spec.add_dependency "protocol-rack", "~> 0.22"
+  spec.add_dependency "console" # TODO: drop when protocol-rack declares this in its gemspec
+  spec.add_dependency "logger"
   spec.add_dependency "localhost", "~> 1.6"
   spec.add_dependency "rack", "~> 3.0"
   spec.add_dependency "rackup", "~> 2.0"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quicsilver
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Haroon Ahmed
 bindir: exe
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2026-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +93,76 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.49'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.49'
+- !ruby/object:Gem::Dependency
+  name: protocol-rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: localhost
   requirement: !ruby/object:Gem::Requirement
@@ -144,6 +214,7 @@ extensions:
 extra_rdoc_files: []
 files:
 - ".github/workflows/ci.yml"
+- ".github/workflows/cibuildgem.yaml"
 - ".gitignore"
 - ".gitmodules"
 - ".ruby-version"
@@ -153,36 +224,69 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- benchmarks/benchmark.rb
+- benchmarks/components.rb
+- benchmarks/concurrent.rb
+- benchmarks/helpers.rb
 - benchmarks/quicsilver_server.rb
+- benchmarks/rails.rb
+- benchmarks/throughput.rb
 - bin/console
 - bin/setup
 - examples/README.md
+- examples/benchmark.rb
+- examples/connection_pool_demo.rb
+- examples/example_helper.rb
+- examples/falcon_middleware.rb
+- examples/feature_demo.rb
+- examples/grpc_style.rb
 - examples/minimal_http3_server.rb
+- examples/priorities.rb
+- examples/protocol_http_server.rb
 - examples/rack_http3_server.rb
-- examples/setup_certs.sh
+- examples/rails_feature_test.rb
 - examples/simple_client_test.rb
+- examples/streaming_sse.rb
+- examples/trailers.rb
 - ext/quicsilver/extconf.rb
 - ext/quicsilver/quicsilver.c
 - lib/quicsilver.rb
-- lib/quicsilver/client.rb
-- lib/quicsilver/connection.rb
-- lib/quicsilver/event_loop.rb
-- lib/quicsilver/http3.rb
-- lib/quicsilver/http3/request_encoder.rb
-- lib/quicsilver/http3/request_parser.rb
-- lib/quicsilver/http3/response_encoder.rb
-- lib/quicsilver/http3/response_parser.rb
-- lib/quicsilver/listener_data.rb
-- lib/quicsilver/quic_stream.rb
-- lib/quicsilver/request_registry.rb
-- lib/quicsilver/server.rb
-- lib/quicsilver/server_configuration.rb
+- lib/quicsilver/client/client.rb
+- lib/quicsilver/client/connection_pool.rb
+- lib/quicsilver/client/request.rb
+- lib/quicsilver/libmsquic.2.dylib
+- lib/quicsilver/protocol/adapter.rb
+- lib/quicsilver/protocol/control_stream_parser.rb
+- lib/quicsilver/protocol/frame_parser.rb
+- lib/quicsilver/protocol/frame_reader.rb
+- lib/quicsilver/protocol/frames.rb
+- lib/quicsilver/protocol/priority.rb
+- lib/quicsilver/protocol/qpack/decoder.rb
+- lib/quicsilver/protocol/qpack/encoder.rb
+- lib/quicsilver/protocol/qpack/header_block_decoder.rb
+- lib/quicsilver/protocol/qpack/huffman.rb
+- lib/quicsilver/protocol/request_encoder.rb
+- lib/quicsilver/protocol/request_parser.rb
+- lib/quicsilver/protocol/response_encoder.rb
+- lib/quicsilver/protocol/response_parser.rb
+- lib/quicsilver/protocol/stream_input.rb
+- lib/quicsilver/protocol/stream_output.rb
+- lib/quicsilver/quicsilver.bundle
+- lib/quicsilver/server/listener_data.rb
+- lib/quicsilver/server/request_handler.rb
+- lib/quicsilver/server/request_registry.rb
+- lib/quicsilver/server/server.rb
+- lib/quicsilver/transport/configuration.rb
+- lib/quicsilver/transport/connection.rb
+- lib/quicsilver/transport/event_loop.rb
+- lib/quicsilver/transport/inbound_stream.rb
+- lib/quicsilver/transport/stream.rb
+- lib/quicsilver/transport/stream_event.rb
 - lib/quicsilver/version.rb
 - lib/rackup/handler/quicsilver.rb
 - quicsilver.gemspec
 homepage: https://github.com/hahmed/quicsilver
-licenses: []
+licenses:
+- MIT
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/hahmed/quicsilver
@@ -195,7 +299,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/benchmarks/benchmark.rb

@@ -1,68 +0,0 @@
-#!/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/examples/setup_certs.sh

@@ -1,57 +0,0 @@
-#!/bin/bash
-
-# Quicsilver Certificate Setup
-# This script generates self-signed certificates for QUIC testing
-
-echo "🔐 Generating certificates for Quicsilver QUIC testing..."
-
-# Create certs directory if it doesn't exist
-mkdir -p ../certs
-cd ../certs
-
-# Create OpenSSL config with proper TLS server extensions
-cat > openssl.conf << 'EOF'
-[req]
-distinguished_name = req_distinguished_name
-req_extensions = v3_req
-prompt = no
-
-[req_distinguished_name]
-CN = localhost
-O = QuicsilverTest
-C = US
-
-[v3_req]
-keyUsage = keyEncipherment, dataEncipherment
-extendedKeyUsage = serverAuth
-subjectAltName = @alt_names
-
-[alt_names]
-DNS.1 = localhost
-IP.1 = 127.0.0.1
-EOF
-
-# Generate private key and certificate
-echo "📝 Generating private key..."
-openssl genrsa -out server.key 2048
-
-echo "📜 Generating certificate..."
-openssl req -new -x509 -key server.key -out server.crt -days 365 \
-  -config openssl.conf -extensions v3_req
-
-# Create PKCS#12 format (optional, for other tools)
-echo "📦 Creating PKCS#12 bundle..."
-openssl pkcs12 -export -out server.p12 -inkey server.key -in server.crt \
-  -passout pass:password -name "localhost"
-
-# Clean up
-rm openssl.conf
-
-echo "✅ Certificate files created:"
-echo "   📄 server.crt - Certificate file"
-echo "   🔑 server.key - Private key file"  
-echo "   📦 server.p12 - PKCS#12 bundle (password: 'password')"
-echo ""
-echo "🚀 You can now run:"
-echo "   Terminal 1: ruby examples/test_server.rb"
-echo "   Terminal 2: ruby examples/test_connection.rb"