caesura 0.30.2

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
57
58
59
60
61
62
63

use crate::prelude::*;

/// A collection of [`FlacFile`].
pub struct Collector;

impl Collector {
    /// Create [`FlacFile`] for each `.flac` file in a directory.
    #[must_use]
    pub fn get_flacs(source_dir: &PathBuf) -> Vec<FlacFile> {
        let paths = DirectoryReader::new()
            .with_extension("flac")
            .read(source_dir)
            .expect("Source directory should be readable");
        let mut collection = Vec::new();
        for path in paths {
            collection.push(FlacFile::new(path, source_dir));
        }
        trace!(
            "{} {} flacs in: {}",
            "Found".bold(),
            collection.len(),
            source_dir.display()
        );
        collection
    }

    /// Create [`FlacFile`] for each `.flac` file in a directory with [`DiscContext`] attached.
    ///
    /// This variant computes disc context (multi-disc detection, track padding) and
    /// attaches it to each flac. Use this when you need disc/track information for
    /// renaming or validation.
    #[must_use]
    pub fn get_flacs_with_context(source_dir: &PathBuf) -> Vec<FlacFile> {
        let mut flacs = Self::get_flacs(source_dir);
        let context = DiscContext::from_flacs(&flacs);
        for flac in &mut flacs {
            flac.disc_context = Some(context.clone());
        }
        flacs
    }

    /// Create [`AdditionalFile`] for each additional file in a directory.
    #[must_use]
    pub fn get_additional(source_dir: &PathBuf) -> Vec<AdditionalFile> {
        let paths = DirectoryReader::new()
            .with_max_depth(1)
            .with_extensions(IMAGE_EXTENSIONS.to_vec())
            .with_extensions(TEXT_EXTENSIONS.to_vec())
            .read(source_dir)
            .expect("Source directory should be readable");
        let mut collection = Vec::new();
        for path in paths {
            collection.push(AdditionalFile::new(path, source_dir));
        }
        trace!(
            "{} {} files in: {}",
            "Found".bold(),
            collection.len(),
            source_dir.display()
        );
        collection
    }
}