1 files changed, 68 insertions, 0 deletions
diff --git a/benoit-cli/src/config/field/mod.rs b/benoit-cli/src/config/field/mod.rs
new file mode 100644
index 0000000..489dc7a
--- /dev/null
+++ b/benoit-cli/src/config/field/mod.rs
@@ -0,0 +1,68 @@
+/*
+	Copyright 2021, 2023-2024 Gabriel Bjørnager Jen-
+	sen.
+
+	This file is part of benoit-cli.
+
+	benoit-cli is free software: you can redistrib-
+	ute it and/or modify it under the terms of the
+	GNU General Public License as published by the
+	Free Software Foundation, either version 3 of
+	the License, or (at your option) any later ver-
+	sion.
+
+	benoit-cli is distributed in the hope that it
+	will be useful, but WITHOUT ANY WARRANTY; with-
+	out even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+	General Public License for more details.
+
+	You should have received a copy of the GNU Gene-
+	ral Public License along with benoit-cli. If
+	not, see <https://www.gnu.org/licenses/>.
+*/
+
+use crate::error::Error;
+
+use std::str::FromStr;
+use toml::Value;
+
+/// Denotes a configuration field.
+///
+/// By default, these fields are typeless.
+/// They can, however, be "transformed" to a given type using the [`Take`](crate::config::Take) trait.
+pub struct Field<'a> {
+	pub(in super) name:  String,
+	pub(in super) value: Option<&'a Value>,
+}
+
+impl<'a> Field<'a> {
+	/// Borows the contained value.
+	///
+	/// The returned reference is still considered "typeless," as is defined by `toml`'s own [`Value`] type.
+	///
+	/// # Errors
+	///
+	/// Returns an error if the field could not be found.
+	pub(in super) fn borrow_value(&mut self) -> Result<&'a Value, Error> {
+		self.value
+			.take()
+			.ok_or_else(|| Error::MissingConfigField { name: self.name.clone() })
+	}
+}
+
+impl Field<'_> {
+	/// Transforms the field into the given type `T`.
+	/// The result of [`FromStr`] implementation is passed on.
+	///
+	/// # Errors
+	///
+	/// Returns an error if the field doesn't exist, or is a different type, or if the [`FromStr`] implementation failed.
+	pub fn take_from_str<T: FromStr>(mut self) -> Result<Result<T, <T as FromStr>::Err>, Error> {
+		let Value::String(ref s) = *self.borrow_value()? else {
+			return Err(Error::WrongFieldType { name: self.name, ok_type: "string" })
+		};
+
+		Ok(FromStr::from_str(s))
+	}
+}