Struct PluginLoader 

pub struct PluginLoader { /* private fields */ }

Plugin loader for dynamic loading and instantiation.

The PluginLoader handles the runtime loading of plugin libraries, symbol resolution, and plugin instantiation. It supports various plugin formats and provides caching for performance.

Supported Formats

• Dynamic libraries (.so, .dll, .dylib)
• WebAssembly modules (.wasm)
• Static plugins (compiled-in)

Example

use trustformers_core::plugins::{PluginLoader, PluginInfo};
use std::path::Path;

let loader = PluginLoader::new();

// Load plugin info from metadata
let info = loader.load_plugin_info(Path::new("plugins/custom_attention.so")).unwrap();

// Load the actual plugin
let plugin = loader.load_plugin(&info).unwrap();

Implementations

impl PluginLoader

pub fn new() -> Self

Creates a new plugin loader.

Returns

A new loader instance with default configuration.

pub fn with_config(config: LoaderConfig) -> Self

Creates a plugin loader with custom configuration.

Arguments

• config - Loader configuration

Returns

A new loader instance.

pub fn load_plugin_info<P: AsRef<Path>>(&self, path: P) -> Result<PluginInfo>

Loads plugin information from a file or metadata.

Arguments

• path - Path to the plugin file or metadata

Returns

Plugin information if successfully loaded.

Errors

• File not found
• Invalid plugin format
• Metadata parsing errors

pub fn load_plugin(&self, info: &PluginInfo) -> Result<Box<dyn Plugin>>

Loads a plugin instance from plugin information.

Arguments

• info - Plugin information containing loading details

Returns

A boxed plugin instance ready for use.

Errors

• Plugin file not found
• Symbol resolution failures
• Plugin initialization errors

pub fn register_static_plugin( &self, name: &str, factory: StaticPluginFactory, ) -> Result<()>

Registers a static plugin factory.

Static plugins are compiled into the binary and don’t require dynamic loading. This method registers a factory function that can create instances of the plugin.

Arguments

• name - Plugin name
• factory - Factory function for creating plugin instances

Returns

Ok(()) on successful registration.

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

Unloads a plugin library from the cache.

Arguments

• name - Plugin name to unload

Returns

Ok(()) on success.

pub fn clear_cache(&self) -> Result<()>

Clears all cached libraries.

pub fn stats(&self) -> Result<LoaderStats>

Gets loader statistics.

Returns

Loader statistics including cache information.

Trait Implementations

impl Debug for PluginLoader

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

Formats the value using the given formatter.

impl Default for PluginLoader

fn default() -> Self

Returns the “default value” for a type.