Struct PluginHostProcess 

pub struct PluginHostProcess { /* private fields */ }

Manages a plugin running in an isolated process.

Responses are read on a background thread and delivered over a channel, so Self::send_command can wait with a deadline: a hung plugin yields a timeout error (and the child is killed) instead of blocking the host forever, and a crashed helper surfaces as a disconnect error rather than a silent wedge.

Implementations

impl PluginHostProcess

pub fn new( helper_override: Option<PathBuf>, timeout: Duration, ) -> Result<Self, String>

Create a new isolated plugin host process

pub fn set_timeout(&mut self, timeout: Duration)

Set how long to wait for a helper response before declaring a timeout.

pub fn send_command( &mut self, command: HostCommand, ) -> Result<HostResponse, String>

Send a command to the helper process and wait (with a deadline) for a response.

Returns an error without blocking indefinitely if the plugin hangs (the child is killed) or the helper has crashed/exited.

pub fn is_alive(&self) -> bool

Whether the helper process is still considered alive.

pub fn helper_pid(&self) -> Option<u32>

OS process id of the running helper, if any. Useful for monitoring — and for tests that need to simulate a crash by killing the helper.

pub fn check_process_status(&mut self) -> Result<(), String>

Check if the helper process is still running

pub fn shutdown(&mut self)

Shutdown the helper process

Trait Implementations

impl Drop for PluginHostProcess

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.