# commandspec

Simple Rust macro for building `std::process::Command` objects. Uses macro_rules! and works on stable.

```toml
[dependencies]
commandspec = "0.10"
```

Then:

```rust
#[macro_use]
extern crate commandspec;

use commandspec::CommandSpec; // .execute() method on Command
use std::process::Command;

let result = execute!(
    r"
        cd path/location
        export RUST_LOG=full
        export RUST_BACKTRACE=1
        cargo run {release_flag} --bin {bin_name} -- {args}
    ",
    release_flag=Some("--release"),
    bin_name="binary",
    args=vec!["arg1", "arg2"],
)?;
// result = Ok(()) on success (error code 0), Err(CommandError) for all else
```

Format of the commandspec input, in order:

* (optional) `cd <path>` to set the current working directory of the command, where path can be a literal, a quoted string, or format variable.
* (optional) one or more `export <name>=<value>` lines to set environment variables, with the same formatting options.
* Last, a command you want to invoke, optionally with format arguments.

### Features:

* format-like invocation makes it easy to interpolate variables, with automatic quoting
* Equivalent syntax to shell when prototyping
* Works on stable Rust.

## License

MIT or Apache-2.0, at your option.