4 spec
crate-kit edited this page 2026-11-16 08:44:02 +00:00

pmoconfig > spec

Module: spec

Contents

Structs

  • AppSpec - Ce qui distingue la configuration d'une application d'une autre : un préfixe, et éventuellement des

pmoconfig::spec::AppSpec

Struct

Ce qui distingue la configuration d'une application d'une autre : un préfixe, et éventuellement des défauts qui lui sont propres. Tout le reste en découle.

Pour le préfixe MONAPP :

Valeur Dérivation Résultat
dossier de configuration . + préfixe en minuscules .monapp
variable du dossier préfixe + _CONFIG MONAPP_CONFIG
surcharges d'environnement préfixe + _CONFIG__ MONAPP_CONFIG__HOST__PORT=9000
sels de chiffrement préfixe en minuscules + suffixes fixes monapp-config-encryption-v1, monapp-nonce-v1

Les sels sont figés : un changement rendrait indéchiffrables les mots de passe déjà chiffrés.

Le défaut d'une clé est celui de sa déclaration (Key), écrit une fois par la crate qui la possède. Une application dont le défaut d'une clé partagée n'est pas celui de la crate (la marque affichée par pmoupnp, par exemple) le dit ici, dans son AppSpec : with_defaults.

Exemple

use pmoconfig::AppSpec;

let spec = AppSpec::new("MONAPP");
assert_eq!(spec.dir_name(), ".monapp");
assert_eq!(spec.dir_env_var(), "MONAPP_CONFIG");
assert_eq!(spec.override_prefix(), "MONAPP_CONFIG__");

Methods:

  • fn new(prefix: &'static str) -> Self - Crée l'identité d'une application.
  • fn with_defaults(self: Self, defaults: &'static [(&'static [&'static str], DefaultValue)]) -> Self - Les défauts que cette application impose à des clés déclarées ailleurs : pour chacune, son chemin
  • fn prefix(self: &Self) -> &'static str - Préfixe de l'application, par exemple MONAPP.
  • fn defaults(self: &Self) -> &'static [(&'static [&'static str], DefaultValue)] - Les défauts propres à l'application (with_defaults).
  • fn default_for(self: &Self, path: &[&str]) -> Option<DefaultValue> - Le défaut que l'application impose à path (clés insensibles à la casse), s'il y en a un.
  • fn dir_name(self: &Self) -> String - Nom du dossier de configuration cherché dans le dossier courant puis dans le dossier
  • fn dir_env_var(self: &Self) -> String - Variable d'environnement qui désigne le dossier de configuration : préfixe + _CONFIG.
  • fn override_prefix(self: &Self) -> String - Préfixe des variables qui surchargent une valeur : préfixe + _CONFIG__. Les niveaux de la
  • fn key_salt(self: &Self) -> String - Sel de la clé de chiffrement des mots de passe : préfixe en minuscules + -config-encryption-v1.
  • fn nonce_salt(self: &Self) -> String - Sel du nonce de chiffrement des mots de passe : préfixe en minuscules + -nonce-v1. Figé comme

Traits: Copy

Trait Implementations:

  • Debug
    • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
  • PartialEq
    • fn eq(self: &Self, other: &Self) -> bool
  • Clone
    • fn clone(self: &Self) -> Self