batchcensor 0.5.0

A tool for batch-censoring audio files.
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

use std::fmt;

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub struct Pos {
    pub hours: u32,
    pub minutes: u32,
    pub seconds: u32,
    pub milliseconds: u32,
}

impl Pos {
    /// Convert into samples given a sample rate.
    pub fn as_samples(&self, sample_rate: u32) -> Option<u32> {
        let samples = 0u32
            .checked_add(self.hours.checked_mul(3600)?.checked_mul(sample_rate)?)?
            .checked_add(self.minutes.checked_mul(60)?.checked_mul(sample_rate)?)?
            .checked_add(self.seconds.checked_mul(sample_rate)?)?
            .checked_add(
                self.milliseconds
                    .checked_mul(sample_rate.checked_div(1000)?)?,
            )?;

        Some(samples)
    }

    /// Deserialize stringa as a position.
    pub fn parse(s: &str) -> Option<Pos> {
        let mut main = s.split(':');
        let last = main.next_back()?;
        let mut last = last.split(".");

        let seconds = match last.next()?.trim() {
            "" => 0,
            seconds => str::parse::<u32>(seconds).ok()?,
        };

        let milliseconds = str::parse::<u32>(last.next()?).ok()?;

        let minutes = main
            .next_back()
            .and_then(|s| str::parse::<u32>(s).ok())
            .unwrap_or_default();

        let hours = main
            .next_back()
            .and_then(|s| str::parse::<u32>(s).ok())
            .unwrap_or_default();

        Some(Pos {
            hours,
            minutes,
            seconds,
            milliseconds,
        })
    }
}

impl fmt::Display for Pos {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        if self.hours > 0 {
            write!(fmt, "{:02}:", self.hours)?;
        }

        if self.minutes > 0 {
            write!(fmt, "{:02}:", self.hours)?;
        }

        if self.seconds > 0 {
            write!(fmt, "{:02}", self.seconds)?;
        }

        write!(fmt, ".{:03}", self.milliseconds)?;
        Ok(())
    }
}

impl<'de> serde::Deserialize<'de> for Pos {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        let s: String = String::deserialize(deserializer)?;
        Pos::parse(&s).ok_or_else(|| <D::Error as serde::de::Error>::custom("bad position"))
    }
}

#[cfg(test)]
mod tests {
    use super::Pos;

    #[test]
    pub fn test() {
        assert_eq!(
            Pos {
                hours: 0,
                minutes: 0,
                seconds: 0,
                milliseconds: 123,
            },
            Pos::parse(".123").expect("bad position")
        );

        assert_eq!(
            Pos {
                hours: 0,
                minutes: 0,
                seconds: 42,
                milliseconds: 123,
            },
            Pos::parse("42.123").expect("bad position")
        );

        assert_eq!(
            Pos {
                hours: 0,
                minutes: 21,
                seconds: 42,
                milliseconds: 123,
            },
            Pos::parse("21:42.123").expect("bad position")
        );

        assert_eq!(
            Pos {
                hours: 12,
                minutes: 21,
                seconds: 42,
                milliseconds: 123,
            },
            Pos::parse("12:21:42.123").expect("bad position")
        );
    }
}