podbox-cli 0.7.0

Declarative Podman-native container environment manager. Define an environment as a TOML file and let systemd own its lifecycle.
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

//! Minimal terminal-output helpers for the podbox CLI.
//!
//! Contract (REVIEW.md "Output and error contract"):
//! - Read commands print data on stdout; diagnostics always go to stderr.
//! - [`step`]/[`ok`] are human progress lines: suppressed by `--quiet`.
//! - [`warn`], [`hint`], and [`error`] are always shown.
//! - Colors use `owo-colors` + `supports-color`, which honor `NO_COLOR`.
//!
//! This module is intentionally not a framework: plain functions, no macros,
//! no global logger. Verbosity beyond progress lines goes through `tracing`.

use std::io::Write;
use std::sync::atomic::{AtomicBool, AtomicU8, Ordering};

use owo_colors::{OwoColorize, Stream};

static QUIET: AtomicBool = AtomicBool::new(false);
static VERBOSE: AtomicU8 = AtomicU8::new(0);

/// Enable/disable quiet mode (wired to the global `--quiet` flag).
pub fn set_quiet(quiet: bool) {
    QUIET.store(quiet, Ordering::Relaxed);
}

pub fn is_quiet() -> bool {
    QUIET.load(Ordering::Relaxed)
}

/// Store the `-v` count (0 = info, 1 = debug, 2+ = trace).
pub fn set_verbose(count: u8) {
    VERBOSE.store(count, Ordering::Relaxed);
}

/// True when any `--verbose` level is active. Long-running child processes
/// (podman build/pull) stream their output to the terminal in this mode
/// instead of being captured to the build log.
pub fn is_verbose() -> bool {
    VERBOSE.load(Ordering::Relaxed) > 0
}

fn write_stderr(line: &str) {
    let _ = writeln!(std::io::stderr(), "{line}");
}

/// Print a progress line ("→ msg") to stderr unless quiet.
pub fn step(msg: &str) {
    if is_quiet() {
        return;
    }
    let glyph = "→".if_supports_color(Stream::Stderr, |t| t.dimmed());
    write_stderr(&format!("{glyph} {msg}"));
}

/// Print a success line ("✔ msg") to stderr unless quiet.
pub fn ok(msg: &str) {
    if is_quiet() {
        return;
    }
    let mark = "✔".if_supports_color(Stream::Stderr, |t| t.green());
    let body = msg.if_supports_color(Stream::Stderr, |t| t.green());
    write_stderr(&format!("{mark} {body}"));
}

/// Print a warning to stderr (never suppressed).
pub fn warn(msg: &str) {
    let mark = "!".if_supports_color(Stream::Stderr, |t| t.yellow());
    let body = msg.if_supports_color(Stream::Stderr, |t| t.yellow());
    write_stderr(&format!("{mark} {body}"));
}

/// Print an actionable hint block to stderr (never suppressed).
// No caller yet: wired up when BuildFailed grows its log-path hint (PR 3)
// and by doctor/recover (PR 5). Part of the module's documented contract.
#[allow(dead_code)]
pub fn hint(lines: &[&str]) {
    if lines.is_empty() {
        return;
    }
    let head = "Hint:".if_supports_color(Stream::Stderr, |t| t.cyan().bold().to_string());
    let mut err = std::io::stderr();
    let _ = writeln!(err, "\n{head} {}", lines[0]);
    for l in &lines[1..] {
        let _ = writeln!(err, "      {l}");
    }
}

/// Print the top-level error line to stderr (never suppressed).
///
/// Used once from `main`; command code should return errors instead of
/// printing them so exit-code mapping stays centralized.
pub fn error(msg: &str) {
    let head = "Error:".if_supports_color(Stream::Stderr, |t| t.red().bold().to_string());
    write_stderr(&format!("\n{head} {msg}"));
}