Struct DiContainerBuilder 

pub struct DiContainerBuilder { /* private fields */ }

Mutable builder used only during boot.

Implementations

impl DiContainerBuilder

pub fn new() -> Self

pub fn register<T: Send + Sync + 'static>(&mut self, v: T) -> &mut Self

Register a fully-constructed singleton. Useful for primitives and configuration values that aren’t #[Injectable].

If an #[Injectable] provider for the same type also exists, freeze panics — a silent winner would mask which instance the app runs with. Use register_override to intentionally replace a descriptor-built provider.

pub fn register_override<T: Send + Sync + 'static>(&mut self, v: T) -> &mut Self

Register a singleton that replaces any #[Injectable] provider of the same type. The descriptor is discarded; everything that depends on T resolves to this instance. Intended for plugins swapping a core service (e.g. a custom SessionStore) — explicit, not accidental.

pub fn add_provider(&mut self, d: &'static ProviderDescriptor) -> &mut Self

Register a provider descriptor (emitted by #[Injectable]).

pub fn freeze(self) -> &'static FrozenDiContainer

Run topological sort, detect cycles, build providers in dependency order, then leak as &'static.

Panics if a direct registration collides with an #[Injectable] descriptor without an explicit override — previously the descriptor silently won, which made plugin-side “overrides” no-ops.

Trait Implementations

impl Default for DiContainerBuilder

fn default() -> DiContainerBuilder

Returns the “default value” for a type.