Struct extism_runtime::Plugin

pub struct Plugin {
    pub modules: BTreeMap<String, Module>,
    pub linker: Linker<Internal>,
    pub instance: Instance,
    pub instantiations: usize,
    pub memory: UnsafeCell<PluginMemory>,
    pub timer_id: Uuid,
    /* private fields */
}

Plugin contains everything needed to execute a WASM function

Fields

modules: BTreeMap<String, Module>

All modules that were provided to the linker

linker: Linker<Internal>

Used to define functions and create new instances

instance: Instance

Instance provides the ability to call functions in a module

instantiations: usize

Keep track of the number of times we’re instantiated, this exists to avoid issues with memory piling up since Instances are only actually cleaned up along with a Store

memory: UnsafeCell<PluginMemory>

Handles interactions with WASM memory

timer_id: Uuid

The ID used to identify this plugin with the Timer

Implementations

impl Plugin

pub fn new<'a>( wasm: impl AsRef<[u8]>, imports: impl IntoIterator<Item = &'a Function>, with_wasi: bool ) -> Result<Plugin, Error>

Create a new plugin from the given WASM code

pub fn get_func(&mut self, function: impl AsRef<str>) -> Option<Func>

Get a function by name

pub fn error<E>(&self, e: impl Debug, x: E) -> E

pub fn set_input(&mut self, input: *const u8, len: usize)

Store input in memory and initialize Internal pointer

pub fn dump_memory(&self)

Dump memory using trace! logging

pub fn reinstantiate(&mut self) -> Result<(), Error>

Create a new instance from the same modules

pub fn has_wasi(&self) -> bool

Determine if wasi is enabled

Trait Implementations

impl<'a> AsMut<Plugin> for PluginRef<'a>

fn as_mut(&mut self) -> &mut Plugin

Converts this type into a mutable reference of the (usually inferred) input type.

impl<'a> AsRef<Plugin> for PluginRef<'a>

fn as_ref(&self) -> &Plugin

Converts this type into a shared reference of the (usually inferred) input type.

impl InternalExt for Plugin

fn memory(&self) -> &PluginMemory

fn memory_mut(&mut self) -> &mut PluginMemory

fn store(&self) -> &Store<Internal>

fn store_mut(&mut self) -> &mut Store<Internal>

fn internal(&self) -> &Internal

fn internal_mut(&mut self) -> &mut Internal