Struct Builder 

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

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

Implementations

impl<T, Deps: DepBuilder<T> + 'static> Builder<'_, T, Deps>

where T: Registerable,

pub fn register_transient<C>(&self, ctor: C)

where C: TransientCtorDeps<T, Deps> + Copy + 'static,

Register a new transient object, with dependencies specified in Registry::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>)>()
    .register_transient(|(num, template)| {
        // access `num` and `template` here.
        u16::from(*num)
    });

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

Panics

When the type has been registered already.

pub fn try_register_transient<C>(&self, ctor: C)

where C: TransientCtorFallibleDeps<T, Deps> + Copy + 'static,

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

The ctor parameter is a constructor function returning a Result<T, E>. 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>)>()
    .register_transient(|(num, template)| {
        // access `num` and `template` here.
        u16::from(*num)
    });

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

Panics

When the type has been registered already.

impl<T, Deps: DepBuilder<T> + 'static> Builder<'_, T, Deps>

where T: RegisterableSingleton,

pub fn register_singleton<F>(&self, ctor: F)

where F: SingletonCtorDeps<T, Deps>,

Register a new singleton object, with dependencies specified by Registry::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>)>()
    .register_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 try_register_singleton<F>(&self, ctor: F)

where F: SingletonCtorFallibleDeps<T, Deps>,

Register a new singleton object, with dependencies specified by Registry::with_deps.

The ctor parameter is a constructor function returning a Result<T, E>. 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>)>()
    .register_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.