lexa-env 0.1.2

Récupère tes variables d'environnement simplement.
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

// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
// ┃ Copyright: (c) 2023, Mike 'PhiSyX' S. (https://github.com/PhiSyX)         ┃
// ┃ SPDX-License-Identifier: MPL-2.0                                          ┃
// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
// ┃                                                                           ┃
// ┃  This Source Code Form is subject to the terms of the Mozilla Public      ┃
// ┃  License, v. 2.0. If a copy of the MPL was not distributed with this      ┃
// ┃  file, You can obtain one at https://mozilla.org/MPL/2.0/.                ┃
// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

use std::fmt::Debug;
use std::path;

// --------- //
// Interface //
// --------- //

pub trait EnvInterface:
	serde::de::DeserializeOwned + Debug + Clone + Send + Sync
{
	type Settings;

	// NOTE(phisyx): ici typiquement pouvoir définir la fonction en "MaybeAsync"
	//               aurait été vraiment sympa. Par exemple dans le cas où l'on
	//               voudrait récupérer les variables d'environnement depuis un
	//               serveur distant, et non pas depuis les fichiers systèmes.
	//
	// https://blog.rust-lang.org/inside-rust/2022/07/27/keyword-generics.html
	//                              Result<Self, impl std::error::Error>
	fn setup(_: &Self::Settings) -> Result<Self, super::Error>
	where
		Self: Sized;

	/// Récupère les variables d'environnement à partir du contenu d'un fichier
	/// et retourne une structure avec les données du contenu du fichier en
	/// guise de valeurs pour chaque champ.
	fn from_file(path: impl AsRef<path::Path>) -> Result<Self, super::Error> {
		super::from_file(path)
	}
}