Struct PluginLoader 

pub struct PluginLoader { /* private fields */ }

Loader for plug-in cdylibs.

Owns every Library for the lifetime of the live node, since v1 does not support dlclose. Caller walks the returned LoadedPlugin manifests to register entries into the relevant runtime registries.

Implementations

impl PluginLoader

pub fn new() -> Self

Creates a new, empty loader that hands every plug-in the default nautilus-plugin host vtable. The default vtable carries NotImplemented stubs for stateful host callbacks; use PluginLoader::with_host to install a live-node vtable.

pub fn with_host(host: *const HostVTable) -> Self

Creates a new, empty loader that will hand every loaded plug-in the supplied host vtable instead of the default.

host must remain live for the lifetime of every plug-in loaded through this loader (typically the process lifetime).

pub fn load_all<P>( &mut self, paths: impl IntoIterator<Item = P>, ) -> Result<(), LoadError>

where P: AsRef<OsStr>,

Loads every plug-in path in order. Stops on the first error.

pub fn load( &mut self, path: impl AsRef<OsStr>, ) -> Result<&LoadedPlugin, LoadError>

Loads a single plug-in cdylib.

pub fn loaded(&self) -> &[LoadedPlugin]

Returns every loaded plug-in in load order.

pub fn len(&self) -> usize

Returns the number of loaded plug-ins.

pub fn is_empty(&self) -> bool

Returns whether no plug-ins have been loaded.

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() -> PluginLoader

Returns the “default value” for a type.

impl Send for PluginLoader

SAFETY: *const HostVTable is a process-lifetime static pointer; the host commits to keeping the vtable live and the inner fn pointers are Sync by construction.

impl Sync for PluginLoader

SAFETY: see above.