Struct PluginLoader 

pub struct PluginLoader { /* private fields */ }

Plugin Loader

Manages dynamic loading and unloading of Shape plugins. Keeps loaded libraries in memory to prevent unloading while in use.

Implementations

impl PluginLoader

pub fn new() -> Self

Create a new plugin loader

pub fn load(&mut self, path: &Path) -> Result<LoadedPlugin>

Load a plugin from a shared library file

Arguments

• path - Path to the shared library (.so, .dll, .dylib)

Returns

Information about the loaded plugin

Safety

Loading plugins executes arbitrary code. Only load from trusted sources.

pub fn get_data_source_vtable( &self, name: &str, ) -> Result<&'static DataSourceVTable>

Get the data source vtable for a loaded plugin

Arguments

• name - Name of the loaded plugin

Returns

The DataSourceVTable if plugin exists and is a data source

pub fn get_output_sink_vtable( &self, name: &str, ) -> Result<&'static OutputSinkVTable>

Get the output sink vtable for a loaded plugin

Arguments

• name - Name of the loaded plugin

Returns

The OutputSinkVTable if plugin exists and is an output sink

pub fn get_module_vtable(&self, name: &str) -> Result<&'static ModuleVTable>

Get the base module vtable for a loaded plugin.

pub fn get_language_runtime_vtable( &self, name: &str, ) -> Result<&'static LanguageRuntimeVTable>

Get the language runtime vtable for a loaded plugin.

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

Unload a plugin

Note: The library is actually unloaded when dropped. This removes it from the loader’s tracking.

pub fn loaded_plugins(&self) -> Vec<&str>

List all loaded plugins

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

Check if a plugin is loaded

pub fn load_data_source( &mut self, path: &Path, config: &Value, ) -> Result<PluginDataSource>

Load a data source plugin and return a ready-to-use wrapper

This is a convenience method that combines loading the library, getting the vtable, and creating the PluginDataSource wrapper.

Arguments

• path - Path to the shared library
• config - Configuration value for the plugin

Returns

Ready-to-use PluginDataSource wrapper

Trait Implementations

impl Default for PluginLoader

fn default() -> Self

Returns the “default value” for a type.

impl Drop for PluginLoader

fn drop(&mut self)

Executes the destructor for this type.