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<ScriptProcess, 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 is_running(&mut self) -> bool

Check if the child process is still alive.

Uses try_wait() to check without blocking. Returns false if the process has exited or if there is no child process.

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.