Struct RequestBuilder 

pub struct RequestBuilder<'a, H> { /* private fields */ }

Builder for constructing test requests with a fluent API.

Use the methods on TestClient to create a request builder, then chain configuration methods and call send to execute.

Example

let response = client
    .post("/api/items")
    .header("Content-Type", "application/json")
    .body(r#"{"name": "Widget"}"#)
    .send();

Implementations

impl<'a, H: Handler + 'static> RequestBuilder<'a, H>

pub fn query(self, key: &str, value: &str) -> Self

Sets a query string parameter.

Multiple calls append parameters.

Example

client.get("/search").query("q", "rust").query("limit", "10").send()

pub fn header(self, name: impl Into<String>, value: impl Into<Vec<u8>>) -> Self

Sets a request header.

Example

client.get("/api").header("Authorization", "Bearer token").send()

pub fn header_str(self, name: impl Into<String>, value: &str) -> Self

Sets a request header with a string value.

pub fn body(self, body: impl Into<Vec<u8>>) -> Self

Sets the request body as raw bytes.

Example

client.post("/upload").body(b"binary data".to_vec()).send()

pub fn body_str(self, body: &str) -> Self

Sets the request body as a string.

pub fn json<T: Serialize>(self, value: &T) -> Self

Sets the request body as JSON.

Automatically sets the Content-Type header to application/json.

Example

#[derive(Serialize)]
struct CreateUser { name: String }

client.post("/users").json(&CreateUser { name: "Alice".into() }).send()

pub fn cookie(self, name: &str, value: &str) -> Self

Sets a cookie for this request only.

This does not affect the client’s cookie jar.

pub fn send(self) -> TestResponse

Sends the request and returns the response.

Example

let response = client.get("/").send();