wreq 1.2.4 → 1.2.5

data/crates/wreq-util/tests/support/mod.rs

@@ -0,0 +1,55 @@
+#![allow(dead_code)]
+pub mod server;
+
+use std::{sync::LazyLock, time::Duration};
+
+use tokio::sync::Semaphore;
+use wreq::Client;
+
+// TODO: remove once done converting to new support server?
+#[allow(unused)]
+pub static DEFAULT_USER_AGENT: &str =
+    concat!(env!("CARGO_PKG_NAME"), "/", env!("CARGO_PKG_VERSION"));
+
+pub static TEST_SEMAPHORE: LazyLock<Semaphore> = LazyLock::new(|| Semaphore::new(1));
+
+pub static CLIENT: LazyLock<Client> = LazyLock::new(|| {
+    Client::builder()
+        .connect_timeout(Duration::from_secs(60))
+        .build()
+        .unwrap()
+});
+
+#[allow(unused_macros)]
+macro_rules! test_emulation {
+    ($test_name:ident, $emulation:expr, $ja4:expr, $akamai_hash:expr) => {
+        #[tokio::test]
+        async fn $test_name() {
+            let _permit = crate::support::TEST_SEMAPHORE.acquire().await.unwrap();
+
+            let resp = crate::support::CLIENT
+                .get("https://tls.browserleaks.com/")
+                .emulation($emulation)
+                .send()
+                .await
+                .unwrap();
+
+            assert_eq!(resp.status(), wreq::StatusCode::OK);
+            let content = resp.text().await.unwrap();
+
+            let conditional = $ja4.iter().any(|&ja4| content.contains(ja4));
+            if !conditional {
+                println!("{}", content);
+            }
+            assert!(conditional);
+
+            let conditional = content.contains($akamai_hash);
+            if !conditional {
+                println!("{}", content);
+            }
+            assert!(conditional);
+
+            tokio::time::sleep(std::time::Duration::from_millis(1000)).await;
+        }
+    };
+}

data/crates/wreq-util/tests/support/server.rs

