feat(client): accept sub-second timeouts

lib/wreq.rb

@@ -9,6 +9,7 @@
 
 # Load type hint definitions
 require_relative "wreq_ruby/http"
+require_relative "wreq_ruby/emulate"
 require_relative "wreq_ruby/client"
 require_relative "wreq_ruby/response"
 require_relative "wreq_ruby/body"
@@ -50,8 +51,12 @@ module Wreq
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -83,8 +88,12 @@ def self.request(method, url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -116,8 +125,12 @@ def self.get(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -149,8 +162,12 @@ def self.head(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -182,8 +199,12 @@ def self.post(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -215,8 +236,12 @@ def self.put(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -248,8 +273,12 @@ def self.delete(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -281,8 +310,12 @@ def self.options(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.
@@ -314,8 +347,12 @@ def self.trace(url, **options)
     # @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 timeout [Numeric, nil] Total request timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
+    # @param read_timeout [Numeric, nil] Per-chunk read timeout in seconds.
+    #   Must be finite and non-negative; fractions are accepted, 0 expires
+    #   immediately, and nil leaves it unset.
     # @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 to an interface on supported platforms; unsupported platforms raise ArgumentError.