[dependencies]
ferrunix = "0"

Compiler support: requires rustc 1.64+

Changelog

Features

• Can register and inject any type (incl. generics, types must be Send + Sync if the multithread feature is enabled).
• Simple and elegant Rust API, making the derive macro purely optional.
• Different dependency lifetimes:
  • Singleton: Only a single instance of the object is created.
  • Transient: A new instance is created for every request.
• Derive macro (#[derive(Inject)]) to simplify registration.
• Automatic registration of types.
• One global registry; with support for multipiple sub-registries.

Usage

Add the dependency to your Cargo.toml:

cargo add ferrunix

Register your types with the Registry:

use ferrunix::{Ref, Registry, Transient};
use example::{Logger, BillingService, SysLog}

#[derive(Debug, Default)]
pub struct ExampleService {}

impl ExampleService {
    pub fn do_work(&self) {
        // Omitted for brevity...
    }
}

fn main() {
    let registry = Registry::global();
    registry.transient(|| ExampleService::default());
    // Register more types here ...

    debug_assert!(registry.validate_all());

    let service = registry.get_transient::<ExampleService>().unwrap();
    service.do_work();
}

Features

Ferrunix has the following features to enable further functionality. Default features are marked with *.

• multithread (*): Enable support for access to the registry from multiple threads. This adds a bound that all registered types must be Send and Sync.
• derive (*): Enable support for the #[derive(Inject)] macro.

License