wreq 1.0.0

data/examples/proxy.rb

@@ -0,0 +1,113 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/wreq"
+
+# Proxy templates:
+# HTTP/HTTPS proxy: http://127.0.0.1:6152
+# SOCKS5 proxy: socks5://127.0.0.1:6153
+
+puts "=" * 60
+puts "Wreq Ruby Proxy Examples"
+puts "=" * 60
+
+# ==============================================================================
+# Example 1: Basic HTTP Proxy
+# ==============================================================================
+puts "\n--- Example 1: Basic HTTP Proxy ---"
+begin
+  client = Wreq::Client.new(
+    user_agent: "WreqClient/1.0",
+    proxy: "http://127.0.0.1:6152"
+  )
+  puts "✅ Client with HTTP proxy created"
+
+  response = client.get("https://httpbin.io/ip")
+  puts "Status: #{response.code}"
+  puts "Response: #{response.text}"
+rescue Wreq::RequestError => e
+  puts "❌ Request failed: #{e.message}"
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+end
+
+# ==============================================================================
+# Example 2: SOCKS5 Proxy
+# ==============================================================================
+puts "\n--- Example 2: SOCKS5 Proxy ---"
+begin
+  client = Wreq::Client.new(
+    user_agent: "WreqClient/1.0",
+    proxy: "socks5://127.0.0.1:6153"
+  )
+  puts "✅ Client with SOCKS5 proxy created"
+
+  response = client.get("https://httpbin.io/ip")
+  puts "Status: #{response.code}"
+  puts "Response: #{response.text}"
+rescue Wreq::RequestError => e
+  puts "❌ Request failed: #{e.message}"
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+end
+
+# ==============================================================================
+# Example 3: SOCKS5h Proxy (DNS resolution through proxy)
+# ==============================================================================
+puts "\n--- Example 3: SOCKS5h Proxy (Remote DNS) ---"
+begin
+  client = Wreq::Client.new(
+    user_agent: "WreqClient/1.0",
+    proxy: "socks5h://127.0.0.1:6153"
+  )
+  puts "✅ Client with SOCKS5h proxy created (DNS resolved by proxy)"
+
+  response = client.get("https://httpbin.io/ip")
+  puts "Status: #{response.code}"
+  puts "Response: #{response.text}"
+rescue Wreq::RequestError => e
+  puts "❌ Request failed: #{e.message}"
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+end
+
+# ==============================================================================
+# Example 4: HTTP Proxy with Authentication
+# ==============================================================================
+puts "\n--- Example 4: HTTP Proxy with Authentication ---"
+begin
+  # Format: http://username:password@host:port
+  client = Wreq::Client.new(
+    user_agent: "WreqClient/1.0",
+    proxy: "http://user:pass@127.0.0.1:6152"
+  )
+  puts "✅ Client with authenticated HTTP proxy created"
+
+  response = client.get("https://httpbin.io/ip")
+  puts "Status: #{response.code}"
+  puts "Response: #{response.text}"
+rescue Wreq::RequestError => e
+  puts "❌ Request failed: #{e.message}"
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+end
+
+# ==============================================================================
+# Example 5: SOCKS5 Proxy with Authentication
+# ==============================================================================
+puts "\n--- Example 5: SOCKS5 Proxy with Authentication ---"
+begin
+  # Format: socks5://username:password@host:port
+  client = Wreq::Client.new(
+    user_agent: "WreqClient/1.0",
+    proxy: "socks5://user:pass@127.0.0.1:6153"
+  )
+  puts "✅ Client with authenticated SOCKS5 proxy created"
+
+  response = client.get("https://httpbin.io/ip")
+  puts "Status: #{response.code}"
+  puts "Response: #{response.text}"
+rescue Wreq::RequestError => e
+  puts "❌ Request failed: #{e.message}"
+rescue => e
+  puts "❌ Error: #{e.class} - #{e.message}"
+end

