Crate zenoh_plugin_trait
source ·Expand description
§The plugin infrastructure for Zenoh.
To build a plugin, implement Plugin
.
If building a plugin for zenohd
, you should use the types exported in zenoh::plugins
to fill Plugin
’s associated types.
To check your plugin typing for zenohd
, have your plugin implement zenoh::plugins::ZenohPlugin
Plugin is a struct which implements the Plugin
trait. This trait has two associated types:
StartArgs
: the type of the arguments passed to the plugin’sstart
function.Instance
: the type of the plugin’s instance.
The actual work of the plugin is performed by the instance, which is created by the start
function.
Plugins are loaded, started and stopped by PluginsManager
. Stopping pluign is just dropping it’s instance.
Plugins can be static and dynamic.
Static plugin is just a type which implements Plugin
trait. It can be added to PluginsManager
by PluginsManager::add_static_plugin
method.
Dynamic pluign is a shared library which exports set of C-repr (unmangled) functions which allows to check plugin compatibility and create plugin instance. These functiuons are defined automatically by declare_plugin
macro.
Macros§
- This macro adds non-mangled functions which provides plugin version and loads it into the host. If plugin library should work also as static, consider calling this macro under feature condition
Structs§
- A plugin report contains a severity level and a list of messages describing the plugin’s situation (for the Declared state - dynamic library loading errors, for the Loaded state - plugin start errors, etc)
- The structure which contains all information about the plugin status in a single cloneable structure
- A plugins manager that handles starting and stopping plugins. Plugins can be loaded from shared libraries using [
Self::load_plugin_by_name
] or [Self::load_plugin_by_paths
], or added directly from the binary if available using [Self::add_static
].
Enums§
- The plugin can be in one of these states:
Constants§
Traits§
- Base plugin trait. The loaded plugin
- This trait allows getting information about the plugin status and the status of its subplugins, if any.
- Trait allowing getting all information about the plugin