124 lines
3.7 KiB
Python
124 lines
3.7 KiB
Python
"""Paths, persistent settings and tiny cache helpers.
|
|
|
|
Everything lives in the usual XDG places:
|
|
|
|
~/.config/somafm-tui/config.json favourites, volume, last station
|
|
~/.cache/somafm-tui/channels.json last good copy of somafm.com/channels.json
|
|
~/.cache/somafm-tui/playlists.json resolved .pls -> stream URLs
|
|
~/.cache/somafm-tui/songs/<id>.json last good copy of the song history
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import contextlib
|
|
import json
|
|
import os
|
|
from dataclasses import asdict, dataclass, field
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
APP_NAME = "somafm-tui"
|
|
|
|
|
|
def _xdg(env_var: str, fallback: str) -> Path:
|
|
value = os.environ.get(env_var)
|
|
if value:
|
|
return Path(value).expanduser()
|
|
return Path.home() / fallback
|
|
|
|
|
|
CONFIG_DIR = _xdg("XDG_CONFIG_HOME", ".config") / APP_NAME
|
|
CACHE_DIR = _xdg("XDG_CACHE_HOME", ".cache") / APP_NAME
|
|
RUNTIME_DIR = Path(os.environ.get("XDG_RUNTIME_DIR") or "/tmp") / APP_NAME
|
|
|
|
CONFIG_PATH = CONFIG_DIR / "config.json"
|
|
CHANNELS_CACHE = CACHE_DIR / "channels.json"
|
|
PLAYLIST_CACHE = CACHE_DIR / "playlists.json"
|
|
SONGS_CACHE_DIR = CACHE_DIR / "songs"
|
|
|
|
VISUALIZERS = ("both", "bars", "wave")
|
|
|
|
|
|
def ensure_dirs() -> None:
|
|
for directory in (CONFIG_DIR, CACHE_DIR, SONGS_CACHE_DIR):
|
|
with contextlib.suppress(OSError):
|
|
directory.mkdir(parents=True, exist_ok=True)
|
|
|
|
|
|
def atomic_write_text(path: Path, text: str) -> None:
|
|
"""Write ``text`` to ``path`` without ever leaving a half-written file."""
|
|
path.parent.mkdir(parents=True, exist_ok=True)
|
|
tmp = path.with_name(f".{path.name}.tmp")
|
|
tmp.write_text(text, encoding="utf-8")
|
|
os.replace(tmp, path)
|
|
|
|
|
|
def read_json(path: Path) -> Any:
|
|
try:
|
|
return json.loads(path.read_text(encoding="utf-8"))
|
|
except (OSError, ValueError):
|
|
return None
|
|
|
|
|
|
def write_json(path: Path, payload: Any) -> None:
|
|
with contextlib.suppress(OSError):
|
|
atomic_write_text(path, json.dumps(payload, indent=2, ensure_ascii=False))
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class Config:
|
|
favorites: list[str] = field(default_factory=list)
|
|
last_station: str = "groovesalad"
|
|
volume: int = 70
|
|
visualizer: str = "both"
|
|
autoplay: bool = False
|
|
mpris: bool = True
|
|
|
|
@classmethod
|
|
def load(cls) -> Config:
|
|
raw = read_json(CONFIG_PATH)
|
|
config = cls()
|
|
if not isinstance(raw, dict):
|
|
return config
|
|
|
|
favorites = raw.get("favorites")
|
|
if isinstance(favorites, list):
|
|
config.favorites = [str(item) for item in favorites if isinstance(item, str)]
|
|
|
|
last_station = raw.get("last_station")
|
|
if isinstance(last_station, str) and last_station:
|
|
config.last_station = last_station
|
|
|
|
volume = raw.get("volume")
|
|
if isinstance(volume, (int, float)):
|
|
config.volume = max(0, min(100, int(volume)))
|
|
|
|
visualizer = raw.get("visualizer")
|
|
if visualizer in VISUALIZERS:
|
|
config.visualizer = visualizer
|
|
|
|
if isinstance(raw.get("autoplay"), bool):
|
|
config.autoplay = raw["autoplay"]
|
|
if isinstance(raw.get("mpris"), bool):
|
|
config.mpris = raw["mpris"]
|
|
return config
|
|
|
|
def save(self) -> None:
|
|
try:
|
|
ensure_dirs()
|
|
atomic_write_text(
|
|
CONFIG_PATH, json.dumps(asdict(self), indent=2, ensure_ascii=False)
|
|
)
|
|
except OSError:
|
|
pass
|
|
|
|
def is_favorite(self, station_id: str) -> bool:
|
|
return station_id in self.favorites
|
|
|
|
def toggle_favorite(self, station_id: str) -> bool:
|
|
if station_id in self.favorites:
|
|
self.favorites.remove(station_id)
|
|
return False
|
|
self.favorites.append(station_id)
|
|
return True
|