[−][src]Crate duct
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™.
Changelog
- v0.13.3
- Added
Handle::pids
andReaderHandle::pids
.
- Added
- v0.13.2
- Added
ReaderHandle::try_wait
. - Debug output for
Expression
is more concise.
- Added
- v0.13.1
- Added
ReaderHandle::kill
. - Kill methods no longer wait on IO threads to complete. This avoids blocking on unkilled grandchildren.
- Added
- v0.13.0
- The
kill
method now reaps killed child processes before returning. - Removed the
then
method. - Added
ReaderHandle
andExpression::reader
. - Added
Expression::stdout_stderr_swap
. - Renamed
stdin
/stdout
/stderr
tostdin_path
/stdout_path
/stderr_path
. - Renamed
stdin_handle
/stdout_handle
/stderr_handle
tostdin_file
/stdout_file
/stderr_file
. - Renamed
input
tostdin_bytes
. - Renamed
Handle::output
toHandle::into_output
.
- The
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());
Modules
unix | Unix-specific extensions to duct, for sending signals. |
Macros
cmd | Create a command with any number of of positional arguments, which may be
different types (anything that implements
|
Structs
Expression | The central objects in Duct, Expressions are created with
|
Handle | A handle to a running expression, returned by the
|
ReaderHandle | An incremental reader created with the
|
Traits
IntoExecutablePath | An implementation detail of |
Functions
cmd | Create a command given a program name and a collection of arguments. See
also the |