Struct Container 

pub struct Container { /* private fields */ }

Type-map IoC service container.

Intended to be shared as Arc<Container> and mounted as an Axum Extension.

Example

use std::sync::Arc;
use rok_container::Container;

let container = Arc::new(Container::new());

// singleton — same Arc<T> returned every call
container.singleton(MyService::new());

// factory — fresh instance on every make()
container.bind::<Config>(|| Config::from_env());

// resolve
let svc: Arc<MyService> = container.make::<MyService>().unwrap();

Implementations

impl Container

pub fn new() -> Self

Create an empty container.

pub fn bind<T, F>(&self, factory: F)

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

Register a factory for T.

Every call to make::<T> invokes factory and returns a new Arc<T>.

pub fn singleton<T>(&self, instance: T)

where T: Any + Send + Sync + 'static,

Register a singleton instance for T.

Every call to make::<T> clones the same Arc<T>.

pub fn make<T>(&self) -> Result<Arc<T>, ContainerError>

where T: Any + Send + Sync + 'static,

Resolve T, returning Arc<T>.

Errors

Returns ContainerError::NotRegistered if T was never bound.

pub fn extend<T, F>(&self, extender: F) -> Result<(), ContainerError>

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

Decorate an existing singleton by transforming it.

Useful for wrapping a service with a decorator or logging layer.

Errors

Returns an error if T is not registered.

pub fn swap<T>(&self, instance: T)

where T: Any + Send + Sync + 'static,

Replace an existing binding with a new singleton.

Useful in tests to swap a real service for a test double.

Trait Implementations

impl Default for Container

fn default() -> Self

Returns the “default value” for a type.