caesura 0.31.0

An all-in-one command line tool to transcode FLAC audio files and upload to gazelle based indexers/trackers
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

use crate::prelude::*;

/// Legacy cache path from before platform user directories.
const LEGACY_CACHE_DIR: &str = "./cache";

/// Options for queue cache
#[derive(Options, Clone, Debug, Deserialize, Serialize)]
pub struct CacheOptions {
    /// Path to cache directory.
    #[arg(long)]
    #[options(default_fn = default_cache, default_doc = "`~/.cache/caesura/` or platform equivalent")]
    pub cache: PathBuf,
}

#[expect(
    clippy::unnecessary_wraps,
    reason = "Options macro default_fn requires Option<T>"
)]
fn default_cache(_partial: &CacheOptionsPartial) -> Option<PathBuf> {
    Some(PathManager::default_cache_dir())
}

impl CacheOptions {
    /// Cache directory path with tilde expansion applied.
    #[must_use]
    pub fn path(&self) -> PathBuf {
        self.cache.expand_tilde()
    }
}

impl OptionsContract for CacheOptions {
    type Partial = CacheOptionsPartial;

    fn validate(&self, validator: &mut OptionsValidator) {
        let cache = self.path();
        validator.check_dir_exists("cache", &cache);
        if !cache.is_dir() && PathBuf::from(LEGACY_CACHE_DIR).is_dir() {
            let default_dir = PathManager::default_cache_dir();
            validator.push(OptionIssue::default_changed(
                "cache",
                &self.cache.to_string_lossy(),
                &format!(
                    "In v0.27.0 the default cache path changed to {}.\nPass the option: --cache {LEGACY_CACHE_DIR} to use the previous cache path.",
                    default_dir.display()
                ),
            ));
        }
    }
}