soenkehahn / cradle

Rust library for running child processes
Creative Commons Zero v1.0 Universal
38 stars 5 forks source link
rust

ci status badge crates.io docs

cradle is a library for executing child processes. It provides a more convenient interface than std::process::Command. Here's an example:

use cradle::prelude::*;

fn main() {
    // output git version
    run!(%"git --version");
    // output configured git user
    let (StdoutTrimmed(git_user), Status(status)) = run_output!(%"git config --get user.name");
    if status.success() {
        eprintln!("git user: {}", git_user);
    } else {
        eprintln!("git user not configured");
    }
}

For comprehensive documentation, head over to docs.rs/cradle.

Design Goals

cradle is meant to make it as easy as possible to run child processes, while making it hard to use incorrectly. As such it provides an interface that is concise and flexible, and tries to avoid surprising behavior.

cradle does not try to emulate the syntax or functionality of bash or other shells, such as pipes (|), globs (*), or other string expansion. Instead, it aims to be a convenient wrapper around the operating system's interface for running child processes.

MSRV

The minimal supported rust version is 0.41.