quicsilver 0.1.0 → 0.2.0

data/lib/rackup/handler/quicsilver.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "quicsilver"
+require "rackup/handler"
+require "localhost"
+
+module Quicsilver
+  module RackHandler
+    DEFAULT_OPTIONS = {
+      Host: "0.0.0.0",
+      Port: 4433,
+    }
+
+    def self.run(app, **options)
+      normalized_options = {
+        host: options[:Host] || options[:host] || DEFAULT_OPTIONS[:Host],
+        port: (options[:Port] || options[:port] || DEFAULT_OPTIONS[:Port]).to_i,
+      }
+
+      cert_file = options[:cert_file]
+      key_file = options[:key_file]
+
+      if cert_file.nil? && key_file.nil?
+        env = options[:environment] || ENV['RACK_ENV'] || ENV['RAILS_ENV'] || 'development'
+
+        if env == 'production'
+          raise ArgumentError, "cert_file and key_file are required in production"
+        else
+          require 'localhost/authority'
+          authority = Localhost::Authority.fetch
+          cert_file = authority.certificate_path
+          key_file = authority.key_path
+          Quicsilver.logger.info("Using auto-generated certificates for localhost")
+          Quicsilver.logger.info("  Cert: #{cert_file}")
+          Quicsilver.logger.info("  Key: #{key_file}")
+        end
+      end
+
+      config = ::Quicsilver::ServerConfiguration.new(cert_file, key_file)
+
+      server = ::Quicsilver::Server.new(
+        normalized_options[:port],
+        address: normalized_options[:host],
+        app: app,
+        server_configuration: config
+      )
+
+      yield server if block_given?
+
+      server.start
+    end
+
+    def self.valid_options
+      {
+        "Host=HOST" => "Hostname to listen on (default: 0.0.0.0)",
+        "Port=PORT" => "Port to listen on (default: 4433)",
+        "cert_file=PATH" => "Path to TLS certificate file (required)",
+        "key_file=PATH" => "Path to TLS key file (required)"
+      }
+    end
+
+  end
+end
+
+module Rackup
+  module Handler
+    module Quicsilver
+      def self.run(app, **options, &block)
+        ::Quicsilver::RackHandler.run(app, **options, &block)
+      end
+
+      def self.valid_options
+        ::Quicsilver::RackHandler.valid_options
+      end
+    end
+    register :quicsilver, Quicsilver
+  end
+end

data/quicsilver.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Haroon Ahmed"]
   spec.email         = ["haroon.ahmed25@gmail.com"]
 
-  spec.summary       = %q{Minimal HTTP/3 server implementation for Ruby}
-  spec.description   = %q{A minimal HTTP/3 server implementation for Ruby using Microsoft's MSQUIC library.}
+  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"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
@@ -33,6 +33,7 @@ Gem::Specification.new do |spec|
   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.extensions = ['ext/quicsilver/extconf.rb']
 
@@ -41,4 +42,8 @@ Gem::Specification.new do |spec|
   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_dependency "localhost", "~> 1.6"
+  spec.add_dependency "rack", "~> 3.0"
+  spec.add_dependency "rackup", "~> 2.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quicsilver
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Haroon Ahmed
 bindir: exe
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2025-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -79,8 +79,63 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
-description: A minimal HTTP/3 server implementation for Ruby using Microsoft's MSQUIC
-  library.
+- !ruby/object:Gem::Dependency
+  name: minitest-focus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: localhost
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: HTTP/3 server implementation for Ruby
 email:
 - haroon.ahmed25@gmail.com
 executables: []
@@ -88,33 +143,43 @@ extensions:
 - ext/quicsilver/extconf.rb
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".gitmodules"
 - ".ruby-version"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
+- LICENSE
 - README.md
 - Rakefile
+- benchmarks/benchmark.rb
+- benchmarks/quicsilver_server.rb
 - bin/console
 - bin/setup
 - examples/README.md
-- examples/minimal_http3_client.rb
 - examples/minimal_http3_server.rb
 - examples/rack_http3_server.rb
 - examples/setup_certs.sh
+- examples/simple_client_test.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/version.rb
+- lib/rackup/handler/quicsilver.rb
 - quicsilver.gemspec
 homepage: https://github.com/hahmed/quicsilver
 licenses: []
@@ -130,7 +195,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -139,5 +204,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.2
 specification_version: 4
-summary: Minimal HTTP/3 server implementation for Ruby
+summary: HTTP/3 server implementation for Ruby
 test_files: []

data/examples/minimal_http3_client.rb

@@ -1,89 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "quicsilver"
-
-puts "🔌 Minimal HTTP/3 Client Example"
-puts "=" * 40
-
-# Create client
-client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
-
-puts "🔧 Connecting to server..."
-begin
-  client.connect
-  puts "✅ Connected successfully!"
-  puts "📋 Connection info: #{client.connection_info}"
-  
-  # HTTP/3 requests using RequestEncoder
-  require_relative '../lib/quicsilver/http3/request_encoder'
-
-  request1 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'GET',
-    path: '/api/users',
-    authority: 'example.com'
-  )
-  client.send_data(request1.encode)
-
-  request2 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'GET',
-    path: '/api/posts/123',
-    authority: 'example.com'
-  )
-  client.send_data(request2.encode)
-
-  request3 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'POST',
-    path: '/api/messages',
-    authority: 'example.com',
-    body: '{"text":"Hello world"}'
-  )
-  client.send_data(request3.encode)
-
-  # JSON payloads (API requests) - now as proper HTTP/3 POST requests
-  request4 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'POST',
-    path: '/api/subscribe',
-    authority: 'example.com',
-    headers: { 'content-type' => 'application/json' },
-    body: '{"action":"subscribe","channel":"orders"}'
-  )
-  client.send_data(request4.encode)
-
-  request5 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'POST',
-    path: '/api/update',
-    authority: 'example.com',
-    headers: { 'content-type' => 'application/json' },
-    body: '{"action":"update","user_id":42,"status":"online"}'
-  )
-  client.send_data(request5.encode)
-
-  # These old manually-crafted requests use incorrect QPACK indices - removed
-
-  # Metrics/telemetry
-  # client.send_data("METRIC:cpu=45.2,mem=1024,ts=#{Time.now.to_i}")
-  # client.send_data("EVENT:login,user=alice,ip=192.168.1.100")
-  
-  # Large message test - now as HTTP/3 request
-  request8 = Quicsilver::HTTP3::RequestEncoder.new(
-    method: 'POST',
-    path: '/upload',
-    authority: 'example.com',
-    body: "X" * 50000  # 50KB
-  )
-  client.send_data(request8.encode)
-
-  # Keep connection alive for a bit
-  puts "⏳ Connection established. Press Enter to disconnect..."
-  gets
-  
-rescue Quicsilver::ConnectionError => e
-  puts "❌ Connection failed: #{e.message}"
-rescue Quicsilver::TimeoutError => e
-  puts "⏰ Connection timed out: #{e.message}"
-ensure
-  puts "🔌 Disconnecting..."
-  client.disconnect
-  puts "👋 Disconnected"
-end