# Assert CLI
> Test CLI Applications.
Currently, this crate only includes basic functionality to check the output of a child process
is as expected.
[](https://travis-ci.org/killercup/assert_cli) [](https://coveralls.io/github/killercup/assert_cli?branch=master)
**[Documentation](http://killercup.github.io/assert_cli/)**
## Install
Just add it to your `Cargo.toml`:
```toml
[dependencies]
assert_cli = "0.1.0"
```
## Example
Here's a trivial example:
```rust
extern crate assert_cli;
assert_cli::assert_cli_output("echo", &["42"], "42").unwrap();
```
Or if you'd rather use the macro:
```rust,ignore
#[macro_use] extern crate assert_cli;
assert_cli!("echo", &["42"] => Success, "42").unwrap();
assert_cli!("black-box", &["--special"] => Error 42, "error no 42\n").unwrap()
```
And here is one that will fail:
```rust,should_panic
extern crate assert_cli;
assert_cli::assert_cli_output("echo", &["42"], "1337").unwrap();
```
this will show a nice, colorful diff in your terminal, like this:
```diff
-1337
+42
```
## License
MIT