quicsilver 0.1.0 → 0.3.0

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quicsilver
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Haroon Ahmed
 bindir: exe
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2026-03-23 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
@@ -79,8 +79,91 @@ 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: 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: 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
+    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 +171,55 @@ 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/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/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/http3.rb
-- lib/quicsilver/http3/request_encoder.rb
-- lib/quicsilver/http3/request_parser.rb
-- lib/quicsilver/http3/response_encoder.rb
-- lib/quicsilver/listener_data.rb
-- lib/quicsilver/server.rb
-- lib/quicsilver/server_configuration.rb
+- lib/quicsilver/client/client.rb
+- lib/quicsilver/client/request.rb
+- lib/quicsilver/protocol/frames.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/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: []
@@ -130,7 +235,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 +244,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 

data/lib/quicsilver/client.rb

@@ -1,191 +0,0 @@
-# frozen_string_literal: true
-
-module Quicsilver
-  class Client
-    attr_reader :hostname, :port, :unsecure, :connection_timeout
-    
-    def initialize(hostname, port = 4433, options = {})
-      @hostname = hostname
-      @port = port
-      @unsecure = options[:unsecure] || true
-      @connection_timeout = options[:connection_timeout] || 5000
-   
-      @connection_data = nil
-      @connected = false
-      @connection_start_time = nil
-    end
-    
-    def connect
-      raise Error, "Already connected" if @connected
-
-      # Initialize MSQUIC if not already done
-      result = Quicsilver.open_connection
-      
-      # Create configuration
-      config = Quicsilver.create_configuration(@unsecure)
-      raise ConnectionError, "Failed to create configuration" if config.nil?
-      
-      # Create connection (returns [handle, context])
-      @connection_data = Quicsilver.create_connection
-      raise ConnectionError, "Failed to create connection" if @connection_data.nil?
-      
-      connection_handle = @connection_data[0]
-      context_handle = @connection_data[1]
-      
-      # Start the connection
-      success = Quicsilver.start_connection(connection_handle, config, @hostname, @port)
-      unless success
-        Quicsilver.close_configuration(config)
-        cleanup_failed_connection
-        raise ConnectionError, "Failed to start connection"
-      end
-
-      # Wait for connection to establish or fail
-      result = Quicsilver.wait_for_connection(context_handle, @connection_timeout)
-
-      if result.key?("error")
-        error_status = result["status"]
-        error_code = result["code"]
-        Quicsilver.close_configuration(config)
-        cleanup_failed_connection
-        error_msg = "Connection failed with status: 0x#{error_status.to_s(16)}, code: #{error_code}"
-        raise ConnectionError, error_msg
-      elsif result.key?("timeout")
-        Quicsilver.close_configuration(config)
-        cleanup_failed_connection
-        error_msg = "Connection timed out after #{@connection_timeout}ms"
-        raise TimeoutError, error_msg
-      end
-      
-      @connected = true
-      @connection_start_time = Time.now
-      
-      send_control_stream
-      
-      # Clean up config since connection is established
-      Quicsilver.close_configuration(config)
-    rescue => e
-      cleanup_failed_connection
-      
-      if e.is_a?(ConnectionError) || e.is_a?(TimeoutError)
-        raise e
-      else
-        raise ConnectionError, "Connection failed: #{e.message}"
-      end
-    end
-    
-    def disconnect
-      return unless @connected || @connection_data
-      
-      begin
-        if @connection_data
-          Quicsilver.close_connection_handle(@connection_data)
-          @connection_data = nil
-        end
-      rescue
-        # Ignore disconnect errors
-      ensure
-        @connected = false
-        @connection_start_time = nil
-      end
-    end
-    
-    def connected?
-      return false unless @connected && @connection_data
-
-      # Get connection status from the C extension
-      context_handle = @connection_data[1]
-      info = Quicsilver.connection_status(context_handle)
-      if info && info.key?("connected")
-        is_connected = info["connected"] && !info["failed"]
-        
-        # If C extension says we're disconnected, update our state
-        if !is_connected && @connected
-          @connected = false
-        end
-        
-        is_connected
-      else
-        # If we can't get status, assume disconnected
-        if @connected
-          @connected = false
-        end
-        false
-      end
-    rescue
-      # If there's an error checking status, assume disconnected
-      if @connected
-        @connected = false
-      end
-      false
-    end
-    
-    def connection_info
-      base_info = if @connection_data
-        begin
-          context_handle = @connection_data[1]
-          Quicsilver.connection_status(context_handle) || {}
-        rescue
-          {}
-        end
-      else
-        {}
-      end
-      
-      base_info.merge({
-        hostname: @hostname,
-        port: @port,
-        uptime: connection_uptime
-      })
-    end
-    
-    def connection_uptime
-      return 0 unless @connection_start_time
-      Time.now - @connection_start_time
-    end
-
-    def send_data(data)
-      raise Error, "Not connected" unless @connected
-
-      stream = open_stream
-      unless stream
-        puts "❌ Failed to open stream"
-        return false
-      end
-
-      result = Quicsilver.send_stream(stream, data, true)
-      puts "✅ Sent #{data.bytesize} bytes"
-      result
-    rescue => e
-      puts "❌ Send data error: #{e.class} - #{e.message}"
-      false
-    end
-    
-    private
-    
-    def cleanup_failed_connection
-      Quicsilver.close_connection_handle(@connection_data) if @connection_data
-      @connection_data = nil
-      @connected = false
-    end
-
-    def open_stream
-      Quicsilver.open_stream(@connection_data[0], false)
-    end
-
-    def open_unidirectional_stream
-      Quicsilver.open_stream(@connection_data[0], true)
-    end
-
-    def send_control_stream
-      # Open unidirectional stream
-      stream = open_unidirectional_stream
-
-      # Build and send control stream data
-      control_data = Quicsilver::HTTP3.build_control_stream
-      Quicsilver.send_stream(stream, control_data, false)
-
-      @control_stream = stream
-    end
-  end
-end

