Struct BackgroundProcess 

pub struct BackgroundProcess { /* private fields */ }

A background process handle.

Implementations

impl BackgroundProcess

pub fn spawn(command: Command) -> Result<Self>

Spawn a new background process.

pub fn spawn_piped(command: Command) -> Result<Self>

Spawn a new background process with piped stdout and stderr.

This allows reading the process output while it’s running.

Example

let mut cmd = Command::new("agtrace");
cmd.args(&["watch"]);

let mut proc = BackgroundProcess::spawn_piped(cmd).unwrap();

// Read output
if let Some(stdout) = proc.stdout() {
    let reader = BufReader::new(stdout);
    for line in reader.lines() {
        println!("Output: {:?}", line);
    }
}

pub fn wait_timeout(&mut self, timeout: Duration) -> Result<Option<ExitStatus>>

Wait for the process to exit with a timeout.

pub fn kill(&mut self) -> Result<()>

Kill the process.

pub fn id(&self) -> u32

Get the process ID.

pub fn stdout(&mut self) -> Option<&mut ChildStdout>

Get mutable access to the process’s stdout.

Returns None if stdout was not captured (process must be spawned with spawn_piped).

Example

let mut cmd = Command::new("agtrace");
let mut proc = BackgroundProcess::spawn_piped(cmd).unwrap();

if let Some(stdout) = proc.stdout() {
    let reader = BufReader::new(stdout);
    for line in reader.lines().take(5) {
        println!("{:?}", line);
    }
}

pub fn stderr(&mut self) -> Option<&mut ChildStderr>

Get mutable access to the process’s stderr.

Returns None if stderr was not captured (process must be spawned with spawn_piped).

Trait Implementations

impl Drop for BackgroundProcess

fn drop(&mut self)

Executes the destructor for this type.