Struct Process 

pub struct Process { /* private fields */ }

Reference of a system process spawned by Process::spawn

Example

use xprocess::Process;

fn main() {
   let process = Process::spawn("sleep").expect("Failed to spawn process");
   println!("Spawned process with PID: {}", process.pid());
   process.kill().expect("Failed to kill process");
}

Implementations

impl Process

pub fn spawn<S: AsRef<OsStr>>(cmd: S) -> Result<Self>

pub fn spawn_with_args<S, I, T>(cmd: S, args: I) -> Result<Self>

where T: AsRef<OsStr>, I: IntoIterator<Item = T>, S: AsRef<OsStr>,

pub fn pid(&self) -> u32

Retrieves PID for the spawned process

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

Reads and returns the stdout of the process

This method reads all available output from stdout and returns it as a String. The method will block until the process closes its stdout stream.

Important: This method consumes the stdout handle. Subsequent calls will return an empty String.

Note: For processes that produce output and then continue running, consider waiting for the process to finish or close stdout before calling this method, otherwise it may block indefinitely.

Example

let mut process = Process::spawn_with_args("echo", ["hello"]).expect("Failed to spawn");
// Wait for the process to finish writing
std::thread::sleep(std::time::Duration::from_millis(100));
let output = process.stdout().expect("Failed to read stdout");
assert_eq!(output.trim(), "hello");

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

Reads and returns the stderr of the process

This method reads all available output from stderr and returns it as a String. The method will block until the process closes its stderr stream.

Important: This method consumes the stderr handle. Subsequent calls will return an empty String.

Note: For processes that produce output and then continue running, consider waiting for the process to finish or close stderr before calling this method, otherwise it may block indefinitely.

Example

let mut process = Process::spawn_with_args("ls", ["/nonexistent"]).expect("Failed to spawn");
// Wait for the process to finish writing
std::thread::sleep(std::time::Duration::from_millis(100));
let error = process.stderr().expect("Failed to read stderr");
assert!(error.contains("No such file or directory"));

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

Kills the process referenced by this instance of Process