Struct TestClient 

pub struct TestClient<H> { /* private fields */ }

Test client for in-process HTTP testing.

TestClient wraps a handler and provides an HTTP-like interface for testing without network overhead. It maintains a cookie jar for session persistence across requests.

Thread Safety

TestClient is thread-safe and can be shared across test threads. The internal cookie jar is protected by a mutex.

Example

let client = TestClient::new(my_handler);

// Simple GET request
let response = client.get("/users").send();
assert_eq!(response.status(), StatusCode::OK);

// POST with JSON body
let response = client
    .post("/users")
    .json(&CreateUser { name: "Alice" })
    .send();
assert_eq!(response.status(), StatusCode::CREATED);

// Request with headers
let response = client
    .get("/protected")
    .header("Authorization", "Bearer token123")
    .send();

Implementations

impl<H: Handler + 'static> TestClient<H>

pub fn new(handler: H) -> Self

Creates a new test client wrapping the given handler.

Example

let client = TestClient::new(my_handler);

pub fn with_seed(handler: H, seed: u64) -> Self

Creates a test client with a deterministic seed for the Lab runtime.

Using the same seed produces identical execution order for concurrent operations, enabling reproducible test failures.

Example

let client = TestClient::with_seed(my_handler, 42);

pub fn seed(&self) -> Option<u64>

Returns the seed used for deterministic testing, if set.

pub fn cookies(&self) -> MutexGuard<'_, CookieJar>

Returns a reference to the cookie jar.

Note: The jar is protected by a mutex, so concurrent access is safe but may block.

pub fn clear_cookies(&self)

Clears all cookies from the jar.

pub fn get(&self, path: &str) -> RequestBuilder<'_, H>

Creates a GET request builder.

pub fn post(&self, path: &str) -> RequestBuilder<'_, H>

Creates a POST request builder.

pub fn put(&self, path: &str) -> RequestBuilder<'_, H>

Creates a PUT request builder.

pub fn delete(&self, path: &str) -> RequestBuilder<'_, H>

Creates a DELETE request builder.

pub fn patch(&self, path: &str) -> RequestBuilder<'_, H>

Creates a PATCH request builder.

pub fn options(&self, path: &str) -> RequestBuilder<'_, H>

Creates an OPTIONS request builder.

pub fn head(&self, path: &str) -> RequestBuilder<'_, H>

Creates a HEAD request builder.

pub fn request(&self, method: Method, path: &str) -> RequestBuilder<'_, H>

Creates a request builder with a custom method.

pub fn override_dependency<T, F, Fut>(&self, f: F)

where T: FromDependency, F: Fn(&RequestContext, &mut Request) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<T, T::Error>> + Send + 'static,

Register a dependency override for this test client.

pub fn override_dependency_value<T>(&self, value: T)

where T: FromDependency,

Register a fixed dependency override value.

pub fn clear_dependency_overrides(&self)

Clear all registered dependency overrides.

Trait Implementations

impl<H> Clone for TestClient<H>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.