25 releases

0.13.7 Dec 22, 2023
0.13.6 Nov 29, 2022
0.13.5 Feb 4, 2021
0.13.4 Apr 13, 2020
0.1.0 Feb 20, 2016

#11 in Development tools

Download history 92072/week @ 2024-08-15 92306/week @ 2024-08-22 101392/week @ 2024-08-29 99986/week @ 2024-09-05 90737/week @ 2024-09-12 93960/week @ 2024-09-19 103101/week @ 2024-09-26 95898/week @ 2024-10-03 98185/week @ 2024-10-10 113921/week @ 2024-10-17 110366/week @ 2024-10-24 106395/week @ 2024-10-31 116427/week @ 2024-11-07 128085/week @ 2024-11-14 133744/week @ 2024-11-21 125062/week @ 2024-11-28

522,446 downloads per month
Used in 365 crates (167 directly)

MIT license

105KB
1.5K SLoC

duct.rs Actions Status crates.io docs.rs

Duct is a library for running child processes. Duct makes it easy to build pipelines and redirect IO like a shell. At the same time, Duct helps you write correct, portable code: whitespace is never significant, errors from child processes get reported by default, and a variety of gotchas, bugs, and platform inconsistencies are handled for you the Right Way™.

Examples

Run a command without capturing any output. Here "hi" is printed directly to the terminal:

use duct::cmd;
cmd!("echo", "hi").run()?;

Capture the standard output of a command. Here "hi" is returned as a String:

let stdout = cmd!("echo", "hi").read()?;
assert_eq!(stdout, "hi");

Capture the standard output of a pipeline:

let stdout = cmd!("echo", "hi").pipe(cmd!("sed", "s/i/o/")).read()?;
assert_eq!(stdout, "ho");

Merge standard error into standard output and read both incrementally:

use duct::cmd;
use std::io::prelude::*;
use std::io::BufReader;

let big_cmd = cmd!("bash", "-c", "echo out && echo err 1>&2");
let reader = big_cmd.stderr_to_stdout().reader()?;
let mut lines = BufReader::new(reader).lines();
assert_eq!(lines.next().unwrap()?, "out");
assert_eq!(lines.next().unwrap()?, "err");

Children that exit with a non-zero status return an error by default:

let result = cmd!("false").run();
assert!(result.is_err());
let result = cmd!("false").unchecked().run();
assert!(result.is_ok());

Dependencies

~0–6.5MB
~36K SLoC