Struct PluginLoader 

pub struct PluginLoader { /* private fields */ }

Plugin loader for dynamic library loading

The PluginLoader provides functionality to load plugins from dynamic libraries at runtime. It manages the lifecycle of loaded libraries and integrates with the plugin registry for automatic plugin registration.

Features

• Dynamic library loading from files or directories
• Automatic plugin discovery and registration
• Proper library lifecycle management
• Cross-platform support (Windows DLL, Linux SO, macOS dylib)
• Error handling and validation

Examples

use sklears_core::plugin::{PluginLoader, PluginRegistry};
use std::sync::Arc;

let registry = Arc::new(PluginRegistry::new());
let mut loader = PluginLoader::new(registry.clone());

// Load a single plugin
loader.load_from_library("./plugins/my_plugin.so", "my_plugin")?;

// Load all plugins from a directory
let loaded = loader.load_from_directory("./plugins/")?;
println!("Loaded {} plugins", loaded.len());

Safety

Dynamic library loading involves unsafe operations. The plugin loader takes precautions to ensure safety, but loaded plugins must be trusted and properly implemented.

Implementations

impl PluginLoader

pub fn new(registry: Arc<PluginRegistry>) -> Self

Create a new plugin loader

Creates a new plugin loader that will register loaded plugins with the provided registry.

Arguments

• registry - The plugin registry to use for registration

Examples

use sklears_core::plugin::{PluginLoader, PluginRegistry};
use std::sync::Arc;

let registry = Arc::new(PluginRegistry::new());
let loader = PluginLoader::new(registry);

pub fn registry(&self) -> &Arc<PluginRegistry>

Get the plugin registry

Returns a reference to the plugin registry used by this loader.

Returns

A reference to the plugin registry.

impl PluginLoader

Stub implementations for when dynamic loading is not available

pub fn load_from_library( &mut self, _library_path: &str, _plugin_id: &str, ) -> Result<()>

Load a plugin from a dynamic library (stub implementation)

This method is not available when the dynamic_loading feature is disabled. It will always return an error indicating that dynamic loading is not supported.

pub fn unload_library(&mut self, _plugin_id: &str) -> Result<()>

Unload a plugin library (stub implementation)

This method is not available when the dynamic_loading feature is disabled.

pub fn load_from_directory(&mut self, _directory: &str) -> Result<Vec<String>>

Load plugins from a directory (stub implementation)

This method is not available when the dynamic_loading feature is disabled.

Trait Implementations

impl Debug for PluginLoader

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

Formats the value using the given formatter.