quic 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 12a202268fc7d9b862cdc0b6577284f5ae98fc275229b129be39f03656ce6967
+  data.tar.gz: eef365c93fcce127f4621ac8aa244ea0b020f239c29bd56bdd5706998852449d
+SHA512:
+  metadata.gz: a6fdb666ea56dc95b50087da5f43a14366416434029e59b4e041f4a7a5eb41a79abbf530403bb7b4505ada4da5387cf6fcba5fc29f8350bc0466bb5ad8f58dc4
+  data.tar.gz: 33f053db5b35c2c7dd428d5e6ad3e29b58b4624f208ebae9593b3bb160fdfd7622942c13d75311ebd854411371f09690627a1f42366d1b3fe24d06362cbe7f36

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.0.1] - 2026-05-28
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"quic" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["yusuke1994525@gmail.com"](mailto:"yusuke1994525@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Yusuke Nakamura
+
+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

@@ -0,0 +1,35 @@
+# Quic
+
+`quic` is a thin Ruby binding around [ngtcp2](https://github.com/ngtcp2/ngtcp2) for the QUIC transport protocol, with [LibreSSL](https://github.com/libressl/portable) as the TLS backend. Both dependencies are vendored at install time via [`mini_portile2`](https://github.com/flavorjones/mini_portile) (no system libraries required).
+
+The gem is intentionally optimized for **synchronous I/O and `String`-based buffers**. It exposes ngtcp2 primitives (`#read_pkt` / `#write_pkt` / `#expiry` / `#handle_expiry`) and lets the caller own the I/O loop. If you need Fiber Scheduler / `IO::Buffer` / `async` ecosystem integration, see [`socketry/protocol-quic`](https://github.com/socketry/protocol-quic) instead.
+
+This project is in early development; the public API is not yet stable.
+
+## Installation
+
+Not yet released to RubyGems.org. To use from a Gemfile while it is in development:
+
+```ruby
+gem "quic", github: "unasuke/quic-ruby"
+```
+
+The native extension downloads and builds LibreSSL and ngtcp2 release tarballs during `bundle install`, so the host needs `autoconf`, `automake`, `libtool`, `pkg-config`, and a C toolchain available.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then run `bundle exec rake` to compile the C extension and run the tests + linter. You can also run `bin/console` for an interactive prompt.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/unasuke/quic-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/unasuke/quic-ruby/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Quic project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/unasuke/quic-ruby/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+require "rake/extensiontask"
+
+task build: :compile
+
+GEMSPEC = Gem::Specification.load("quic.gemspec")
+
+Rake::ExtensionTask.new("quic", GEMSPEC) do |ext|
+  ext.lib_dir = "lib/quic"
+end
+
+task default: %i[clobber compile test standard]

data/examples/echo_demo.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Stream API demo: open a bidirectional stream, write a small payload with
+# FIN, then block on Stream#read until the peer echoes the bytes back and
+# closes its side. Requires a local QUIC echo server (default: 127.0.0.1:4433
+# with ALPN "perf"); ngtcp2 ships an examples/server binary that does this
+# when built with --enable-examples.
+#
+# Override the target via env vars:
+#   QUIC_ECHO_HOST  (default 127.0.0.1)
+#   QUIC_ECHO_PORT  (default 4433)
+#   QUIC_ECHO_ALPN  (default perf)
+#
+# Run with: bundle exec ruby examples/echo_demo.rb
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "quic"
+require "socket"
+
+TARGET_HOST = ENV.fetch("QUIC_ECHO_HOST", "127.0.0.1")
+TARGET_PORT = Integer(ENV.fetch("QUIC_ECHO_PORT", "4433"))
+TARGET_ALPN = ENV.fetch("QUIC_ECHO_ALPN", "perf")
+
+addr = Addrinfo.getaddrinfo(TARGET_HOST, TARGET_PORT, Socket::AF_INET, Socket::SOCK_DGRAM).first
+sock = UDPSocket.new
+sock.connect(addr.ip_address, addr.ip_port)
+
+settings = Quic::Settings.default.with(alpn: [TARGET_ALPN])
+client = Quic::Connection::Client._open(
+  local_sockaddr: Addrinfo.udp("0.0.0.0", 0).to_sockaddr,
+  remote_sockaddr: addr.to_sockaddr,
+  server_name: TARGET_HOST,
+  transport_params: Quic::TransportParams.default,
+  settings: settings
+)
+client.bind(sock).run
+
+stream = client.open_bidi_stream
+puts "opened stream #{stream.id} (#{stream.initiator})"
+
+payload = "hello quic stream\n"
+stream.write(payload, fin: true)
+puts "sent #{payload.bytesize} bytes + FIN"
+
+response = stream.read
+puts "received #{response.bytesize} bytes:"
+puts response
+
+sock.close

data/examples/handshake_demo.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Sample script: drive a real QUIC + TLS 1.3 handshake against a public
+# HTTP/3 server (cloudflare-quic.com:443) using Client#bind + Client#run.
+#
+# Why _open instead of Client.new: Client.new resolves the hostname via
+# Addrinfo.udp, and UDPSocket#connect resolves it independently. Cloudflare
+# returns multiple A/AAAA records, so the two resolutions can disagree
+# and ngtcp2 then drops every reply with "ignore packet from unknown path".
+# Pre-resolving once to a single IPv4 sockaddr and feeding it to both
+# _open and the socket avoids this.
+#
+# Run with: bundle exec ruby examples/handshake_demo.rb
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "quic"
+require "socket"
+
+TARGET_HOST = "cloudflare-quic.com"
+TARGET_PORT = 443
+
+addr = Addrinfo.getaddrinfo(TARGET_HOST, TARGET_PORT, Socket::AF_INET, Socket::SOCK_DGRAM).first
+sock = UDPSocket.new
+sock.connect(addr.ip_address, addr.ip_port)
+
+settings = Quic::Settings.default.with(alpn: ["h3"])
+client = Quic::Connection::Client._open(
+  local_sockaddr: Addrinfo.udp("0.0.0.0", 0).to_sockaddr,
+  remote_sockaddr: addr.to_sockaddr,
+  server_name: TARGET_HOST,
+  transport_params: Quic::TransportParams.default,
+  settings: settings
+)
+
+puts "ngtcp2: #{Quic.library_versions[:ngtcp2]}"
+puts "TLS:    #{Quic.library_versions[:openssl]}"
+puts "Target: #{TARGET_HOST} (#{addr.ip_address}:#{addr.ip_port})"
+puts
+
+t0 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+client.bind(sock).run
+elapsed_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - t0) * 1000).round(1)
+
+puts "handshake_completed? #{client.handshake_completed?} (#{elapsed_ms}ms)"
+sock.close