podbox-cli 0.7.1

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

use std::path::PathBuf;
use std::process::Command;

use anyhow::Result;

use crate::config::{XdgDirConfig, XdgDirValue};

pub struct ResolvedXdgDir {
    pub path: PathBuf,
    pub read_write: bool,
}

pub struct ResolvedXdgDirs {
    pub documents: Option<ResolvedXdgDir>,
    pub downloads: Option<ResolvedXdgDir>,
    pub pictures: Option<ResolvedXdgDir>,
    pub music: Option<ResolvedXdgDir>,
    pub videos: Option<ResolvedXdgDir>,
    pub desktop: Option<ResolvedXdgDir>,
    pub projects: Option<ResolvedXdgDir>,
}

/// Resolve XDG user directories from the host.
///
/// For each enabled dir, tries in order:
/// 1. Parse `~/.config/user-dirs.dirs`
/// 2. Call `xdg-user-dir <NAME>`
/// 3. Fall back to `~/DirName`
/// 4. If path doesn't exist on disk: `None`
pub fn resolve(config: &XdgDirConfig) -> Result<ResolvedXdgDirs> {
    Ok(ResolvedXdgDirs {
        documents: resolve_dir(&config.documents, "DOCUMENTS", "Documents"),
        downloads: resolve_dir(&config.downloads, "DOWNLOADS", "Downloads"),
        pictures: resolve_dir(&config.pictures, "PICTURES", "Pictures"),
        music: resolve_dir(&config.music, "MUSIC", "Music"),
        videos: resolve_dir(&config.videos, "VIDEOS", "Videos"),
        desktop: resolve_dir(&config.desktop, "DESKTOP", "Desktop"),
        projects: resolve_dir(&config.projects, "PROJECTS", "Projects"),
    })
}

fn resolve_dir(value: &XdgDirValue, xdg_name: &str, fallback_name: &str) -> Option<ResolvedXdgDir> {
    if !value.is_enabled() {
        return None;
    }
    let read_write = value.is_read_write();

    // Try xdg-user-dir
    if let Ok(output) = Command::new("xdg-user-dir").arg(xdg_name).output() {
        let path = String::from_utf8_lossy(&output.stdout).trim().to_string();
        if !path.is_empty() && path != home_dir_str() {
            let p = PathBuf::from(path);
            if p.exists() {
                return Some(ResolvedXdgDir {
                    path: p,
                    read_write,
                });
            }
        }
    }

    // Fallback to ~/DirName
    if let Some(home) = dirs::home_dir() {
        let p = home.join(fallback_name);
        if p.exists() {
            return Some(ResolvedXdgDir {
                path: p,
                read_write,
            });
        }
    }

    None
}

fn home_dir_str() -> String {
    dirs::home_dir()
        .map(|p| p.to_string_lossy().to_string())
        .unwrap_or_default()
}