selene-core 0.3.1

selene-core is the backend for Selene, a local-first music player
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

use std::path::Path;

use crate::{
    codec::Codec, container::ContainerFormat, ffmpeg::Stream, media_container::MediaContainer,
    utils::pair_extension,
};

impl MediaContainer {
    #[must_use]
    pub fn path(&self) -> &Path {
        &self.path
    }

    #[must_use]
    pub fn container(&self) -> &ContainerFormat {
        &self.format
    }

    #[must_use]
    pub fn codec(&self) -> &Codec {
        &self.stream.codec
    }

    /// Returns the file extension this [`MediaContainer`] uses. Returns [`Option::None`] for invalid or unrecognized pairs
    #[must_use]
    pub fn extension(&self) -> Option<&str> {
        pair_extension(&self.format, &self.stream.codec)
    }

    /// Returns the [`ContainerFormat`] and [`Codec`] the program will transcode [`Self`] into
    ///
    /// Returns none if the pair is an unknown or unrecognized pair
    #[must_use]
    pub fn transcode_to(&self) -> Option<(ContainerFormat, Codec)> {
        let format = self.format;
        let codec = self.stream.codec;
        match format {
            ContainerFormat::Mp3 => Some((ContainerFormat::Mp3, Codec::Mp3)),
            ContainerFormat::Ogg => match codec {
                Codec::Flac | Codec::LibOpus | Codec::LibVorbis => Some((format, codec)),
                _ => None,
            },
            ContainerFormat::Flac | ContainerFormat::Wav => {
                Some((ContainerFormat::Flac, Codec::Flac))
            }
        }
    }

    #[must_use] 
    pub fn stream(&self) -> &Stream {
        &self.stream
    }
}