looklook 0.5.0

Descriptive signal synthesiser.
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

// Copyright 2026 Gabriel Bjørnager Jensen.
//
// This file is part of LOOKLOOK.
//
// LOOKLOOK is free software: you can redistribute
// it and/or modify it under the terms of the GNU
// Affero General Public License as published by
// the Free Software Foundation, either version 3
// of the License, or (at your option) any later
// version.
//
// LOOKLOOK is distributed in the hope that it will
// be useful, but WITHOUT ANY WARRANTY; without
// even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Affero General Public License for more details.
//
// You should have received a copy of the GNU Af-
// fero General Public License along with LOOKLOOK.
// If not, see <https://www.gnu.org/licenses/>.

//! The [`Format`] type.

use crate::config::FormatFromStrError;

use std::fmt::{self, Display, Formatter};
use std::str::FromStr;

/// An audio format.
#[non_exhaustive]
#[derive(Copy, Debug)]
#[derive_const(Clone, Default, Eq, PartialEq)]
pub enum Format {
	/// The [Portable Network Graphics](PNG) format.
	///
	/// [PNG]: <https://en.wikipedia.org/wiki/PNG>
	///
	/// File extension: `png`
	Png,

	/// Our own, raw format.
	///
	/// File extension: `zlk`
	#[default]
	Raw,

	/// The [Waveform Audio File Format](WAVE).
	///
	/// [WAVE]: <https://en.wikipedia.org/wiki/WAV>
	///
	/// File extension: `wav`
	Wave,

	/// The [WebP] format.
	///
	/// [WebP]: <https://en.wikipedia.org/wiki/WebP>
	///
	/// File extension: `webp`
	Webp,
}

impl Format {
	/// Retrieves an identifier for the format.
	#[inline]
	#[must_use]
	pub const fn as_str(self) -> &'static str {
		match self {
			Self::Png  => "png",
			Self::Raw  => "raw",
			Self::Wave => "wave",
			Self::Webp => "webp",
		}
	}

	/// Retrieves the file extension for the format.
	#[inline]
	#[must_use]
	pub const fn file_extension(self) -> &'static str {
		match self {
			Self::Png  => ".png",
			Self::Raw  => ".zlk",
			Self::Wave => ".wave",
			Self::Webp => ".webp",
		}
	}
}

impl Display for Format {
	fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
		f.write_str(self.as_str())
	}
}

const impl FromStr for Format {
	type Err = FormatFromStrError;

	fn from_str(s: &str) -> Result<Self, Self::Err> {
		if s.eq_ignore_ascii_case("png") {
			return Ok(Self::Png);
		}

		if s.eq_ignore_ascii_case("raw") {
			return Ok(Self::Raw);
		}

		if s.eq_ignore_ascii_case("wave") {
			return Ok(Self::Wave);
		}

		if s.eq_ignore_ascii_case("webp") {
			return Ok(Self::Webp);
		}

		Err(FormatFromStrError(()))
	}
}