Crate process

Source

Expand description

§⚙️ process-lib

Cross-platform, asynchronous Rust library to run commands in pipelines.

§Features

This library can be seen as a convenient async wrapper around std::process::Command:

Wraps commands by default with sh -c or cmd /C
Supports pipeline (previous command output sent as input for the next command)
Exposes convenient functions to export output (as string lossy for example)
Supports tokio and async-std async runtimes
Supports serde (de)serialization

The library comes with 3 cargo features, including 1 default one:

tokio: enables the tokio async runtime
async-std: enables the async-std async runtime
derive: enables serde support

§Example

use process::{Command, Pipeline};

#[tokio::main]
async fn main() {
    // run a single command	
    let cmd = Command::new("echo hello, world!");
    let out = cmd.run().await.unwrap().to_string_lossy();
    assert_eq!(out, "hello, world!\n");
	
    // run a pipeline
    let cmd = Pipeline::new(["echo hello", "cat"]);
    let out = cmd.run().await.unwrap().to_string_lossy();
    assert_eq!(out, "hello\n");
}