@@ -0,0 +1,232 @@
+#![cfg(not(target_arch = "wasm32"))]
+use std::{
+    convert::Infallible, future::Future, net, sync::mpsc as std_mpsc, thread, time::Duration,
+};
+
+use tokio::{io::AsyncReadExt, net::TcpStream, runtime, sync::oneshot};
+
+pub struct Server {
+    addr: net::SocketAddr,
+    panic_rx: std_mpsc::Receiver<()>,
+    events_rx: std_mpsc::Receiver<Event>,
+    shutdown_tx: Option<oneshot::Sender<()>>,
+}
+
+#[non_exhaustive]
+pub enum Event {
+    ConnectionClosed,
+}
+
+impl Server {
+    pub fn addr(&self) -> net::SocketAddr {
+        self.addr
+    }
+
+    #[allow(unused)]
+    pub fn events(&mut self) -> Vec<Event> {
+        let mut events = Vec::new();
+        while let Ok(event) = self.events_rx.try_recv() {
+            events.push(event);
+        }
+        events
+    }
+}
+
+impl Drop for Server {
+    fn drop(&mut self) {
+        if let Some(tx) = self.shutdown_tx.take() {
+            let _ = tx.send(());
+        }
+
+        if !::std::thread::panicking() {
+            self.panic_rx
+                .recv_timeout(Duration::from_secs(3))
+                .expect("test server should not panic");
+        }
+    }
+}
+
+pub fn http<F, Fut>(func: F) -> Server
+where
+    F: Fn(http::Request<hyper::body::Incoming>) -> Fut + Clone + Send + 'static,
+    Fut: Future<Output = http::Response<wreq::Body>> + Send + 'static,
+{
+    http_with_config(func, |_builder| {})
+}
+
+type Builder = hyper_util::server::conn::auto::Builder<hyper_util::rt::TokioExecutor>;
+
+pub fn http_with_config<F1, Fut, F2, Bu>(func: F1, apply_config: F2) -> Server
+where
+    F1: Fn(http::Request<hyper::body::Incoming>) -> Fut + Clone + Send + 'static,
+    Fut: Future<Output = http::Response<wreq::Body>> + Send + 'static,
+    F2: FnOnce(&mut Builder) -> Bu + Send + 'static,
+{
+    // Spawn new runtime in thread to prevent reactor execution context conflict
+    let test_name = thread::current().name().unwrap_or("<unknown>").to_string();
+    thread::spawn(move || {
+        let rt = runtime::Builder::new_current_thread()
+            .enable_all()
+            .build()
+            .expect("new rt");
+        let listener = rt.block_on(async move {
+            tokio::net::TcpListener::bind(&std::net::SocketAddr::from(([127, 0, 0, 1], 0)))
+                .await
+                .unwrap()
+        });
+        let addr = listener.local_addr().unwrap();
+
+        let (shutdown_tx, mut shutdown_rx) = oneshot::channel();
+        let (panic_tx, panic_rx) = std_mpsc::channel();
+        let (events_tx, events_rx) = std_mpsc::channel();
+        let tname = format!(
+            "test({})-support-server",
+            test_name,
+        );
+        thread::Builder::new()
+            .name(tname)
+            .spawn(move || {
+                rt.block_on(async move {
+                    let mut builder =
+                        hyper_util::server::conn::auto::Builder::new(hyper_util::rt::TokioExecutor::new());
+                    apply_config(&mut builder);
+
+                    loop {
+                        tokio::select! {
+                            _ = &mut shutdown_rx => {
+                                break;
+                            }
+                            accepted = listener.accept() => {
+                                let (io, _) = accepted.expect("accepted");
+                                let func = func.clone();
+                                let svc = hyper::service::service_fn(move |req| {
+                                    let fut = func(req);
+                                    async move { Ok::<_, Infallible>(fut.await) }
+                                });
+                                let builder = builder.clone();
+                                let events_tx = events_tx.clone();
+                                tokio::spawn(async move {
+                                    let _ = builder.serve_connection_with_upgrades(hyper_util::rt::TokioIo::new(io), svc).await;
+                                    let _ = events_tx.send(Event::ConnectionClosed);
+                                });
+                            }
+                        }
+                    }
+                    let _ = panic_tx.send(());
+                });
+            })
+            .expect("thread spawn");
+        Server {
+            addr,
+            panic_rx,
+            events_rx,
+            shutdown_tx: Some(shutdown_tx),
+        }
+    })
+    .join()
+    .unwrap()
+}
+
+#[allow(unused)]
+pub fn low_level_with_response<F>(do_response: F) -> Server
+where
+    for<'c> F: Fn(&'c [u8], &'c mut TcpStream) -> Box<dyn Future<Output = ()> + Send + 'c>
+        + Clone
+        + Send
+        + 'static,
+{
+    // Spawn new runtime in thread to prevent reactor execution context conflict
+    let test_name = thread::current().name().unwrap_or("<unknown>").to_string();
+    thread::spawn(move || {
+        let rt = runtime::Builder::new_current_thread()
+            .enable_all()
+            .build()
+            .expect("new rt");
+        let listener = rt.block_on(async move {
+            tokio::net::TcpListener::bind(&std::net::SocketAddr::from(([127, 0, 0, 1], 0)))
+                .await
+                .unwrap()
+        });
+        let addr = listener.local_addr().unwrap();
+
+        let (shutdown_tx, mut shutdown_rx) = oneshot::channel();
+        let (panic_tx, panic_rx) = std_mpsc::channel();
+        let (events_tx, events_rx) = std_mpsc::channel();
+        let tname = format!("test({})-support-server", test_name,);
+        thread::Builder::new()
+            .name(tname)
+            .spawn(move || {
+                rt.block_on(async move {
+                    loop {
+                        tokio::select! {
+                            _ = &mut shutdown_rx => {
+                                break;
+                            }
+                            accepted = listener.accept() => {
+                                let (io, _) = accepted.expect("accepted");
+                                let do_response = do_response.clone();
+                                let events_tx = events_tx.clone();
+                                tokio::spawn(async move {
+                                    low_level_server_client(io, do_response).await;
+                                    let _ = events_tx.send(Event::ConnectionClosed);
+                                });
+                            }
+                        }
+                    }
+                    let _ = panic_tx.send(());
+                });
+            })
+            .expect("thread spawn");
+        Server {
+            addr,
+            panic_rx,
+            events_rx,
+            shutdown_tx: Some(shutdown_tx),
+        }
+    })
+    .join()
+    .unwrap()
+}
+
+#[allow(unused)]
+async fn low_level_server_client<F>(mut client_socket: TcpStream, do_response: F)
+where
+    for<'c> F: Fn(&'c [u8], &'c mut TcpStream) -> Box<dyn Future<Output = ()> + Send + 'c>,
+{
+    loop {
+        let request = low_level_read_http_request(&mut client_socket)
+            .await
+            .expect("read_http_request failed");
+        if request.is_empty() {
+            // connection closed by client
+            break;
+        }
+
+        Box::into_pin(do_response(&request, &mut client_socket)).await;
+    }
+}
+
+#[allow(unused)]
+async fn low_level_read_http_request(
+    client_socket: &mut TcpStream,
+) -> core::result::Result<Vec<u8>, std::io::Error> {
+    let mut buf = Vec::new();
+
+    // Read until the delimiter "\r\n\r\n" is found
+    loop {
+        let mut temp_buffer = [0; 1024];
+        let n = client_socket.read(&mut temp_buffer).await?;
+
+        if n == 0 {
+            break;
+        }
+
+        buf.extend_from_slice(&temp_buffer[..n]);
+
+        if let Some(pos) = buf.windows(4).position(|window| window == b"\r\n\r\n") {
+            return Ok(buf.drain(..pos + 4).collect());
+        }
+    }
+
+    Ok(buf)
+}

