Struct WasmPlugin 

pub struct WasmPlugin { /* private fields */ }

A Plugin backed by a sandboxed WASM module.

Load a .wasm (or .wat, useful for testing) module with WasmPlugin::load, map its business functions to implementation names with with_function_map, then register it via CliBuilder::register_plugin or the convenience CliBuilder::register_wasm_plugin.

See the module-level documentation for the full ABI contract.

Implementations

impl WasmPlugin

pub fn load(path: &Path) -> Result<Self>

Load a WASM module from disk and validate its mandatory exports.

Accepts both binary .wasm and text .wat modules (the latter is primarily useful for tests and minimal fixtures).

Errors

Returns WasmError::LoadFailed if the file cannot be read or fails to compile/validate. Returns WasmError::FunctionNotFound if memory, dcli_alloc, or dcli_dealloc is missing — these three are mandatory regardless of which business functions are mapped later.

Example

use dynamic_cli::plugin::wasm::WasmPlugin;
use std::path::Path;

let plugin = WasmPlugin::load(Path::new("plugins/greet.wasm"))?;

pub fn from_bytes(bytes: &[u8], origin: &Path) -> Result<Self>

Load a WASM module from raw bytes (binary .wasm or text .wat).

Used internally by load. Exposed for tests and for embedding scenarios where the module bytes are not stored on disk (e.g. fetched over the network).

Validates the same mandatory exports as load.

pub fn with_function_map(self, impl_name: &str, wasm_fn_name: &str) -> Self

Map an implementation name to a WASM-exported business function.

The exported function name is chosen freely by the plugin author — dynamic-cli imposes no naming convention beyond the four reserved names (memory, dcli_alloc, dcli_dealloc, dcli_last_error_message).

Existence of wasm_fn_name in the module is verified at handler construction time, in Plugin::handlers.

Example

use dynamic_cli::plugin::wasm::WasmPlugin;
use std::path::Path;

let plugin = WasmPlugin::load(Path::new("plugins/greet.wasm"))?
    .with_function_map("greet_hello", "say_hello");

pub fn with_format(self, format: WasmSerializationFormat) -> Self

Set the serialization format used for argument exchange.

Defaults to WasmSerializationFormat::Yaml.

pub fn with_metadata(self, name: &str, version: &str, description: &str) -> Self

Set plugin metadata (name, version, description).

When not called, defaults are derived from the module’s file name (name), "0.0.0" (version), and a generic description.

Trait Implementations

impl Plugin for WasmPlugin

fn name(&self) -> &str

Short identifier for this plugin (e.g. "system", "greet").

fn version(&self) -> &str

Semantic version string (e.g. "1.0.0").

fn description(&self) -> &str

Human-readable description of what this plugin provides.

fn handlers(&self) -> Vec<(String, Box<dyn CommandHandler>)>

Returns the handlers this plugin contributes.