Crate portaldi

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

Features

• Natively async support

  • components and traits must be thread-safe (Sync + Send).
  • support for asynchronous component creation.

• 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

• async_di_provider
  Generate a [AsyncDIProvider] implementation.
• di_provider
  Generate a [DIProvider] implementation.

Structs

• DIContainer
  DI container holds component refs.

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
  Represent DI target type. It requires thread safety.

Type Aliases

• DI
  Represents depencency (component) type.

Attribute Macros

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

Derive Macros

• DIPortal
  Generate a DIPortal or [AsyncDIPortal] implementation. (derive macro)