xbp 10.46.0

XBP is a zero-config build pack that can also interact with proxies, kafka, sockets, synthetic monitors.
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

pub mod command;
pub mod network;
pub mod network_hetzner;
pub mod nginx;
pub mod pm2;

use std::process::Output;

/// Process-wide override for network config path roots (tests only).
/// Shared by `network` and `network_hetzner` so path mapping stays consistent.
pub(crate) const NETWORK_TEST_ROOT_ENV: &str = "XBP_NETWORK_TEST_ROOT";

/// Serialize tests that mutate [`NETWORK_TEST_ROOT_ENV`]. Both network modules
/// used separate mutexes, which raced under `cargo test` and flaked backend detection.
#[cfg(test)]
pub(crate) fn network_test_env_lock() -> std::sync::MutexGuard<'static, ()> {
    use std::sync::{Mutex, OnceLock};
    static LOCK: OnceLock<Mutex<()>> = OnceLock::new();
    LOCK.get_or_init(|| Mutex::new(()))
        .lock()
        .unwrap_or_else(|poisoned| poisoned.into_inner())
}

pub(crate) fn decode_output(bytes: &[u8]) -> String {
    let text = String::from_utf8_lossy(bytes).trim().to_string();
    if text.is_empty() {
        "(empty)".to_string()
    } else {
        text
    }
}

pub(crate) fn command_debug_log(
    debug: bool,
    program: &str,
    args: &[&str],
    output: &Output,
    logger: impl FnOnce(String),
) {
    if !debug {
        return;
    }
    logger(format!(
        "{} {} -> status={} stdout='{}' stderr='{}'",
        program,
        args.join(" "),
        output.status,
        decode_output(&output.stdout),
        decode_output(&output.stderr)
    ));
}

pub(crate) fn command_failure_message(
    program: &str,
    args: &[&str],
    output: &Output,
    hint: Option<&str>,
) -> String {
    let stderr = decode_output(&output.stderr);
    let stdout = decode_output(&output.stdout);
    let mut message = format!(
        "{} {} failed with status {}.\nstdout: {}\nstderr: {}",
        program,
        args.join(" "),
        output.status,
        stdout,
        stderr
    );
    if let Some(hint) = hint {
        message.push_str(&format!("\nhelp: {}", hint));
    }
    message
}