shelle-macros 0.1.1

Proc macros for shelle
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# shelle

[![Crates.io](https://img.shields.io/crates/v/shelle.svg)](https://crates.io/crates/shelle)
[![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](https://opensource.org/licenses/MIT)

Macros for writing shell scripts in Rust.

This project is based on [cmd_lib](https://github.com/rust-shell-script/rust_cmd_lib). Thanks to @tao-guo and other contributors for your hard work.

# Usage

`shelle::exec!()` runs command(s) with stdin/stdout/stderr inherited from the main program:

```rust
let msg = "I love rust";
shelle::exec!(echo #msg)?;
shelle::exec!(echo "This is the message: #msg")?;

// pipe commands are also supported
let dir = "/var/log";
shelle::exec!(du -ah #dir | sort -hr | head -n 10)?;

// or a group of commands
// if any command fails, just return Err(...)
let file = "/tmp/f";
let keyword = "rust";
shelle::exec! {
    cat #{file} | grep #{keyword};
    echo "bad cmd" >&2;
    ignore ls /nofile;
    date;
    ls oops;
    cat oops;
}?;
```

`shelle::eval!()` runs command(s) with stdout piped to a string, and stdin/stderr inherited from the main program:

```rust
let version = shelle::eval!(rustc --version)?;
println!("Your rust version is {}", version);

// with pipes
let n = shelle::eval!(echo "the quick brown fox jumped over the lazy dog" | wc -w)?;
println!("There are {} words in above sentence", n);
```