pmoconfig > global
Module: global
Contents
Functions
get_config- La configuration du processus, chargée parinit.init- Charge la configuration du processus pour l'applicationspecet la rend disponible parinit_in- Commeinit, avec un dossier de configuration explicite au lieu de le chercher (variabletry_get_config- La configuration du processus siinita été appelé, sinonNone. Pour le code (bibliothèque,
pmoconfig::global::get_config
Function
La configuration du processus, chargée par init.
Panics
Si init n'a pas été appelé : il n'y a pas de configuration par défaut, car la crate ne sait
pas quelle application elle sert. Appeler init (ou la fonction d'initialisation de
l'application) au début de main. Pour du code qui ne peut pas le garantir, voir
try_get_config.
fn get_config() -> std::sync::Arc<crate::config::Config>
pmoconfig::global::init
Function
Charge la configuration du processus pour l'application spec et la rend disponible par
get_config. À appeler une fois, au début de main, avant tout get_config().
Un second appel avec la même spec rend la configuration déjà chargée (pratique pour les
tests d'un même processus). Avec une autre spec, c'est une erreur : un processus n'a qu'une
configuration.
Errors
Voir Config::load, ou une spec différente de celle du premier appel.
Exemple
use pmoconfig::{AppSpec, get_config, init};
let dir = tempfile::tempdir()?;
// Normalement : le dossier est cherché par `AppSpec::dir_env_var`, `.monapp`…
unsafe { std::env::set_var("MONAPP_CONFIG", dir.path()) };
init(AppSpec::new("MONAPP"))?;
let config = get_config();
# Ok::<(), Box<dyn std::error::Error>>(())
fn init(spec: crate::spec::AppSpec) -> crate::error::Result<std::sync::Arc<crate::config::Config>>
pmoconfig::global::init_in
Function
Comme init, avec un dossier de configuration explicite au lieu de le chercher (variable
d'environnement, dossier courant, dossier personnel) : pour les tests, qui ne doivent pas lire
ni écrire la configuration réelle de la machine.
Errors
Voir init. Un second appel avec la même spec mais un directory non vide différent du
dossier déjà chargé est aussi une erreur : la configuration d'un processus a un seul dossier.
fn init_in(spec: crate::spec::AppSpec, directory: &str) -> crate::error::Result<std::sync::Arc<crate::config::Config>>
pmoconfig::global::try_get_config
Function
La configuration du processus si init a été appelé, sinon None. Pour le code (bibliothèque,
test) qui ne peut pas garantir l'ordre d'initialisation sans passer par la panique de
get_config.
fn try_get_config() -> Option<std::sync::Arc<crate::config::Config>>
pmoconfig 0.3.5
- pmoconfig
- config
- config::Config
- encryption
- entries
- error
- global
- introspect
- key
- key::Key
- key::Kind
- page
- page::ConfigPage
- page::Setting
- page::action
- page::check
- page::collection
- page::collection::Collection
- page::collection_view
- page::info
- page::restart
- page::view
- registry
- registry::ConfigKeys
- spec
- spec::AppSpec