selene_core/
lib.rs

1use std::{
2    path::{Path, PathBuf},
3    sync::LazyLock,
4};
5
6use directories::{BaseDirs, UserDirs};
7
8pub const PROGRAM_FS_NAME: &str = "selene";
9pub const PROGRAM_DISPLAY_NAME: &str = "Selene";
10
11#[cfg(feature = "lrclib")]
12pub mod lrclib;
13
14#[cfg(feature = "lastfm")]
15pub mod scrobbling;
16
17pub mod config;
18pub mod database;
19pub mod library;
20pub mod media_container;
21pub mod synced_lyrics;
22pub mod utils;
23
24pub mod symphonia_helpers;
25
26#[cfg(any(feature = "lrclib", feature = "lastfm"))]
27static REQWEST_CLIENT: LazyLock<reqwest::Client> = LazyLock::new(|| {
28    reqwest::Client::builder()
29        .user_agent(format!(
30            "{PROGRAM_DISPLAY_NAME} v{ver} (https://codeberg.org/CrypticCreator/Selene)",
31            ver = env!("CARGO_PKG_VERSION")
32        ))
33        .build()
34        .unwrap()
35});
36
37static BASE_DIRS: LazyLock<Option<BaseDirs>> = LazyLock::new(BaseDirs::new);
38
39/// Returns the users `base_dirs`
40///
41/// # Panics
42///
43/// Panics if the internal `BASE_DIRS` static is [`None`]. This can only happen if the home directory is not found
44#[must_use]
45pub fn base_dirs() -> &'static BaseDirs {
46    BASE_DIRS.as_ref().unwrap()
47}
48
49#[must_use]
50pub fn config_dir() -> &'static Path {
51    &CONFIG_DIR
52}
53static CONFIG_DIR: LazyLock<PathBuf> = LazyLock::new(|| {
54    let config_dir = base_dirs().config_dir();
55    if config_dir == base_dirs().data_dir() {
56        DATA_DIR.join("config")
57    } else {
58        config_dir.join(PROGRAM_FS_NAME)
59    }
60});
61
62#[must_use]
63pub fn data_dir() -> &'static Path {
64    &DATA_DIR
65}
66static DATA_DIR: LazyLock<PathBuf> = LazyLock::new(|| base_dirs().data_dir().join(PROGRAM_FS_NAME));
67
68pub fn state_dir() -> &'static Path {
69    &STATE_DIR
70}
71static STATE_DIR: LazyLock<PathBuf> = LazyLock::new(|| {
72    base_dirs()
73        .state_dir()
74        .map_or(DATA_DIR.join("state"), |p| p.join(PROGRAM_FS_NAME))
75});
76
77#[must_use]
78pub fn cache_dir() -> PathBuf {
79    base_dirs().cache_dir().join(PROGRAM_FS_NAME)
80}
81
82#[must_use]
83pub fn runtime_dir() -> PathBuf {
84    base_dirs()
85        .runtime_dir()
86        .unwrap_or_else(|| base_dirs().cache_dir())
87        .join(PROGRAM_FS_NAME)
88}
89
90pub fn music_dir() -> Option<&'static Path> {
91    MUSIC_DIR.as_deref()
92}
93static MUSIC_DIR: LazyLock<Option<PathBuf>> = LazyLock::new(|| {
94    UserDirs::new().and_then(|user_dirs| user_dirs.audio_dir().map(|p| p.join("Selene Library")))
95});
selene_core/lib.rs

selene_core/
lib.rs
