Struct ProcessRuntime 

pub struct ProcessRuntime { /* private fields */ }

Persistent, independently supervised worker process for each loaded plugin. The executable must implement the hidden __plugin-worker LANGUAGE entrypoint.

Implementations

impl ProcessRuntime

pub fn new(executable: PathBuf) -> PluginResult<Self>

Run Lua plugins in workers launched from executable, which must support the private worker protocol.

Trait Implementations

impl Drop for ProcessRuntime

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl PluginRuntime for ProcessRuntime

fn name(&self) -> &'static str

Get the name of this runtime (e.g. “lua”).

fn file_extensions(&self) -> &'static [&'static str]

Get the file extensions this runtime handles (e.g., [“.lua”]).

fn init(&mut self, config: &PluginConfig) -> PluginResult<()>

Initialize the runtime with configuration.

fn load_plugin(&mut self, id: &str, source: &Path) -> PluginResult<PluginHandle>

Load a plugin from a file path.

fn unload_plugin(&mut self, handle: PluginHandle) -> PluginResult<()>

Unload a previously loaded plugin.

fn get_metadata(&self, handle: PluginHandle) -> Option<&PluginMetadata>

Get metadata about a loaded plugin.

fn has_hook(&self, handle: PluginHandle, name: &str) -> bool

Check if a plugin implements a specific hook.

fn call_hook_sync( &self, handle: PluginHandle, hook: &Hook, ctx: &HookContext, ) -> PluginResult<HookResult>

Call a hook on a plugin synchronously.

fn call_hook_async<'a>( &'a self, handle: PluginHandle, hook: &'a Hook, ctx: &'a HookContext, ) -> Pin<Box<dyn Future<Output = PluginResult<HookResult>> + Send + 'a>>

Call a hook on a plugin asynchronously.

fn call_method<'a>( &'a self, handle: PluginHandle, method: &'a str, args: Vec<Value>, ) -> Pin<Box<dyn Future<Output = PluginResult<Value>> + Send + 'a>>

Call an arbitrary method on a plugin.

fn create_isolated_context( &self, sandbox: &SandboxConfig, ) -> PluginResult<Box<dyn IsolatedContext>>

Create an isolated context for running async plugin code.

fn loaded_plugins(&self) -> Vec<PluginHandle>

Get the list of loaded plugin handles.

fn shutdown(&mut self) -> PluginResult<()>

Shutdown the runtime and cleanup resources.