Repository files navigation

[dependencies]ferrunix ="0.3"

Compiler support: requires rustc 1.67.1+

Check out theUser Guide.

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

• Can register and inject any type (incl. generics, types must beSend if themultithread feature is enabled, andSend + Sync iftokio 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 dynamicallyregister types.
• Injection of concrete value types (T),Box<T>,Rc<T>, andArc<T>.
• Derive macro (#[derive(Inject)]) to simplify registration.
• Automatic registration of types, thanks toinventory.
• One global registry; with support for multiple sub-registries.

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

• multithread: Enables support for accessing the registry from multiplethreads. This adds a bound that all registered types must beSend.
• derive (*): Enables support for the#[derive(Inject)] macro.
• tokio: Enables support forasync constructors. Bumps the MSRV up to1.75.0 because some of the internal traits requireRPITIT.
• tracing: Enables support fortracing and annotates all public functions withtracing::instrument.

Development of ferrunix is sponsored byRagnarLab. 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.