#command #macro #shell #process #dsl


Macros for creating std::process::Command with shell-like syntax

18 releases

0.2.7 Sep 17, 2019
0.2.6 Oct 9, 2018
0.2.4 Jul 22, 2018
0.1.11 Mar 13, 2018
0.1.5 Jul 29, 2016

#15 in Procedural macros

Download history 71/week @ 2019-12-01 287/week @ 2019-12-08 23/week @ 2019-12-15 39/week @ 2019-12-22 36/week @ 2019-12-29 76/week @ 2020-01-05 163/week @ 2020-01-12 141/week @ 2020-01-19 66/week @ 2020-01-26 101/week @ 2020-02-02 71/week @ 2020-02-09 136/week @ 2020-02-16 187/week @ 2020-02-23 22/week @ 2020-03-01 39/week @ 2020-03-08 26/week @ 2020-03-15

428 downloads per month
Used in macos-profiler

MIT license

239 lines


documentation, crate

Macros for creating std::process::Command with shell-like syntax. Created to make using Rust as a scripting language more pleasant.

This crate contains two macros, command!() – fully-featured, but requires nightly, and a simpler cmd!(), built by macro_rules.


Build Status


This macro requires nightly Rust and enabling a "nightly" feature. Put the following in your Cargo.toml.

version = "0.2.7"
features = ["nightly"]

And then add on top of your root module:


extern crate command_macros;

use command_macros::command;

If you're not running the latest nightly, try the following versions:

nightly date command-macros version
2018-10-06 — 0.2.7
2018-10-06 — 2019-08-27 0.2.6
2018-10-04 — 2018-10-05 0.2.5
2018-07-17 — 2018-10-03 0.2.4
2018-05-17 — 2018-07-16 0.2.3
2018-04-07 — 2018-05-16 0.2.2


    ffmpeg -i (file)
    -c:v libx264 -preset (preset) [moreargs]
    -c:a copy

should be roughly equivalent to running

    .args(&["-i", &file])
    .args(&["-c:v", "libx264", "-preset", &preset])
    .args(&["-c:a", "copy"])
    .arg(&format!("file:{}", tmpname))

As you see, you use (expr) to create an argument (or a part of it) from arbitrary Rust expression and [expr] for multiple arguments. The & is added automatically, similarly to how print! works.

Moreover, command! will handle file and tmpname being OsStr correctly, while the manual version would require some modifications.

Additionally, you can use if, if let, match and for. This snippet also showcases (( expr )) feature.

    if let Some(n) = n_cores { -j ((n + 1)) }

Both macros return Command by value, so you can store them in a variable for later:

let cmd = command!(mkv --fs);

If you have partially prepared command (Command or &mut Command), you can also pass it to this macro:

let base: Command = prepare();
let cmd = command!({base} install (package));



Put the following in your Cargo.toml.

command-macros = "0.2"

And then add on top of your root module:

#[macro_use] extern crate command_macros;


This macro is a "lite" version of the command!. Differences:

  • Worse error messages.
  • It is whitespace-insensitive.
  • Creating arguments from arbitrary tokens (such as -c:a) is not supported (only idents). The workaround is to use Rust string as an expression: ("-c:a").
  • ((expr)) and (expr) always evaluate to full argument (no tricks like file:(filename)).
  • Expressions in if, match and for have to be surrounded by parens.
  • No support for else if (use else { if ... } instead).

Besides, all other features should work.


Examples from command! section rewritten to match cmd! syntax:

    ffmpeg ("-i") (file)
    ("-c:v") libx264 ("-preset") (preset) [moreargs]
    ("-c:a") copy
    (format!("file:{}", tmpname))
    if let Some(n) = (n_cores) { ("-j") ((n + 1)) }