Crate portaldi

PortalDI is an ergonomic, lightweight and compile-time dependency injection library.

Features

• Natively async support

  • Support for asynchronous component creation.
  • Components and traits must be thread-safe (Sync + Send) in non Wasm target.

• Ergonomic apis

  • In most cases, you can use target types directly instead of using containers.

  // for a concrete type.
  let hoge: DI<HogeService> = HogeService::di();
  
  // for a trait. (through DIProvider)
  let hoge: DI<dyn HogeService> = HogeServiceProvider::di();

• DRY support by macros

  • Almost boiler codes can be generated by proc macros.

  #[derive(DIPortal)]
  struct HogeService {
    foo: DI<FooService>,
    ...,
  }

Modules

docs

Macros

def_async_di_provider

Generate a [AsyncDIProvider] implementation.

def_di_provider

Generate a [DIProvider] implementation.

di

Generate a di method call with a target provider type name.

Structs

DIContainer

DI container holds component refs.

Tagged

Tagged type.

Traits

AsyncDIPortal

Add di methods for DI target types that needs async creation.

AsyncDIProvider

Provides component instance for trait DI types that needs async creation.

DIPortal

Add di methods for DI target types.

DIProvider

Provides component instance for trait DI types.

DITarget

Type Aliases

DI

Represents depencency (component) type.

Attribute Macros

provider

Generate a [DIProvider] or [AsyncDIProvider] implementation. (attribute macro)

Derive Macros

DIPortal

Generate a DIPortal and [DIProvider] or [AsyncDIPortal] and [AsyncDIProvider] implementation.