Struct ProviderRegistry 

pub struct ProviderRegistry { /* private fields */ }

A registry of dynamically-registered providers for external types.

Every registration is keyed by (TypeId<T>, token). Use DEFAULT_TOKEN ("") when you only need one provider for a type; use distinct token strings when you need multiple providers of the same type.

Example

let mut registry = ProviderRegistry::new();

// Unnamed (default) provider
registry.register("", DynProvider::sync(|| Ok(reqwest::Client::new())));

// Named providers — two pools of the same type
registry.register("primary", DynProvider::new(|| async { Ok(primary_pool()) }));
registry.register("replica", DynProvider::new(|| async { Ok(replica_pool()) }));

Implementations

impl ProviderRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn register<T: Send + Sync + 'static>( &mut self, token: impl Into<String>, provider: DynProvider<T>, )

Register a dynamic provider for type T under the given token.

If the same (type, token) pair is registered more than once, the duplicate is recorded and surfaced as an error when ContainerBuilder::build is called. Use register_or_replace if you intentionally want to override an existing registration.

Token conventions

• Use DEFAULT_TOKEN ("") for the canonical, unnamed provider.
• Use a descriptive string ("primary", "analytics") for named variants.

Example

// Default registration
registry.register("", DynProvider::sync(|| Ok(reqwest::Client::new())));

// Named registrations of the same type
registry.register("primary",  DynProvider::new(|| async { Ok(primary_pool()) }));
registry.register("replica",  DynProvider::new(|| async { Ok(replica_pool()) }));

pub fn register_or_replace<T: Send + Sync + 'static>( &mut self, token: impl Into<String>, provider: DynProvider<T>, )

Register a dynamic provider for type T under the given token, silently replacing any previously registered provider for the same (type, token) pair.

Use this in tests or layered-config scenarios where intentional override is expected.

pub fn duplicates(&self) -> &[String]

Return duplicate "TypeName[token]" labels recorded so far.

pub fn has<T: 'static>(&self) -> bool

Check if the registry has a provider for type T with the default token.

Equivalent to has_with_token::<T>(DEFAULT_TOKEN).

pub fn has_with_token<T: 'static>(&self, token: &str) -> bool

Check if the registry has a provider for type T with the given token.

pub fn len(&self) -> usize

Returns the total number of registered providers (across all tokens).

pub fn is_empty(&self) -> bool

Returns true if no providers are registered.

Trait Implementations

impl Debug for ProviderRegistry

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

Formats the value using the given formatter.

impl Default for ProviderRegistry

fn default() -> Self

Returns the “default value” for a type.