ommp 0.1.3

Oh My Music Player — a terminal music player built with ratatui
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
102
103
104
105
106
107
108
109
110
111
112
113

use serde::{Deserialize, Serialize};
use std::fs;
use std::path::PathBuf;

/// Every field defaults, so a state file written by an older build — or one
/// missing a key — restores what it can instead of dropping the whole session.
#[derive(Serialize, Deserialize)]
pub struct SavedState {
    #[serde(default = "default_volume")]
    pub volume: f32,
    #[serde(default)]
    pub shuffle: bool,
    #[serde(default = "default_repeat")]
    pub repeat: String,
    #[serde(default = "default_pane_widths")]
    pub pane_widths: [u16; 3],
    #[serde(default)]
    pub playlists: Vec<SavedPlaylist>,
    #[serde(default = "default_info_view")]
    pub info_view: String,
    #[serde(default = "default_right_split")]
    pub right_split: u16,
}

fn default_volume() -> f32 {
    0.5
}

fn default_repeat() -> String {
    "Off".to_string()
}

pub const DEFAULT_PANE_WIDTHS: [u16; 3] = [20, 60, 20];

fn default_pane_widths() -> [u16; 3] {
    DEFAULT_PANE_WIDTHS
}

fn default_info_view() -> String {
    "Clock".to_string()
}

fn default_right_split() -> u16 {
    50
}

#[derive(Serialize, Deserialize)]
pub struct SavedPlaylist {
    pub name: String,
    pub tracks: Vec<PathBuf>,
}

/// Pane widths must each clear the 10% minimum the resize code assumes and sum
/// to exactly 100; anything else makes `LayoutAreas` produce degenerate rects
/// and the border-drag math underflow. Reject rather than try to repair.
pub fn sane_pane_widths(w: [u16; 3]) -> [u16; 3] {
    if w.iter().all(|&p| p >= 10) && w.iter().sum::<u16>() == 100 {
        w
    } else {
        DEFAULT_PANE_WIDTHS
    }
}

fn state_path() -> PathBuf {
    let home = std::env::var("HOME").unwrap_or_else(|_| ".".to_string());
    PathBuf::from(home).join(".config/ommp/state.json")
}

pub fn save(state: &SavedState) -> anyhow::Result<()> {
    let path = state_path();
    if let Some(parent) = path.parent() {
        fs::create_dir_all(parent)?;
    }
    let json = serde_json::to_string_pretty(state)?;
    // Write-then-rename: a crash or full disk mid-write leaves the previous
    // state file intact instead of a truncated one that parses to nothing.
    let tmp = path.with_extension("json.tmp");
    fs::write(&tmp, json)?;
    fs::rename(&tmp, &path)?;
    Ok(())
}

pub fn load() -> Option<SavedState> {
    let path = state_path();
    let data = fs::read_to_string(path).ok()?;
    serde_json::from_str(&data).ok()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn pane_widths_reject_anything_layout_cannot_use() {
        assert_eq!(sane_pane_widths([20, 60, 20]), [20, 60, 20]);
        assert_eq!(sane_pane_widths([10, 80, 10]), [10, 80, 10]);
        // Below the 10% floor the resize math underflows.
        assert_eq!(sane_pane_widths([10, 5, 85]), DEFAULT_PANE_WIDTHS);
        // Sums that are not 100 leave the dashboard with a gap or overflow.
        assert_eq!(sane_pane_widths([20, 20, 20]), DEFAULT_PANE_WIDTHS);
        assert_eq!(sane_pane_widths([0, 0, 0]), DEFAULT_PANE_WIDTHS);
    }

    #[test]
    fn missing_fields_fall_back_instead_of_dropping_the_file() {
        let saved: SavedState = serde_json::from_str(r#"{"volume":0.25}"#).unwrap();
        assert_eq!(saved.volume, 0.25);
        assert_eq!(saved.repeat, "Off");
        assert_eq!(saved.pane_widths, DEFAULT_PANE_WIDTHS);
        assert_eq!(saved.right_split, 50);
        assert!(saved.playlists.is_empty());
    }
}