Merge branch 'main' into emulate

Author: 0x676e67

.gitignore

@@ -15,3 +15,4 @@ Gemfile.lock
 vendor/
 .vscode
 .zed
+test.rb

Cargo.lock

@@ -41,7 +41,7 @@ require "wreq"
 
 # Build a client
 client = Wreq::Client.new(emulation: Wreq::Emulation.new(
-  profile: Wreq::Profile::Chrome147,
+  profile: Wreq::Profile::Chrome148,
   platform: Wreq::Platform::MacOS,
   http2: true,
   headers: true

README.md

@@ -24,7 +24,7 @@ module Wreq
     #
     # @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 headers [Wreq::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
@@ -55,7 +55,7 @@ def self.request(method, url, **options)
     # Send an HTTP GET request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -86,7 +86,7 @@ def self.get(url, **options)
     # Send an HTTP HEAD request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -117,7 +117,7 @@ def self.head(url, **options)
     # Send an HTTP POST request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -148,7 +148,7 @@ def self.post(url, **options)
     # Send an HTTP PUT request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -179,7 +179,7 @@ def self.put(url, **options)
     # Send an HTTP DELETE request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -210,7 +210,7 @@ def self.delete(url, **options)
     # Send an HTTP OPTIONS request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -241,7 +241,7 @@ def self.options(url, **options)
     # Send an HTTP TRACE request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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
@@ -272,7 +272,7 @@ def self.trace(url, **options)
     # Send an HTTP PATCH request.
     #
     # @param url [String] Target URL
-    # @param headers [Hash{String=>String}, nil] Custom headers for this request
+    # @param headers [Wreq::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

lib/wreq.rb

@@ -35,7 +35,7 @@ class Client
       # @param user_agent [String, nil] Custom User-Agent header value.
       #   If not specified, a default user agent will be used.
       #
-      # @param headers [Hash{String=>String}, nil] Default headers to include
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Default headers to include
       #   in every request. Header names are case-insensitive. These headers
       #   can be overridden on a per-request basis.
       #
@@ -236,7 +236,7 @@ def self.new(**options)
       #
       # @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 headers [Wreq::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
@@ -267,7 +267,7 @@ def request(method, url, **options)
       # Send an HTTP GET request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -298,7 +298,7 @@ def get(url, **options)
       # Send an HTTP HEAD request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -329,7 +329,7 @@ def head(url, **options)
       # Send an HTTP POST request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -360,7 +360,7 @@ def post(url, **options)
       # Send an HTTP PUT request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -391,7 +391,7 @@ def put(url, **options)
       # Send an HTTP DELETE request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -422,7 +422,7 @@ def delete(url, **options)
       # Send an HTTP OPTIONS request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -453,7 +453,7 @@ def options(url, **options)
       # Send an HTTP TRACE request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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
@@ -484,7 +484,7 @@ def trace(url, **options)
       # Send an HTTP PATCH request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
+      # @param headers [Wreq::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

lib/wreq_ruby/client.rb

@@ -56,6 +56,7 @@ class Profile
       Chrome145 = nil
       Chrome146 = nil
       Chrome147 = nil
+      Chrome148 = nil
 
       Edge101 = nil
       Edge122 = nil
@@ -75,6 +76,7 @@ class Profile
       Edge145 = nil
       Edge146 = nil
       Edge147 = nil
+      Edge148 = nil
 
       Firefox109 = nil
       Firefox117 = nil
@@ -94,6 +96,8 @@ class Profile
       Firefox147 = nil
       Firefox148 = nil
       Firefox149 = nil
+      Firefox150 = nil
+      Firefox151 = nil
 
       SafariIos17_2 = nil
       SafariIos17_4_1 = nil
@@ -118,6 +122,8 @@ class Profile
       Safari26 = nil
       Safari26_1 = nil
       Safari26_2 = nil
+      Safari26_3 = nil
+      Safari26_4 = nil
       SafariIos26 = nil
       SafariIos26_2 = nil
       SafariIPad26 = nil
@@ -147,6 +153,7 @@ class Profile
       Opera128 = nil
       Opera129 = nil
       Opera130 = nil
+      Opera131 = nils
     end
 
     unless method_defined?(:to_s)

lib/wreq_ruby/emulate.rb

@@ -110,14 +110,17 @@ def text(default_encoding: "UTF-8")
       def json
       end
 
-      # Get a streaming iterator for the response body, yielding each chunk.
+      # Stream the response body, yielding each chunk to the given block.
       #
       # This method allows you to process large HTTP responses efficiently,
       # by yielding each chunk of the body as it arrives, without loading
       # the entire response into memory.
       #
-      # @return An iterator over response body chunks (binary String)
+      # @return [nil]
       # @yield [chunk] Each chunk of the response body as a binary String
+      # @raise [LocalJumpError] if called without a block
+      # @raise [Wreq::TimeoutError, Wreq::BodyError, Wreq::ConnectionResetError, Wreq::RequestError]
+      #   if streaming fails while reading the response body
       # @example Save response to file
       #   File.open("output.bin", "wb") do |f|
       #     response.chunks { |chunk| f.write(chunk) }
@@ -127,7 +130,7 @@ def json
       #   response.chunks { |chunk| total += chunk.bytesize }
       #   puts "Downloaded #{total} bytes"
       #
-      # Note: The returned Receiver is only for reading response bodies, not for uploads.
+      # Exceptions raised inside the block are propagated to the caller.
       def chunks
       end