caesura 0.29.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
50
51
52
53
54
55
56

use crate::prelude::*;
use caesura_macros::Options;
use serde::{Deserialize, Serialize};

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

/// Validation label for the cache directory.
pub(crate) const CACHE_DIR_LABEL: &str = "Cache Directory";

/// 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, errors: &mut Vec<OptionRule>) {
        let cache = self.path();
        if !cache.is_dir() {
            errors.push(DoesNotExist(
                CACHE_DIR_LABEL.to_owned(),
                cache.to_string_lossy().to_string(),
            ));
            if PathBuf::from(LEGACY_CACHE_DIR).is_dir() {
                let default_dir = PathManager::default_cache_dir();
                errors.push(Changed(
                    CACHE_DIR_LABEL.to_owned(),
                    self.cache.to_string_lossy().to_string(),
                    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()),
                ));
            }
        }
    }
}