pacsea 0.8.2

A fast, friendly TUI for browsing and installing Arch and AUR packages with built-in news and security scanning
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

//! Command execution utilities for service resolution.

use std::process::Command;
use tracing::{debug, warn};

/// What: Execute a command and capture stdout as UTF-8.
///
/// Inputs:
/// - `program`: Binary to execute.
/// - `args`: Command-line arguments.
/// - `display_label`: Human-friendly command description for logging.
///
/// Output:
/// - Stdout as a `String` on success; error description otherwise.
///
/// Details:
/// - Annotates errors with the supplied `display` string for easier debugging.
pub(super) fn run_command(
    program: &str,
    args: &[&str],
    display_label: &str,
) -> Result<String, String> {
    debug!(
        command = program,
        args = ?args,
        display = display_label,
        "executing service command"
    );

    let output = Command::new(program).args(args).output().map_err(|err| {
        warn!(
            command = program,
            args = ?args,
            display = display_label,
            error = %err,
            "failed to spawn command"
        );
        format!("failed to spawn `{display_label}`: {err}")
    })?;

    let status_code = output.status.code();
    let stdout_len = output.stdout.len();
    let stderr_len = output.stderr.len();

    if !output.status.success() {
        warn!(
            command = program,
            args = ?args,
            display = display_label,
            status = ?output.status,
            status_code,
            stdout_len,
            stderr_len,
            "command exited with non-zero status"
        );
        return Err(format!(
            "`{display_label}` exited with status {}",
            output.status
        ));
    }

    debug!(
        command = program,
        args = ?args,
        display = display_label,
        status = ?output.status,
        status_code,
        stdout_len,
        stderr_len,
        "command completed successfully"
    );

    String::from_utf8(output.stdout).map_err(|err| {
        warn!(
            command = program,
            args = ?args,
            display = display_label,
            error = %err,
            "command produced invalid UTF-8"
        );
        format!("`{display_label}` produced invalid UTF-8: {err}")
    })
}