[dependencies]
ferrunix = "0.5"

Compiler support: requires rustc 1.70.0+

Check out the User Guide.

Documentation

Due to how the various features affect the public API of the library, the documentation is provided for each major feature separately.

Features

• Can register and inject any type (incl. generics, types must be Send if the multithread feature is enabled, and Send + Sync if tokio 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.

• Dependency resolution happens at run time, making it possible to dynamically register types.

• Injection of concrete value types (T), Box<T>, Rc<T>, and Arc<T>.

• Derive macro (#[derive(Inject)]) to simplify registration.

• Automatic registration of types, thanks to inventory.

• One global registry; with support for multiple sub-registries.

Cargo Feature Flags

Ferrunix has the following features to enable further functionality. Features enabled by default are marked with *.

• multithread: Enables support for accessing the registry from multiple threads. This adds a bound that all registered types must be Send.
• derive (*): Enables support for the #[derive(Inject)] macro.
• tokio: Enables support for async constructors. Bumps the MSRV up to 1.75.0 because some of the internal traits require RPITIT.
• tracing: Enables support for tracing and annotates all public functions with tracing::instrument.

Support

Development of ferrunix is sponsored by RagnarLab. RagnarLab is a Rust consultancy based in Stuttgart, Germany. We provide Rust development from prototype to product, helping you write safer software. Interested in Rust? Get in touch with us.

License