bashkit 0.12.0

Awesomely fast virtual sandbox with bash and file system
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

//! Tests for /dev/urandom raw byte handling

use bashkit::Bash;

/// Issue #811: /dev/urandom should return raw bytes, not UTF-8 replacement chars
#[tokio::test]
async fn urandom_no_replacement_chars() {
    let mut bash = Bash::new();
    // Read 100 bytes and check output via od
    let result = bash
        .exec("head -c 100 /dev/urandom | od -A n -t x1 | tr -d ' \\n'")
        .await
        .unwrap();
    let hex = result.stdout.trim();
    // Should not contain the UTF-8 replacement character pattern efbfbd
    assert!(
        !hex.contains("efbfbd"),
        "Output should not contain UTF-8 replacement chars: {}",
        &hex[..hex.len().min(60)]
    );
}

/// Issue #811: head -c N /dev/urandom should return exactly N chars
/// (each original byte maps to one char in the Latin-1 model)
#[tokio::test]
async fn urandom_head_char_count() {
    let mut bash = Bash::new();
    for n in [1, 4, 8, 16, 32] {
        let result = bash
            .exec(&format!("head -c {n} /dev/urandom | wc -m"))
            .await
            .unwrap();
        let count: usize = result.stdout.trim().parse().unwrap_or(0);
        assert_eq!(
            count, n,
            "head -c {n} /dev/urandom | wc -m should produce exactly {n} chars"
        );
    }
}

/// Issue #811: tr -dc 'a-z0-9' < /dev/urandom | head -c 8 should produce 8 alphanumeric chars
#[tokio::test]
async fn urandom_tr_filter_alphanumeric() {
    let mut bash = Bash::new();
    let result = bash
        .exec("LC_ALL=C tr -dc 'a-z0-9' < /dev/urandom | head -c 8")
        .await
        .unwrap();
    let output = result.stdout.trim();
    assert_eq!(
        output.len(),
        8,
        "Should produce exactly 8 chars, got {}: {:?}",
        output.len(),
        output
    );
    assert!(
        output
            .chars()
            .all(|c| c.is_ascii_lowercase() || c.is_ascii_digit()),
        "All chars should be a-z0-9, got: {:?}",
        output
    );
}

/// Regression: valid UTF-8 file contents must not be decoded as Latin-1 mojibake.
#[tokio::test]
async fn utf8_file_reads_do_not_mojibake() {
    use std::path::Path;

    let mut bash = Bash::new();
    let fs = bash.fs();
    fs.write_file(Path::new("/tmp/utf8.txt"), "café\n".as_bytes())
        .await
        .unwrap();

    let result = bash.exec("cat < /tmp/utf8.txt").await.unwrap();
    assert_eq!(result.exit_code, 0);
    assert_eq!(result.stdout, "café\n");

    let result = bash.exec("head -n 1 /tmp/utf8.txt").await.unwrap();
    assert_eq!(result.exit_code, 0);
    assert_eq!(result.stdout, "café\n");
}

/// Regression: UTF-8 shell script files should parse their non-ASCII literals intact.
#[tokio::test]
async fn utf8_script_file_decodes_as_utf8() {
    use std::path::Path;

    let mut bash = Bash::new();
    let fs = bash.fs();
    fs.write_file(Path::new("/tmp/script.sh"), "echo café\n".as_bytes())
        .await
        .unwrap();

    let result = bash.exec("bash /tmp/script.sh").await.unwrap();
    assert_eq!(result.exit_code, 0);
    assert_eq!(result.stdout, "café\n");
}