Struct TestAppBuilder 

pub struct TestAppBuilder { /* private fields */ }

Builder for in-memory test applications.

Use the builder when tests need provider overrides, request-scoped providers, config overrides, or lifecycle hooks in addition to an Axum router.

Implementations

impl TestAppBuilder

pub fn provider<T>(self, value: T) -> Result<Self>

where T: Send + Sync + 'static,

Registers a provider in the test container.

pub fn transient_provider<T, F>(self, factory: F) -> Result<Self>

where T: Send + Sync + 'static, F: Fn(&Container) -> Result<T> + Send + Sync + 'static,

Registers a transient provider factory in the test container.

pub fn request_provider<T, F>(self, factory: F) -> Result<Self>

where T: Send + Sync + 'static, F: Fn(&Container) -> Result<T> + Send + Sync + 'static,

Registers a request-lifetime provider factory in the test container.

pub fn request_scoped_provider<T, F>(self, factory: F) -> Result<Self>

where T: Send + Sync + 'static, F: for<'scope> Fn(&RequestScope<'scope>) -> Result<T> + Send + Sync + 'static,

Registers a request-lifetime provider factory that resolves dependencies through the active request scope.

This matches production request-scoped resolution. To exercise RequestScoped<T> extractors over HTTP in the test app, also call TestAppBuilder::with_request_scope so the request scope layer is installed on the router.

pub fn with_request_scope(self) -> Self

Installs the production request scope layer so RequestScoped<T> extractors resolve during HTTP integration tests.

Without this, handlers that extract RequestScoped<T> reject with 500/request_scope_unavailable. Register request providers with Self::request_provider or Self::request_scoped_provider first.

pub fn override_provider<T>(self, value: T) -> Result<Self>

where T: Send + Sync + 'static,

Overrides a provider in the test container.

pub fn config(self, config: Config) -> Self

Sets configuration overrides for the test application.

pub fn lifecycle_hook<H>(self, hook: H) -> Self

where H: LifecycleHook,

Registers a lifecycle hook for the test application.

pub fn build(self) -> TestApp

Builds the test application.

pub async fn build_started(self) -> Result<TestApp>

Runs startup hooks and builds the test application.