Struct TestClient 

pub struct TestClient { /* private fields */ }

Fluent HTTP client for integration tests.

Analogous to Spring Boot’s MockMvc or Django’s Client. Fires requests through the full Axum middleware pipeline using tower::ServiceExt::oneshot() – no TCP listener required.

Created by TestApp::build().

Examples

let client = TestApp::new().routes(routes![handler]).build();

// GET request
client.get("/path").send().await.assert_ok();

// POST with JSON body
client.post("/items")
    .json(&serde_json::json!({"name": "foo"}))
    .send().await
    .assert_status(201);

// PUT with header
client.put("/items/1")
    .header("authorization", "Bearer token")
    .json(&serde_json::json!({"name": "bar"}))
    .send().await
    .assert_ok();

Implementations

impl TestClient

pub const fn state(&self) -> &AppState

Returns a reference to the AppState wired into this test app’s router.

pub fn advance_clock(&self, duration: Duration)

Step the test clock forward by duration.

Only effective when the app was configured with a crate::time::TickingClock via TestApp::with_clock. Calling this with a crate::time::FixedClock or without any custom clock is a safe no-op — time stays where it is.

This method only affects the wall-clock time reported by the crate::time::Clock extractor. Tokio’s runtime timer (used by tokio::time::sleep, tokio::time::Instant, etc.) is not affected.

use autumn_web::test::TestApp;
use autumn_web::time::TickingClock;
use chrono::{TimeZone, Utc};
use std::time::Duration;

let clock = TickingClock::starting_at(Utc.with_ymd_and_hms(2025, 1, 1, 0, 0, 0).unwrap());
let client = TestApp::new().with_clock(clock).build();

client.advance_clock(Duration::from_secs(86400)); // advance 1 day

pub fn into_router(self) -> Router

Unwrap the underlying axum::Router out of the TestClient.

pub const fn probes(&self) -> &ProbeState

Return the crate::probe::ProbeState wired into this test app’s router.

Use this to drive readiness/liveness transitions in integration tests and verify the HTTP probe endpoints reflect state changes.

pub fn get(&self, uri: &str) -> RequestBuilder

Start building a GET request.

pub fn post(&self, uri: &str) -> RequestBuilder

Start building a POST request.

pub fn put(&self, uri: &str) -> RequestBuilder

Start building a PUT request.

pub fn delete(&self, uri: &str) -> RequestBuilder

Start building a DELETE request.

pub fn patch(&self, uri: &str) -> RequestBuilder

Start building a PATCH request.

pub fn options(&self, uri: &str) -> RequestBuilder

Start building an OPTIONS request (e.g. a CORS preflight).