selene-core 0.8.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
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

use std::path::{Path, PathBuf};

use serde::{Deserialize, Serialize};

mod codec;
pub use codec::*;

mod format;
pub use format::*;

mod sample_format;
pub use sample_format::*;

mod stream;
pub use stream::*;
use thiserror::Error;

#[derive(Debug, Error)]
pub enum ContainerError {
    #[error("IoError: {0}")]
    Io(#[from] std::io::Error),

    #[error("Codec Error: {0}")]
    Codec(#[from] CodecError),

    #[error("Symphonia Error: {0}")]
    Symphonia(#[from] symphonia::core::errors::Error),

    #[error("File '{0}' has no tracks/streams")]
    NoStream(PathBuf),

    #[error("File '{0}' has an unsupported container")]
    InvalidSource(PathBuf),

    #[error("'{0:?}' is an unsupported container")]
    UnsupportedContainer(ContainerFormat),

    #[error("Couldn't find sample rate")]
    NoSampleRate,

    #[error("Couldn't find channel count'")]
    NoChannelCount,
}

#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct MediaContainer {
    pub(crate) path: PathBuf,
    pub(crate) format: ContainerFormat,
    pub(crate) stream: Stream,
}

impl MediaContainer {
    pub(crate) fn set_path(&mut self, path: PathBuf) {
        self.path = path;
    }
}

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

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

    /// Returns the file extension this [`MediaContainer`] uses. Returns [`Option::None`] for invalid or unrecognized pairs
    #[must_use]
    pub fn extension(&self) -> &'static str {
        let format = self.format;
        let codec = self.stream.codec_params.codec;
        match format {
            ContainerFormat::Flac if codec.is_flac() => "flac",
            ContainerFormat::Mpa if codec.is_mp3() => "mp3",
            ContainerFormat::Ogg if codec.is_vorbis() => "ogg",
            ContainerFormat::Ogg if codec.is_opus() => "opus",
            ContainerFormat::Ogg if codec.is_flac() => "oga",
            ContainerFormat::Wav if codec.is_pcm() => "wav",
            ContainerFormat::Aiff if codec.is_pcm() => "aiff",
            ContainerFormat::Ape if codec.is_ape() => "ape",
            _ => panic!("Invalid format/codec pairing: {format:?} + {codec:?}"),
        }
    }

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