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
95
96
97
98
99
100
101

use std::path::PathBuf;

/// A named, ready-to-use configuration template.
pub struct Profile {
    pub name: String,
    pub label: String,
    pub description: String,
    pub toml: String,
}

/// List all available profiles (bundled + user-defined).
pub fn all() -> Vec<Profile> {
    let mut profiles = vec![cachy(), fedora(), ubuntu(), dev()];
    profiles.extend(user_profiles());
    profiles
}

/// Find a profile by name (case-insensitive).
pub fn find(name: &str) -> Option<Profile> {
    let lower = name.to_lowercase();
    // Check bundled first, then user-defined
    for p in [cachy(), fedora(), ubuntu(), dev()] {
        if p.name == lower {
            return Some(p);
        }
    }
    user_profiles().into_iter().find(|p| p.name == lower)
}

fn user_profiles_dir() -> PathBuf {
    crate::config::config_dir().join("profiles")
}

fn user_profiles() -> Vec<Profile> {
    let dir = user_profiles_dir();
    if !dir.is_dir() {
        return vec![];
    }
    let mut profiles = Vec::new();
    if let Ok(entries) = std::fs::read_dir(&dir) {
        for entry in entries.flatten() {
            let path = entry.path();
            if path.extension().map(|e| e == "toml").unwrap_or(false) {
                if let Ok(content) = std::fs::read_to_string(&path) {
                    let name = path
                        .file_stem()
                        .map(|s| s.to_string_lossy().to_lowercase())
                        .unwrap_or_default();
                    profiles.push(Profile {
                        label: name.clone(),
                        description: format!("User-defined profile ({name})"),
                        toml: content,
                        name,
                    });
                }
            }
        }
    }
    profiles
}

fn cachy() -> Profile {
    Profile {
        name: "cachy".into(),
        label: "CachyOS".into(),
        description: "CachyOS-based environment optimized for gaming".into(),
        toml: include_str!("profiles/cachy.toml").into(),
    }
}

fn fedora() -> Profile {
    Profile {
        name: "fedora".into(),
        label: "Fedora".into(),
        description: "Fedora-based general-purpose environment".into(),
        toml: include_str!("profiles/fedora.toml").into(),
    }
}

fn ubuntu() -> Profile {
    Profile {
        name: "ubuntu".into(),
        label: "Ubuntu".into(),
        description: "Ubuntu-based general-purpose environment".into(),
        toml: include_str!("profiles/ubuntu.toml").into(),
    }
}

fn dev() -> Profile {
    Profile {
        name: "dev".into(),
        label: "Dev".into(),
        description: "CachyOS-based development environment with mise, neovim, git, and dev tooling pre-installed".into(),
        toml: include_str!("profiles/dev.toml").into(),
    }
}

/// List profile names for tab completion / CLI hints.
pub fn list_names() -> Vec<String> {
    all().into_iter().map(|p| p.name).collect()
}