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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

use crate::prelude::*;

/// Read files from a directory with optional filtering.
pub struct DirectoryReader {
    included_extensions: Vec<String>,
    max_depth: Option<usize>,
}

impl DirectoryReader {
    /// Create a new [`DirectoryReader`].
    #[must_use]
    pub fn new() -> Self {
        Self {
            included_extensions: Vec::new(),
            max_depth: None,
        }
    }

    /// Filter to include only files with this extension.
    pub fn with_extension(&mut self, extension: &str) -> &mut Self {
        self.included_extensions.push(extension.to_owned());
        self
    }

    /// Filter to include files with any of these extensions.
    pub fn with_extensions(&mut self, extensions: Vec<&str>) -> &mut Self {
        for extension in extensions {
            self.included_extensions.push(extension.to_owned());
        }
        self
    }

    /// Limit directory traversal to this depth.
    pub fn with_max_depth(&mut self, max_depth: usize) -> &mut Self {
        self.max_depth = Some(max_depth);
        self
    }

    /// Read all matching files from the directory.
    pub fn read(&mut self, path: &Path) -> Result<Vec<PathBuf>, IoError> {
        let depth = 0;
        let mut files: Vec<PathBuf> = Vec::new();
        self.read_internal(path, depth, &mut files)?;
        Ok(files)
    }

    fn read_internal(
        &mut self,
        path: &Path,
        depth: usize,
        files: &mut Vec<PathBuf>,
    ) -> Result<(), IoError> {
        let dir = path.read_dir()?;
        for entry in dir {
            let entry = entry?;
            let path = entry.path();
            if path.is_dir() {
                if self.is_depth_ok(depth) {
                    self.read_internal(&path, depth + 1, files)?;
                }
            } else {
                if !self.is_extension_included(&path) {
                    continue;
                }
                files.push(path);
            }
        }
        Ok(())
    }

    fn is_extension_included(&self, path: &Path) -> bool {
        if self.included_extensions.is_empty() {
            true
        } else if let Some(extension) = path.extension() {
            let extension = extension.to_string_lossy().to_string().to_lowercase();
            self.included_extensions.contains(&extension)
        } else {
            false
        }
    }

    fn is_depth_ok(&self, depth: usize) -> bool {
        if let Some(max_depth) = self.max_depth {
            depth < max_depth
        } else {
            true
        }
    }
}