data/examples/send_stream.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/wreq"
+require "json"
+require "tmpdir"
+
+# Helpers
+ENDPOINT = ENV["WREQ_ECHO_URL"] || "https://httpbin.io/post"
+CHUNK = 64 * 1024
+
+def example1_simple_push
+  puts "\n=== Example 1: Simple push ==="
+  client = Wreq::Client.new
+  us = Wreq::BodySender.new(8)
+
+  producer = Thread.new do
+    5.times do |i|
+      us.push("chunk-#{i}\n")
+      sleep 0.05
+    end
+    us.close
+  end
+
+  resp = client.post(ENDPOINT, body: us, headers: {"Content-Type" => "text/plain"})
+  body = resp.json
+  data = body["data"] || body["json"].to_json
+  puts "Echoed bytes: #{data.bytesize}"
+  producer.join
+end
+
+def example2_file_stream
+  puts "\n=== Example 2: File streaming ==="
+  client = Wreq::Client.new
+  us = Wreq::BodySender.new(16)
+
+  # Prepare a temp file (~250KB)
+  path = File.join(Dir.tmpdir, "wreq_upload_sample.bin")
+  File.binwrite(path, Random.new.bytes(2_500_00))
+
+  total = 0
+  producer = Thread.new do
+    File.open(path, "rb") do |f|
+      while (chunk = f.read(CHUNK))
+        total += chunk.bytesize
+        us.push(chunk)
+      end
+    end
+    us.close
+  end
+
+  resp = client.post(ENDPOINT, body: us, headers: {"Content-Type" => "application/octet-stream"})
+  json = resp.json
+  echoed = (json["headers"] && json["headers"]["Content-Length"]) || (json["data"] || "").bytesize
+  puts "Sent bytes ~#{total}, echoed length: #{echoed}"
+  producer.join
+ensure
+  File.delete(path) if path && File.exist?(path)
+end
+
+def example3_background_producer
+  puts "\n=== Example 3: Background thread producer ==="
+  client = Wreq::Client.new
+  us = Wreq::BodySender.new(4)
+
+  # Simulate streaming generation
+  producer = Thread.new do
+    (1..20).each do |i|
+      us.push("data-#{i},")
+      sleep 0.01
+    end
+    us.close
+  end
+
+  resp = client.post(ENDPOINT, body: us)
+  json = resp.json
+  data = json["data"] || ""
+  puts "Received length: #{data.bytesize}"
+  producer.join
+end
+
+if __FILE__ == $0
+  example1_simple_push
+  example2_file_stream
+  example3_background_producer
+end

data/examples/stream.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/wreq"
+
+# Make a request
+client = Wreq::Client.new
+response = client.get("https://httpbin.io/stream/20")
+
+# Get the streaming body receiver
+puts "\n=== Streaming Response Body ==="
+response.chunks do |chunk|
+  puts chunk
+  sleep 0.1 # Simulate processing time
+end

data/examples/thread_interrupt.rb

@@ -0,0 +1,83 @@
+#!/usr/bin/env ruby
+
+# Tests Thread.kill interrupt support for wreq HTTP operations.
+# All blocking operations should respond to thread interruption.
+
+require_relative "../lib/wreq"
+
+HANGING_URL = "http://10.255.255.1:12345/" # Non-routable, hangs forever
+SLOW_BODY_URL = "https://httpbin.io/drip?duration=5&numbytes=5" # 5s slow body
+
+def test_interrupt(name, kill_after: 2, max_wait: 5)
+  print "#{name}: "
+
+  start = Time.now
+  thread = Thread.new { yield }
+
+  sleep kill_after
+  thread.kill
+  killed = thread.join(max_wait)
+
+  elapsed = Time.now - start
+
+  if killed && elapsed < (kill_after + max_wait)
+    puts "PASS (killed in #{elapsed.round(1)}s)"
+    :pass
+  else
+    puts "FAIL (still alive after #{elapsed.round(1)}s)"
+    begin
+      Thread.kill(thread)
+    rescue
+      nil
+    end
+    :fail
+  end
+end
+
+puts "Thread Interrupt Test"
+puts "=" * 40
+
+results = []
+
+# Test 1: Connection phase (non-routable IP)
+results << test_interrupt("Connect phase") {
+  begin
+    Wreq.get(HANGING_URL)
+  rescue
+    nil
+  end
+}
+
+# Test 2: Connection phase with timeout
+results << test_interrupt("Connect + timeout") {
+  begin
+    Wreq.get(HANGING_URL, timeout: 60)
+  rescue
+    nil
+  end
+}
+
+# Test 3: Body reading phase (slow drip endpoint)
+results << test_interrupt("Body reading") {
+  resp = Wreq.get(SLOW_BODY_URL)
+  begin
+    resp.text
+  rescue
+    nil
+  end
+}
+
+# Test 4: Body streaming phase
+results << test_interrupt("Body streaming") {
+  resp = Wreq.get(SLOW_BODY_URL)
+  begin
+    resp.chunks { |chunk| chunk }
+  rescue
+    nil
+  end
+}
+
+puts "=" * 40
+passed = results.count(:pass)
+puts "#{passed}/#{results.size} tests passed"
+exit(results.all?(:pass) ? 0 : 1)

