Struct TestContainer 

pub struct TestContainer;

Test utilities for the container

Provides methods to set up isolated test containers with fake implementations. Test containers use thread-local storage, so tests run in parallel won’t interfere.

Implementations

impl TestContainer

pub fn fake() -> TestContainerGuard

Set up a test container with overrides

Returns a guard that clears the test container when dropped. This ensures test isolation - each test gets a fresh container.

Example

#[tokio::test]
async fn my_test() {
    let _guard = TestContainer::fake();
    // Register fakes...
} // Container automatically cleared here

pub fn singleton<T: Any + Send + Sync + 'static>(instance: T)

Register a fake singleton for testing

Example

TestContainer::singleton(FakeDatabase::new());

pub fn factory<T, F>(factory: F)

where T: Any + Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

Register a fake factory for testing

Example

TestContainer::factory(|| FakeLogger::new());

pub fn bind<T: ?Sized + Send + Sync + 'static>(instance: Arc<T>)

Bind a fake trait implementation for testing

Example

TestContainer::bind::<dyn HttpClient>(Arc::new(FakeHttpClient::new()));

pub fn bind_factory<T: ?Sized + Send + Sync + 'static, F>(factory: F)

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

Bind a fake trait factory for testing

Example

TestContainer::bind_factory::<dyn HttpClient>(|| Arc::new(FakeHttpClient::new()));