Struct TestApp 

pub struct TestApp { /* private fields */ }

In-memory test application backed by an Axum router.

TestApp drives requests through the router with Tower’s in-memory service path, so no TCP listener is started. Use it for handler, middleware, module, and provider integration tests.

use axum::{Json, Router, routing::get};
use http::StatusCode;
use nidus_testing::TestApp;
use serde_json::json;

async fn health() -> Json<serde_json::Value> {
    Json(json!({ "ok": true }))
}

#[tokio::test]
async fn health_returns_json() {
    let app = TestApp::from_router(
        Router::new().route("/health", get(health)),
    );

    let response = app.get("/health").send().await;
    response.assert_status(StatusCode::OK);
    response.assert_json(json!({ "ok": true }));
}

Implementations

impl TestApp

pub fn bootstrap<M>() -> Result<TestAppBuilder>

where M: Module,

Creates a test application builder after validating a root Nidus module.

pub fn bootstrap_with_router<M>(router: Router) -> Result<TestAppBuilder>

where M: Module,

Creates a test application builder with a router after validating a root Nidus module.

pub fn bootstrap_with_modules<M, I>(modules: I) -> Result<TestAppBuilder>

where M: Module, I: IntoIterator<Item = ModuleDefinition>,

Creates a test application builder after validating an explicit module graph.

pub fn bootstrap_with_modules_and_router<M, I>( modules: I, router: Router, ) -> Result<TestAppBuilder>

where M: Module, I: IntoIterator<Item = ModuleDefinition>,

Creates a test application builder with a router after validating an explicit module graph.

pub fn from_router(router: Router) -> Self

Creates a test application from an Axum router.

This is the shortest path for HTTP-only tests. It installs an empty Nidus container extension so handlers that need the container can still extract it.

pub fn builder(router: Router) -> TestAppBuilder

Creates a configurable test application builder.

pub fn get(&self, path: impl Into<String>) -> TestRequest

Starts a GET request.

pub fn post(&self, path: impl Into<String>) -> TestRequest

Starts a POST request.

pub fn put(&self, path: impl Into<String>) -> TestRequest

Starts a PUT request.

pub fn patch(&self, path: impl Into<String>) -> TestRequest

Starts a PATCH request.

pub fn delete(&self, path: impl Into<String>) -> TestRequest

Starts a DELETE request.

pub fn request(&self, method: Method, path: impl Into<String>) -> TestRequest

Starts a request with an arbitrary HTTP method.

The returned TestRequest can set headers, query parameters, and body content before TestRequest::send executes it against the in-memory router.

pub fn resolve<T>(&self) -> Result<Arc<T>>

where T: Send + Sync + 'static,

Resolves a provider from the test container.

pub fn request_scope(&self) -> RequestScope<'_>

Creates a request scope for resolving request-lifetime providers in tests.

pub fn config(&self) -> &Config

Returns test configuration overrides.

pub async fn shutdown(&self) -> Result<()>

Runs registered test shutdown lifecycle hooks.

Trait Implementations

impl Clone for TestApp

fn clone(&self) -> TestApp

Returns a duplicate of the value.

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

Performs copy-assignment from source.