Struct Builder

pub struct Builder<'a, T, Deps> { /* private fields */ }

A builder for objects with dependencies. This can be created by using Registry::with_deps.

Implementations

impl<T, Deps> Builder<'_, T, Deps>

where Deps: DepBuilder<T> + 'static, T: Registerable,

pub fn transient(&self, ctor: fn(_: Deps) -> T)

Register a new transient object, with dependencies specified in .with_deps.

The ctor parameter is a constructor function returning the newly constructed T. The constructor accepts a single argument Deps (a tuple implementing crate::dependency_builder::DepBuilder). It’s best to destructure the tuple to accept each dependency separately. This constructor will be called for every T that is requested.

Example

registry
    .with_deps::<_, (Transient<u8>, Singleton<Template>)>()
    .transient(|(num, template)| {
        // access `num` and `template` here.
        u16::from(*num)
    });

For single dependencies, the destructured tuple needs to end with a comma: (dep,).

pub fn singleton(&self, ctor: fn(_: Deps) -> T)

Register a new singleton object, with dependencies specified in .with_deps.

The ctor parameter is a constructor function returning the newly constructed T. The constructor accepts a single argument Deps (a tuple implementing crate::dependency_builder::DepBuilder). It’s best to destructure the tuple to accept each dependency separately. This constructor will be called once, lazily, when the first instance of T is requested.

Example

registry
    .with_deps::<_, (Transient<u8>, Singleton<Template>)>()
    .transient(|(num, template)| {
        // access `num` and `template` here.
        u16::from(*num)
    });

For single dependencies, the destructured tuple needs to end with a comma: (dep,).

Trait Implementations

impl<T, Dep> Debug for Builder<'_, T, Dep>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.