Struct Container 

pub struct Container { /* private fields */ }

Dependency injection container

Stores services as Arc-wrapped values and provides type-safe retrieval. Services are singletons - only one instance exists per type.

Example

let mut container = Container::new();
container.register(Arc::new(DatabaseService::new()));

let db: Arc<DatabaseService> = container.resolve().unwrap();

Implementations

impl Container

pub fn new() -> Self

Create a new empty container

pub fn register<T: Injectable>(&mut self, service: Arc<T>)

Register a service in the container

The service must be wrapped in an Arc. If a service of this type already exists, it will be replaced.

Example

container.register(Arc::new(MyService::new()));

pub fn register_factory<T: Injectable, F>(&mut self, factory: F)

where F: FnOnce() -> T,

Register a service from a constructor function

This is a convenience method that creates the Arc for you.

Example

container.register_factory(|| MyService::new());

pub async fn register_async_factory<T, F, Fut>( &mut self, factory: F, ) -> Result<()>

where T: Injectable, F: FnOnce() -> Fut, Fut: Future<Output = Result<T>>,

Register a service from an async constructor function.

Use this for services that require async initialization — database connections, config loading from remote sources, etc. The async effect is contained here; once registered, the service is a plain Arc<T> and all subsequent framework operations remain synchronous.

Returns Err if the factory future resolves to an error.

Example

container
    .register_async_factory(|| async {
        let db = Database::connect("postgres://localhost/mydb").await?;
        Ok(DbService::new(db))
    })
    .await?;

pub fn resolve<T: Injectable>(&self) -> Option<Arc<T>>

Resolve a service from the container

Returns None if the service hasn’t been registered.

Example

let service: Arc<MyService> = container.resolve().unwrap();

pub fn resolve_or_panic<T: Injectable>(&self) -> Arc<T>

Resolve a service or panic if not found

Panics

Panics if the service hasn’t been registered.

pub fn contains<T: Injectable>(&self) -> bool

Check if a service is registered

pub fn len(&self) -> usize

Get the number of registered services

pub fn is_empty(&self) -> bool

Check if the container is empty

pub fn clear(&mut self)

Clear all services from the container

Trait Implementations

impl Clone for Container

fn clone(&self) -> Container

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Container

fn default() -> Container

Returns the “default value” for a type.