Test CLI Applications.
Currently, this crate only includes basic functionality to check the output of a child process is as expected.
Just add it to your Cargo.toml:
toml
[dependencies]
assert_cli = "0.3"
Here's a trivial example:
rust
extern crate assert_cli;
fn main() {
assert_cli::assert_cli_output("echo", &["42"], "42").unwrap();
}
Or if you'd rather use the macro:
```rust,ignore
fn main() { assertcli!("echo", &["42"] => Success, "42").unwrap(); assertcli!("black-box", &["--special"] => Error 42, "error no 42\n").unwrap() } ```
And here is one that will fail:
rust,should_panic
extern crate assert_cli;
fn main() {
assert_cli::assert_cli_output("echo", &["42"], "1337").unwrap();
}
this will show a nice, colorful diff in your terminal, like this:
diff
-1337
+42
If you'd prefer to not check the output:
```rust
fn main() { assertcli::assertcli("echo", &["42"]).unwrap(); assert_cli!("echo", &["42"] => Success).unwrap(); } ```
All exported functions and the macro return a Result containing the
Output of the process, allowing you to do further custom assertions:
```rust
fn main() { let output = assertcli!("echo", &["Number 42"] => Success).unwrap(); let stdout = std::str::fromutf8(&output.stdout).unwrap(); assert!(stdout.contains("42")); } ```
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.