Struct wasm_plugin_host::WasmPluginBuilder

pub struct WasmPluginBuilder { /* fields omitted */ }

Constructs a WasmPlugin

Implementations

impl WasmPluginBuilder

pub fn from_file(path: impl AsRef<Path>) -> Result<Self>

Load a plugin off disk and prepare it for use.

pub fn from_source(source: &[u8]) -> Result<Self>

Load a plugin from WASM source and prepare it for use.

pub fn import_function_with_context<Args, F: ImportableFnWithContext<C, Args> + Send + 'static, C: Send + Sync + Clone + 'static>(
    self,
    name: impl ToString,
    ctx: C,
    value: F
) -> Self

Import a function defined in the host into the guest. The function’s arguments and return type must all be serializable. An immutable reference to ctx will be passed to the function as it’s first argument each time it’s called.

NOTE: This method exists due to a limitation in the underlying Waswer engine which currently doesn’t support imported closures with captured context. The Wasamer developers have said they are interested in removing that limitation and when they do this method will be removed in favor of `import_function’ since context can be more idiomatically handled with captured values.

pub fn import_function<Args, F: ImportableFn<Args> + Send + 'static>(
    self,
    name: impl ToString,
    value: F
) -> Self

Import a function defined in the host into the guest. The function’s arguments and return type must all be serializable.

pub fn finish(self) -> Result<WasmPlugin>

Finalize the builder and create the WasmPlugin ready for use.