snipdoc 0.1.12

Code Documentation Made Simple
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

use std::{env, process::Command};

pub fn run(command: &str) -> Result<String, String> {
    if approve_exec_command(command) {
        tracing::debug!(command, "execute snippet content");

        let res = if cfg!(target_os = "windows") {
            Command::new("powershell")
                .args(["-Command", command])
                .output()
                .map_err(|err| err.to_string())?
        } else {
            Command::new("sh")
                .args(["-c", command])
                .output()
                .map_err(|err| err.to_string())?
        };

        if res.status.success() {
            Ok(String::from_utf8_lossy(&res.stdout).to_string())
        } else {
            let err_msg = String::from_utf8_lossy(&res.stderr).to_string();
            Err(err_msg)
        }
    } else {
        Err("command not approved".to_string())
    }
}
fn approve_exec_command(command: &str) -> bool {
    if env::var("SNIPDOC_SKIP_EXEC_COMMANDS").map_or(false, |val| val == "true") {
        true
    } else {
        let question = requestty::Question::confirm("confirm")
            .message(format!(
                "Security Warning: Snipdoc is about to execute the following command: \
                 `{command}`. Do you approve?"
            ))
            .build();

        match requestty::prompt_one(question) {
            Ok(answer) => answer.as_bool().is_some_and(|a| a),
            Err(err) => {
                tracing::debug!(err = %err, "prompt error");
                false
            }
        }
    }
}