Struct NativeCapability

pub struct NativeCapability { /* private fields */ }

Represents a native capability provider compiled as a shared object library. These plugins are OS- and architecture-specific, so they will be .so files on Linux, .dylib files on macOS, etc.

Implementations

impl NativeCapability

pub fn from_file<P: AsRef<OsStr>>( filename: P, binding_target_name: Option<String>, ) -> Result<Self>

Reads a capability provider from a file. The capability provider must implement the correct FFI interface to support waSCC plugins. See wascc.dev for documentation and tutorials on how to create a native capability provider

pub fn from_instance( instance: impl CapabilityProvider, binding_target_name: Option<String>, ) -> Result<Self>

This function is to be used for capability embedding. If you are building a custom waSCC host and have a fixed set of capabilities that you want to always be available to actors, then you can declare a dependency on the capability provider, enable the static_plugin feature, and provide an instance of that provider. Be sure to check that the provider supports capability embedding.

pub fn id(&self) -> String

Returns the capability ID (namespace) of the provider

pub fn name(&self) -> String

Returns the human-friendly name of the provider

pub fn descriptor(&self) -> &CapabilityDescriptor

Returns the full descriptor for the capability provider