bashkit 0.5.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

//! Virtual Identity Configuration Example
//!
//! Demonstrates how to configure custom username and hostname for the virtual environment.
//! This is useful for simulating specific environments or user contexts.
//!
//! Run with: cargo run --example virtual_identity

use bashkit::Bash;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    println!("=== Default Virtual Identity ===\n");

    // Default virtual identity
    let mut bash = Bash::new();

    let result = bash.exec("whoami").await?;
    println!("whoami: {}", result.stdout.trim());

    let result = bash.exec("hostname").await?;
    println!("hostname: {}", result.stdout.trim());

    let result = bash.exec("id").await?;
    println!("id: {}", result.stdout.trim());

    let result = bash.exec("uname -n").await?;
    println!("uname -n: {}", result.stdout.trim());

    println!("\n=== Custom Virtual Identity ===\n");

    // Custom username and hostname
    let mut bash = Bash::builder()
        .username("deploy")
        .hostname("prod-server-01")
        .build();

    let result = bash.exec("whoami").await?;
    println!("whoami: {}", result.stdout.trim());

    let result = bash.exec("hostname").await?;
    println!("hostname: {}", result.stdout.trim());

    let result = bash.exec("id").await?;
    println!("id: {}", result.stdout.trim());

    let result = bash.exec("uname -n").await?;
    println!("uname -n: {}", result.stdout.trim());

    // USER env var is automatically set
    let result = bash.exec("echo $USER").await?;
    println!("$USER: {}", result.stdout.trim());

    println!("\n=== Multi-Tenant Isolation ===\n");

    // Each tenant gets their own identity
    let mut tenant_a = Bash::builder()
        .username("alice")
        .hostname("tenant-a.example.com")
        .build();

    let mut tenant_b = Bash::builder()
        .username("bob")
        .hostname("tenant-b.example.com")
        .build();

    let result_a = tenant_a.exec("whoami && hostname").await?;
    let result_b = tenant_b.exec("whoami && hostname").await?;

    println!(
        "Tenant A: {}",
        result_a.stdout.replace('\n', ", ").trim_end_matches(", ")
    );
    println!(
        "Tenant B: {}",
        result_b.stdout.replace('\n', ", ").trim_end_matches(", ")
    );

    Ok(())
}