wreq 1.2.3-x64-mingw-ucrt

data/lib/wreq.rb

@@ -0,0 +1,303 @@
+# 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 [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.request(method, url, **options)
+    end
+
+    # Send an HTTP GET request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.get(url, **options)
+    end
+
+    # Send an HTTP HEAD request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.head(url, **options)
+    end
+
+    # Send an HTTP POST request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.post(url, **options)
+    end
+
+    # Send an HTTP PUT request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.put(url, **options)
+    end
+
+    # Send an HTTP DELETE request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.delete(url, **options)
+    end
+
+    # Send an HTTP OPTIONS request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.options(url, **options)
+    end
+
+    # Send an HTTP TRACE request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @return [Wreq::Response] HTTP response
+    def self.trace(url, **options)
+    end
+
+    # Send an HTTP PATCH request.
+    #
+    # @param url [String] Target URL
+    # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+    # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
+    # @param default_headers [Hash{String=>String}, nil] Default headers to merge
+    # @param query [Hash, nil] URL query parameters
+    # @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 [Hash{String=>String}, 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 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
+    # @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)
+    # @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