Struct PluginInstance 

pub struct PluginInstance { /* private fields */ }

A running WebAssembly plugin instance.

Holds the Wasmtime Store and Instance for a single plugin. All calls happen in the context of this instance and consume its fuel budget.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let wasm_bytes: &[u8] = b"";
let runtime = PluginRuntime::new().unwrap();
let mut plugin = runtime.load(wasm_bytes, CapabilitySet::empty()).unwrap();
plugin.invoke("run").unwrap();

Implementations

impl PluginInstance

pub fn invoke(&mut self, name: &str) -> Result<(), PluginError>

Invokes an exported function that takes no parameters and returns nothing.

Errors

Returns PluginError::MissingExport if the export does not exist or has the wrong signature, or any other plugin error if execution fails.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let runtime = PluginRuntime::new().unwrap();
let mut plugin = runtime.load(wasm_bytes, CapabilitySet::empty()).unwrap();
plugin.invoke("run").unwrap();

pub fn invoke_typed<Args, Rets>( &mut self, name: &str, args: Args, ) -> Result<Rets, PluginError>

where Args: WasmParams, Rets: WasmResults,

Invokes an exported function with a statically checked WebAssembly signature.

Errors

Returns PluginError::MissingExport if the export does not exist or has a signature different from Args -> Rets, or any execution error produced by the plugin.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let wasm_bytes: &[u8] = b"";
let runtime = PluginRuntime::new().unwrap();
let mut plugin = runtime.load(wasm_bytes, CapabilitySet::empty()).unwrap();
let result: i32 = plugin.invoke_typed("add_one", 41).unwrap();
assert_eq!(result, 42);

pub fn drain_paint_commands(&mut self, f: impl FnMut(&PluginPaintCmd, &[u8]))

Drains paint commands from this instance’s shared ring buffer.

The ring region lives inside guest-visible linear memory: either a host-grown region of the guest’s exported memory, or the dedicated martensite.ring_memory import. The guest produces commands by writing PluginPaintCmd records plus the head/tail cursor header directly; this call consumes and clears them. Does nothing when the plugin has no ring region.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let wasm_bytes: &[u8] = b"";
let runtime = PluginRuntime::new().unwrap();
let mut plugin = runtime.load(wasm_bytes, CapabilitySet::empty()).unwrap();
plugin.drain_paint_commands(|cmd, payload| {
    println!("cmd_type={}, {} bytes", cmd.cmd_type, payload.len());
});

pub fn capabilities(&self) -> &CapabilitySet

Returns a reference to the capability set active for this instance.

Examples

use martensite_plugin::{Capability, CapabilitySet, PluginRuntime};

let wasm_bytes: &[u8] = b"";
let caps = CapabilitySet::builder().grant(Capability::Network).build();
let runtime = PluginRuntime::new().unwrap();
let plugin = runtime.load(wasm_bytes, caps).unwrap();
assert!(plugin.capabilities().contains(&Capability::Network));