data/lib/quicsilver/http3/request_encoder.rb

@@ -1,112 +0,0 @@
-# frozen_string_literal: true
-
-module Quicsilver
-  module HTTP3
-    class RequestEncoder
-      def initialize(method:, path:, scheme: 'https', authority: 'localhost:4433', headers: {}, body: nil)
-        @method = method.upcase
-        @path = path
-        @scheme = scheme
-        @authority = authority
-        @headers = headers
-        @body = body
-      end
-
-      def encode
-        frames = []
-
-        # Build HEADERS frame
-        headers_payload = encode_headers
-        frames << build_frame(0x01, headers_payload)  # 0x01 = HEADERS frame
-
-        # Build DATA frame if body present
-        if @body && !@body.empty?
-          body_data = @body.is_a?(String) ? @body : @body.join
-          frames << build_frame(0x00, body_data)  # 0x00 = DATA frame
-        end
-
-        frames.join.force_encoding(Encoding::BINARY)
-      end
-
-      private
-
-      def build_frame(type, payload)
-        frame_type = HTTP3.encode_varint(type)
-        frame_length = HTTP3.encode_varint(payload.bytesize)
-        frame_type + frame_length + payload
-      end
-
-      def encode_headers
-        payload = "".b
-
-        # QPACK prefix: Required Insert Count = 0, Delta Base = 0
-        payload += "\x00\x00".b
-
-        # Encode pseudo-headers using Indexed Field Line with Post-Base Index
-        # Pattern: 0x50 (0101 0000) for :method, :scheme
-        # Pattern: 0x40 | index for :authority, :path (literal name, literal value)
-
-        # :method (use literal since GET/POST have specific indices but we want flexibility)
-        payload += encode_literal_pseudo_header(':method', @method)
-
-        # :scheme
-        payload += encode_literal_pseudo_header(':scheme', @scheme)
-
-        # :authority
-        payload += encode_literal_pseudo_header(':authority', @authority)
-
-        # :path
-        payload += encode_literal_pseudo_header(':path', @path)
-
-        # Encode regular headers
-        @headers.each do |name, value|
-          payload += encode_literal_header(name.to_s.downcase, value.to_s)
-        end
-
-        payload
-      end
-
-      # Literal field line with literal name for pseudo-headers
-      # Pattern: 0x50 (indexed name from static table) + value
-      def encode_literal_pseudo_header(name, value)
-        # For pseudo-headers, use indexed name reference from static table
-        # with literal value (pattern: 0101xxxx where xxxx = static table index)
-        static_index = case name
-        when ':authority' then 0
-        when ':path' then 1
-        when ':method' then (@method == 'GET' ? 17 : 20)  # GET=17, POST=20
-        when ':scheme' then (@scheme == 'http' ? 22 : 23)
-        else nil
-        end
-
-        if static_index
-          # Use indexed field line (0x40 | index)
-          result = "".b
-          result += [0x40 | static_index].pack('C')
-          # For non-exact matches, append literal value
-          if name == ':authority' || name == ':path'
-            result += HTTP3.encode_varint(value.bytesize)
-            result += value.to_s.b
-          end
-          result
-        else
-          # Fallback to literal name
-          encode_literal_header(name, value)
-        end
-      end
-
-      # Literal field line with literal name
-      # Pattern: 0x20 | name_length, name_bytes, value_length, value_bytes
-      def encode_literal_header(name, value)
-        result = "".b
-        # 0x20 = literal with literal name (no indexing)
-        name_len = name.bytesize
-        result += [0x20 | (name_len & 0x1F)].pack('C')
-        result += name.b
-        result += HTTP3.encode_varint(value.bytesize)
-        result += value.to_s.b
-        result
-      end
-    end
-  end
-end