Struct ProviderRegistry 

pub struct ProviderRegistry { /* private fields */ }

A registry of provider factories for dynamic provider instantiation.

The registry maintains a map of provider names to their factories, allowing providers to be created from configuration at runtime.

Thread Safety

The registry is thread-safe and can be accessed concurrently. Registration and lookup use interior mutability via RwLock.

Global vs Local Registries

Use ProviderRegistry::global() for the shared global registry, or create local registries with ProviderRegistry::new() for testing or isolated contexts.

Implementations

impl ProviderRegistry

pub fn new() -> Self

Creates a new empty registry.

pub fn global() -> &'static Self

Returns the global shared registry.

Provider crates should register their factories here on initialization. Application code can then build providers from configuration without knowing which providers are available at compile time.

pub fn register(&self, factory: Box<dyn ProviderFactory>) -> &Self

Registers a provider factory.

If a factory with the same name already exists, it is replaced.

Example

use llm_stack::registry::{ProviderRegistry, ProviderFactory};

ProviderRegistry::global().register(Box::new(MyProviderFactory));

pub fn register_shared(&self, factory: Arc<dyn ProviderFactory>) -> &Self

Registers a provider factory (chainable Arc version).

Use this when you want to share the factory instance.

pub fn unregister(&self, name: &str) -> bool

Unregisters a provider by name.

Returns true if the provider was registered and removed.

pub fn contains(&self, name: &str) -> bool

Checks if a provider is registered.

pub fn providers(&self) -> Vec<String>

Returns the names of all registered providers.

pub fn build( &self, config: &ProviderConfig, ) -> Result<Box<dyn DynProvider>, LlmError>

Builds a provider from configuration.

Looks up the factory by config.provider and delegates to it.

Errors

Returns LlmError::InvalidRequest if no factory is registered for the requested provider name.

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.