live 0.3.1

A modular configuration framework with live reloading and atomic, format-agnostic updates.
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

/* src/loader/impls/static_loader.rs */

use super::super::{FmtError, Format, LoadInfo, LoadResult, PreProcess, Source, ValidateConfig};
use serde::de::DeserializeOwned;
use std::path::PathBuf;

/// A zero-cost loader that combines a specific Source and Format at compile time.
pub struct StaticLoader<S, F> {
	pub source: S,
	pub format: F,
}

impl<S, F> StaticLoader<S, F>
where
	S: Source,
	F: Format,
{
	/// Creates a new StaticLoader.
	pub const fn new(source: S, format: F) -> Self {
		Self { source, format }
	}

	/// Loads and parses the configuration.
	pub async fn load<T>(&self, key: &str) -> LoadResult<T>
	where
		T: DeserializeOwned + PreProcess + ValidateConfig,
	{
		let bytes = match self.source.read(key).await {
			Ok(b) => b,
			Err(FmtError::NotFound) => return LoadResult::NotFound,
			Err(e) => return LoadResult::Invalid(e),
		};

		match self.format.parse::<T>(&bytes) {
			Ok(mut obj) => {
				obj.pre_process();
				obj.set_context(key);

				if let Err(e) = obj.validate_config() {
					return LoadResult::Invalid(e);
				}

				let format_name = self
					.format
					.extensions()
					.first()
					.copied()
					.unwrap_or("unknown");

				LoadResult::Ok {
					value: obj,
					info: LoadInfo {
						path: PathBuf::from(key),
						format: format_name,
					},
				}
			}
			Err(e) => LoadResult::Invalid(e),
		}
	}
}