data/examples/emulate_request.rb

@@ -11,7 +11,7 @@ require_relative "../lib/wreq"
 #   Set when creating the Wreq::Client instance.
 #   All requests from this client will use the specified emulation unless overridden.
 client = Wreq::Client.new(emulation: Wreq::Emulation.new(
-  profile: Wreq::Profile::Chrome149,
+  profile: Wreq::Profile::Chrome150,
   platform: Wreq::Platform::MacOS,
   http2: true,
   headers: true

data/lib/wreq.rb

@@ -18,6 +18,8 @@ require_relative "wreq_ruby/cookie"
 
 unless defined?(Wreq)
   module Wreq
+    # Current wreq gem version.
+    # @return [String]
     VERSION = nil
 
     # Send an HTTP request.
@@ -26,7 +28,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -47,7 +49,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.request(method, url, **options)
     end
@@ -57,7 +59,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -78,7 +80,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.get(url, **options)
     end
@@ -88,7 +90,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -109,7 +111,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.head(url, **options)
     end
@@ -119,7 +121,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -140,7 +142,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.post(url, **options)
     end
@@ -150,7 +152,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -171,7 +173,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.put(url, **options)
     end
@@ -181,7 +183,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -202,7 +204,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.delete(url, **options)
     end
@@ -212,7 +214,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -233,7 +235,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.options(url, **options)
     end
@@ -243,7 +245,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -264,7 +266,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.trace(url, **options)
     end
@@ -274,7 +276,7 @@ unless defined?(Wreq)
     # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
     # @param query [Hash, nil] URL query parameters
     # @param auth [String, nil] Authorization header value
     # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -295,7 +297,7 @@ unless defined?(Wreq)
     # @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)
+    # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
     # @return [Wreq::Response] HTTP response
     def self.patch(url, **options)
     end

data/lib/wreq_ruby/body.rb

@@ -21,14 +21,17 @@ unless defined?(Wreq)
     #     after being consumed by a request, further push or reuse is not allowed.
     class BodySender
       # @param capacity [Integer] channel buffer size, default 8
+      # @return [Wreq::BodySender] A streaming request body sender
       def self.new(capacity = 8)
       end
 
       # @param data [String] binary chunk
+      # @return [void]
       def push(data)
       end
 
       # Close the sender, signaling end of data.
+      # @return [void]
       def close
       end
     end

data/lib/wreq_ruby/client.rb

@@ -240,7 +240,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -261,7 +261,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def request(method, url, **options)
       end
@@ -271,7 +271,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -292,7 +292,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def get(url, **options)
       end
@@ -302,7 +302,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -323,7 +323,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def head(url, **options)
       end
@@ -333,7 +333,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -354,7 +354,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def post(url, **options)
       end
@@ -364,7 +364,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -385,7 +385,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def put(url, **options)
       end
@@ -395,7 +395,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -416,7 +416,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def delete(url, **options)
       end
@@ -426,7 +426,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -447,7 +447,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def options(url, **options)
       end
@@ -457,7 +457,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -478,7 +478,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def trace(url, **options)
       end
@@ -488,7 +488,7 @@ unless defined?(Wreq)
       # @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 default_headers [Boolean, nil] Whether to apply default emulation headers
       # @param query [Hash, nil] URL query parameters
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
@@ -509,7 +509,7 @@ unless defined?(Wreq)
       # @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)
+      # @param body [String, Wreq::BodySender, nil] Request body bytes or streaming body sender
       # @return [Wreq::Response] HTTP response
       def patch(url, **options)
       end

data/lib/wreq_ruby/cookie.rb

@@ -4,9 +4,9 @@ unless defined?(Wreq)
     #
     # Values follow the Rust enum exposed by the native extension.
     class SameSite
-      # Lax same-site policy.
-      Strict = nil
       # Strict same-site policy.
+      Strict = nil
+      # Lax same-site policy.
       Lax = nil
       # None same-site policy.
       None = nil