dapctl 1.0.0

TUI/CLI sync tool for HiFi Digital Audio Players
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

pub mod builtin;
pub mod schema;

use crate::error::DapError;

pub use schema::{Codecs, DapHeader, DapProfile, Exclude, Filesystem, Layout, Quirks};

// ---------------------------------------------------------------------------
// Loading
// ---------------------------------------------------------------------------

/// Load a DAP profile by id.
/// Checks `$XDG_CONFIG_HOME/dapctl/profiles/<id>.toml` first (user override),
/// then falls back to the builtin catalogue embedded at compile time.
pub fn load(id: &str) -> anyhow::Result<DapProfile> {
    if let Some(p) = load_user_override(id)? {
        tracing::debug!(dap_id = id, source = "user-override", "loaded DAP profile");
        return Ok(p);
    }
    let p = load_builtin(id)?;
    tracing::debug!(dap_id = id, source = "builtin", "loaded DAP profile");
    Ok(p)
}

/// List ids of all known DAP profiles: builtins first, then user overrides
/// (overrides that shadow a builtin appear only once).
pub fn list() -> anyhow::Result<Vec<String>> {
    let mut ids: Vec<String> = builtin::ALL.iter().map(|(id, _)| id.to_string()).collect();

    let Some(dirs) = directories::ProjectDirs::from("", "", "dapctl") else {
        return Ok(ids);
    };
    let override_dir = dirs.config_dir().join("profiles");
    if override_dir.exists() {
        for entry in std::fs::read_dir(&override_dir)? {
            let entry = entry?;
            let path = entry.path();
            if path.extension().and_then(|e| e.to_str()) == Some("toml") {
                if let Some(stem) = path.file_stem().and_then(|s| s.to_str()) {
                    let stem = stem.to_owned();
                    if !ids.contains(&stem) {
                        ids.push(stem);
                    }
                }
            }
        }
    }
    ids.sort();
    Ok(ids)
}

// ---------------------------------------------------------------------------
// Internal helpers
// ---------------------------------------------------------------------------

fn load_builtin(id: &str) -> anyhow::Result<DapProfile> {
    let toml_str = builtin::ALL
        .iter()
        .find(|(bid, _)| *bid == id)
        .map(|(_, s)| *s)
        .ok_or_else(|| DapError::UnknownId { id: id.to_owned() })?;

    toml::from_str(toml_str).map_err(|e| {
        anyhow::Error::from(DapError::ParseBuiltin {
            id: id.to_owned(),
            reason: e.to_string(),
        })
    })
}

fn load_user_override(id: &str) -> anyhow::Result<Option<DapProfile>> {
    let Some(dirs) = directories::ProjectDirs::from("", "", "dapctl") else {
        return Ok(None);
    };
    let path = dirs
        .config_dir()
        .join("profiles")
        .join(format!("{id}.toml"));
    if !path.exists() {
        return Ok(None);
    }
    let content = std::fs::read_to_string(&path).map_err(|e| DapError::ReadOverride {
        path: path.clone(),
        source: e,
    })?;
    let profile: DapProfile = toml::from_str(&content).map_err(|e| DapError::InvalidOverride {
        path: path.clone(),
        reason: e.to_string(),
    })?;
    Ok(Some(profile))
}