Struct XXExpression

Source

pub struct XXExpression { /* private fields */ }

Implementations§

Source §

pub fn on_stdout_line<F>(self, handler: F) -> Self
where F: Fn(&str) + Send + Sync + 'static,

Register a line-by-line stdout handler. When set, run() will stream output lines to this handler instead of capturing stdout.

Source

pub fn on_stderr_line<F>(self, handler: F) -> Self
where F: Fn(&str) + Send + Sync + 'static,

Register a line-by-line stderr handler. When set, run() will stream error lines to this handler instead of capturing stderr.

Source

pub fn env<K, V>(self, key: K, value: V) -> Self
where K: Into<OsString>, V: Into<OsString>,

Set an environment variable for this command

§Example

use xx::process;
let output = process::cmd("sh", ["-c", "echo $MY_VAR"])
    .env("MY_VAR", "hello")
    .read()
    .unwrap();
assert_eq!(output, "hello");

Source

pub fn envs<I, K, V>(self, vars: I) -> Self
where I: IntoIterator<Item = (K, V)>, K: Into<OsString>, V: Into<OsString>,

Set multiple environment variables for this command

§Example

use xx::process;
use std::collections::HashMap;
let mut env = HashMap::new();
env.insert("VAR1", "value1");
env.insert("VAR2", "value2");
let output = process::cmd("sh", ["-c", "echo $VAR1 $VAR2"])
    .envs(env)
    .read()
    .unwrap();
assert_eq!(output, "value1 value2");

Source

pub fn env_clear(self) -> Self

Clear all environment variables before running (start with empty environment)

§Example

use xx::process;
let output = process::cmd("sh", ["-c", "echo ${PATH:-empty}"])
    .env_clear()
    .env("PATH", "/bin:/usr/bin")
    .read()
    .unwrap();
assert_eq!(output, "/bin:/usr/bin");

Source

pub fn cwd<P: AsRef<Path>>(self, dir: P) -> Self

Set the working directory for this command

§Example

use xx::process;
let output = process::cmd("pwd", Vec::<&str>::new())
    .cwd("/tmp")
    .read()
    .unwrap();
assert!(output.contains("tmp"));

Source

pub fn stdin_bytes<B: AsRef<[u8]>>(self, data: B) -> Self

Provide stdin data as bytes

§Example

use xx::process;
let output = process::cmd("cat", Vec::<&str>::new())
    .stdin_bytes(b"hello world")
    .read()
    .unwrap();
assert_eq!(output, "hello world");

Source

pub fn stdin_file<P: AsRef<Path>>(self, path: P) -> XXResult<Self>

Provide stdin data from a file

§Example

use xx::process;
let output = process::cmd("cat", Vec::<&str>::new())
    .stdin_file("input.txt")
    .unwrap()
    .read()
    .unwrap();

Source

pub fn unchecked(self) -> Self

Don’t check the exit status (allow non-zero exit codes)

By default, run() and read() return an error if the process exits with a non-zero status. This method disables that check.

§Example

use xx::process;
// This would normally error because false exits with code 1
let output = process::cmd("false", Vec::<&str>::new())
    .unchecked()
    .run()
    .unwrap();
assert!(!output.status.success());