15 releases (7 stable)

1.1.2 Mar 16, 2024
1.1.1 Nov 9, 2021
1.0.2 Aug 29, 2021
0.13.0 Sep 8, 2020
0.9.0 Sep 5, 2020

#282 in Development tools

Download history 12/week @ 2024-01-01 63/week @ 2024-01-08 91/week @ 2024-01-15 40/week @ 2024-01-22 48/week @ 2024-01-29 33/week @ 2024-02-05 63/week @ 2024-02-12 78/week @ 2024-02-19 134/week @ 2024-02-26 59/week @ 2024-03-04 163/week @ 2024-03-11 652/week @ 2024-03-18 62/week @ 2024-03-25 223/week @ 2024-04-01 73/week @ 2024-04-08 191/week @ 2024-04-15

560 downloads per month
Used in 4 crates (2 directly)

Apache-2.0

17KB
291 lines

command-run

crates.io Documentation

Rust library for running a command in a subprocess.

This library is a thin wrapper around the std::process::Command type with a few additional convenient features:

  • Print or log the command before running it
  • Optionally return an error if the command is not successful
  • Optionally combine stdout and stderr
  • Optionally print the command's output if the command fails
  • The command can be formatted as a command-line string
  • The Command type can be cloned and its fields are public

Dependencies and features

  • log - this is an optional dependency. It can be disabled by turning off the logging feature:

    command-run = { version = "*", default-features = false }
    
  • os_pipe - this dependency is used to implement combine_output.

Example

// This will return an error if the command did not exit successfully
// (controlled with the `check` field).
let output = Command::with_args("echo", &["hello", "world"])
    .enable_capture()
    .run()?;
assert_eq!(output.stdout_string_lossy(), "hello world\n");

Dependencies

~0–9MB
~42K SLoC