btl 0.2.6

Github Repo: https://github.com/znx3p0/btlsh Btl is a simple library that makes shell scripting with rust easier. It was originally written with the purposes of being used for build.rs files, but it can be used for more complex purposes. It's main premise is about making shell scripting easier to work with rust. This works both on windows and unix machines. Originally designed in linux, not tested on Windows or Mac yet, but they should work since the library is platform-agnostic.
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

#[cfg(test)]

mod tests {

    use btl::*;

    #[test]
    fn test() {
        let foo = 2;
        let bar = 5;

        // Syntax:
        // You have to call the macro followed by a command.
        // This command can be used as a format! format string

        // Variables you use in the format string need to be after
        // the command and need to be separated by spaces. No commas.
        // Commands are separated by semicolons and they're obligatory.
        shell! {
            "pwd";
            "cd ..";
            "pwd";
            "echo {} > example.txt" foo;
        };

        // The pwd macro gives back the current working directory. Nothing fancy.
        let curr = pwd!();
        println!("Current dir through macro: {:?}", curr);

        // The second macro is detach!{}
        // This is equivalent to shell in syntax and in execution.
        // The difference is that this shell process is completely separated
        // from the rust process and can outlive the rust process.

        // This is exceptionally useful for creating programs which outlive the main process.
        detach! {
            "touch example.txt";
            "sleep {}" bar;
            "rm example.txt";
        };

        // The third macro is execute!{}
        // It's got the same syntax as all macros, but it returns the stdout as a String
        let contents = execute! {
            "ls -la";
        };
        println!("Current directory's contents: {}", contents);

        // The fourth macro is exec!{}
        // It's the same as all macros, but it returns a bool indicating if the command succeded.
        if exec! {
            "ls -la | grep Cargo";
        } {
            println!("Cargo found");
        } else {
            println!("Cargo not found");
        }

        shell! {
            "pwd";
        };

        // The cd macro changes the directory of the current rust process.
        // This does not work for shell or any of the other macros.
        // Only works as a helper macro to make it easier to use cd inside rust.
        // You can still use all normal commands, including cd inside all macros.
        // They just don't change the rust's process directory.
        // That's this macro's purpose.
        let dir = "..";
        cd! {
            "{}" dir
        };

        shell! {
            "echo CURRENT DIR $(pwd)";
        };

        cd! {
            "{}" curr
        };
        // println!("Now in the original directory");
        shell! {
            "echo CURRENT DIR $(pwd)";
        };

        // The next macro is detailed_exec!{}
        // It's the same as all macros, but it returns a std::process::Output
        let out: std::process::Output = detailed_exec! {
            "pwd";
        };
        println!("{:#?}", out);
    }
}