data/extconf.rb

@@ -0,0 +1,7 @@
+require "mkmf"
+# We use rb_sys for makefile generation only.
+# We can use `RB_SYS_CARGO_PROFILE` to choose Cargo profile
+# Read more https://github.com/oxidize-rb/rb-sys/blob/main/gem/README.md
+require "rb_sys/mkmf"
+
+create_rust_makefile("wreq_ruby/wreq_ruby")

data/lib/wreq.rb

@@ -0,0 +1,313 @@
+# frozen_string_literal: true
+
+begin
+  RUBY_VERSION =~ /(\d+\.\d+)/
+  require_relative "wreq_ruby/#{$1}/wreq_ruby"
+rescue LoadError
+  require_relative "wreq_ruby/wreq_ruby"
+end
+
+# Load type hint definitions
+require_relative "wreq_ruby/http"
+require_relative "wreq_ruby/client"
+require_relative "wreq_ruby/response"
+require_relative "wreq_ruby/body"
+require_relative "wreq_ruby/header"
+require_relative "wreq_ruby/error"
+require_relative "wreq_ruby/cookie"
+
+unless defined?(Wreq)
+  module Wreq
+    VERSION = nil
+
+    # Send an HTTP request.
+    #
+    # @param method [Wreq::Method] HTTP method to use
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.request(method, url, **options)
+    end
+
+    # Send an HTTP GET request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.get(url, **options)
+    end
+
+    # Send an HTTP HEAD request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.head(url, **options)
+    end
+
+    # Send an HTTP POST request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.post(url, **options)
+    end
+
+    # Send an HTTP PUT request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.put(url, **options)
+    end
+
+    # Send an HTTP DELETE request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.delete(url, **options)
+    end
+
+    # Send an HTTP OPTIONS request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.options(url, **options)
+    end
+
+    # Send an HTTP TRACE request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.trace(url, **options)
+    end
+
+    # Send an HTTP PATCH request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+    # @param json [Object, nil] JSON body (will be serialized)
+    # @param body [String, IO, nil] Raw request body (string or stream)
+    # @param auth [String, nil] Authorization header value
+    # @param bearer_auth [String, nil] Bearer token for Authorization header
+    # @param basic_auth [Array<String>, nil] Username and password for basic auth
+    # @param cookies [Array<String>, nil] Cookies to send
+    # @param allow_redirects [Boolean, nil] Whether to follow redirects
+    # @param max_redirects [Integer, nil] Maximum number of redirects to follow
+    # @param gzip [Boolean, nil] Enable gzip compression
+    # @param brotli [Boolean, nil] Enable Brotli compression
+    # @param deflate [Boolean, nil] Enable deflate compression
+    # @param zstd [Boolean, nil] Enable Zstandard compression
+    # @param timeout [Integer, nil] Total request timeout (seconds)
+    # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
+    # @param proxy [String, nil] Proxy server URI
+    # @param no_proxy [Boolean, nil] Disable proxy for this request
+    # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+    # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
+    # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
+    # @param version [Wreq::Version, nil] HTTP version to use
+    # @return [Wreq::Response] HTTP response
+    def self.patch(url, **options)
+    end
+  end
+end

data/lib/wreq_ruby/body.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+unless defined?(Wreq)
+  module Wreq
+    # BodySender: for streaming request bodies, allowing thread-safe chunked data push.
+    # Backed by a Rust channel, avoids buffering the entire payload in memory.
+    #
+    # Supports multi-threaded chunk push: you can safely call `push` from multiple threads.
+    #
+    # Usage:
+    #   sender = Wreq::BodySender.new(8)
+    #   Thread.new do
+    #     File.open('big.bin', 'rb') { |f| while (chunk = f.read(65536)); sender.push(chunk); end }
+    #     sender.close
+    #   end
+    #   resp = client.post(url, body: sender)
+    #
+    # Note:
+    #   - Sender is for request upload only, not for response reading.
+    #   - Each BodySender instance can only be used once (single-use):
+    #     after being consumed by a request, further push or reuse is not allowed.
+    class BodySender
+      # @param capacity [Integer] channel buffer size, default 8
+      def self.new(capacity = 8)
+      end
+
+      # @param data [String] binary chunk
+      def push(data)
+      end
+
+      # Close the sender, signaling end of data.
+      def close
+      end
+    end
+  end
+end