Struct TestApp 

pub struct TestApp { /* private fields */ }

A booted application, ready to be asked for responses.

Not Send: it holds a thread-local facade scope, and moving it to another thread would unscope on one and pop on another.

Implementations

impl TestApp

pub fn new(app: Arc<Application>) -> Result<Self>

Wrap an application your own boot produced.

Takes the booted application rather than booting one, because what a test wants exercised is your bootstrap — its providers, its configuration, its routes — not a generic one this crate could build.

pub fn app(&self) -> &Arc<Application>

The application, for resolving a service to assert on.

pub fn resolve<T: Send + Sync + 'static>(&self) -> Result<Arc<T>>

Resolve a service — app.resolve::<PostRepository>()?.

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

Send this header on every subsequent request.

let app = app.with_header("authorization", format!("Bearer {token}"));

pub fn with_token(self, token: impl Display) -> Self

Authenticate every subsequent request with a bearer token.

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

GET uri.

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

DELETE uri.

pub async fn post(&self, uri: &str, body: &impl Serialize) -> TestResponse

POST uri with a JSON body.

pub async fn put(&self, uri: &str, body: &impl Serialize) -> TestResponse

PUT uri with a JSON body.

pub async fn patch(&self, uri: &str, body: &impl Serialize) -> TestResponse

PATCH uri with a JSON body.

pub async fn post_empty(&self, uri: &str) -> TestResponse

POST uri with no body — a form action, a publish, a logout.

pub fn request(&self, method: Method, uri: &str) -> RequestBuilder

A request builder carrying this harness’s default headers.

For the request the helpers above do not cover — a form encoding, an odd header, a deliberately malformed body.

pub async fn send(&self, request: Request) -> TestResponse

Send a request you built yourself, through the whole kernel.

The real pipeline: global middleware, routing, route middleware, the handler, and the exception renderer. A test that bypassed it would be asserting on something no client can reach.