3 global
crate-kit edited this page 2026-11-11 07:29:34 +00:00

pmoconfig > global

Module: global

Contents

Functions

  • get_config - La configuration du processus, chargée par init.
  • init - Charge la configuration du processus pour l'application spec et la rend disponible par
  • init_in - Comme init, avec un dossier de configuration explicite au lieu de le chercher (variable
  • try_get_config - La configuration du processus si init a été appelé, sinon None. 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>>