repvar 0.14.3

A tiny CLI tool that replaces variables of the style `${KEY}` in text with their respective value. It can also be used as a rust library.
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

// SPDX-FileCopyrightText: 2021-2024 Robin Vobruba <hoijui.quaero@gmail.com>
//
// SPDX-License-Identifier: AGPL-3.0-or-later

use assert_cmd::Command; // Add methods on commands
use predicates::prelude::*; // Used for writing assertions
use std::{
    collections::{HashMap, hash_map::RandomState},
    fs,
    path::Path,
};

pub struct Tester<'a, S = RandomState> {
    cmd: &'a str,
    cwd: Option<&'a str>,
    stdin: Option<&'a str>,
    env_vars: HashMap<&'a str, &'a str, S>,
    args: Vec<&'a str>,
    stdout: Option<&'a str>,
    stderr: Option<&'a str>,
}

impl<'a> Tester<'a> {
    pub fn new(cmd: &'a str) -> Tester<'a> {
        Tester {
            cmd,
            cwd: None,
            stdin: None,
            env_vars: HashMap::new(),
            args: Vec::new(),
            stdout: None,
            stderr: None,
        }
    }

    /// Set the working directory for the child process.
    pub fn cwd(&'a mut self, dir: &'a str) -> &'a mut Tester<'a> {
        self.cwd = Some(dir);
        self
    }

    pub fn stdin(&'a mut self, text: &'a str) -> &'a mut Tester<'a> {
        self.stdin = Some(text);
        self
    }

    /// Add an argument to pass to the program.
    pub fn env(&'a mut self, key: &'a str, value: &'a str) -> &'a mut Tester<'a> {
        self.env_vars.insert(key, value);
        self
    }

    /// Add an argument to pass to the program.
    pub fn arg(&'a mut self, arg: &'a str) -> &'a mut Tester<'a> {
        self.args.push(arg);
        self
    }

    /// Add multiple arguments to pass to the program.
    pub fn args(&'a mut self, args: &[&'a str]) -> &'a mut Tester<'a> {
        self.args.extend_from_slice(args);
        self
    }

    pub fn stdout(&'a mut self, text: &'a str) -> &'a mut Tester<'a> {
        self.stdout = Some(text);
        self
    }

    pub fn stderr(&'a mut self, text: &'a str) -> &'a mut Tester<'a> {
        self.stderr = Some(text);
        self
    }

    pub fn run_test(&self) -> Result<(), Box<dyn std::error::Error>> {
        let mut cmd = Command::cargo_bin(self.cmd)?;
        cmd.env_clear();

        // Prepares the command
        for (key, value) in &self.env_vars {
            cmd.env(key, value);
        }
        for arg in &self.args {
            cmd.arg(arg);
        }
        if let Some(stdin) = self.stdin {
            cmd.write_stdin(stdin);
        }

        // Runs the command
        let mut assert = cmd.assert();

        // Evaluates the command
        assert = if let Some(stdout) = self.stdout {
            assert.stdout(predicate::eq(stdout))
        } else {
            assert.failure()
        };
        if let Some(stderr) = self.stderr {
            assert.stderr(predicate::str::contains(stderr));
        }

        Ok(())
    }
}

pub fn write_to_file(file: &Path, text: &str) {
    fs::write(file, text).expect("Unable to write file");
}