Struct ScriptProcess 

pub struct ScriptProcess { /* private fields */ }

Manages a single script subprocess with JSON-line communication.

The subprocess receives ScriptEvent objects serialized as JSON lines on stdin, and emits ScriptCommand objects as JSON lines on stdout. Stderr is captured separately for error reporting.

Implementations

impl ScriptProcess

pub fn spawn( command: &str, args: &[&str], env_vars: &HashMap<String, String>, ) -> Result<Self, String>

Spawn a script subprocess with piped stdin/stdout/stderr.

Starts background threads to read stdout (parsing JSON into ScriptCommand) and stderr (collecting error lines).

Arguments

• command - The command to execute (e.g., “python3”).
• args - Arguments to pass to the command.
• env_vars - Additional environment variables to set for the subprocess.

Errors

Returns an error string if the subprocess cannot be spawned.

pub fn poll_status(&mut self) -> ScriptStatus

Poll the process liveness, classifying an exit as clean or failed.

The first observed exit is sticky: ScriptStatus::Exited is recorded and the child handle is dropped, so later calls are cheap and the supervisor sees the transition exactly once. Self::is_running is defined in terms of this.

pub fn is_running(&mut self) -> bool

Check if the child process is still alive.

Returns false once the process has exited (cleanly or otherwise).

pub fn send_event(&mut self, event: &ScriptEvent) -> Result<(), String>

Serialize a ScriptEvent to JSON and write it to the child’s stdin as a line.

Errors

Returns an error if the stdin writer is not available or if the write fails.

pub fn read_commands(&self) -> Vec<ScriptCommand>

Drain pending commands from the command buffer.

Returns all commands that have been parsed from the child’s stdout since the last call to this method.

pub fn read_errors(&self) -> Vec<String>

Drain pending error lines from the error buffer.

Returns all lines that have been read from the child’s stderr since the last call to this method.

pub fn stop(&mut self)

Stop the subprocess.

Drops the stdin writer (sending EOF to the child), kills the child process if it’s still running, and waits for it to exit.

Trait Implementations

impl Drop for ScriptProcess

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.