No results
4
spec
crate-kit edited this page 2026-11-16 08:44:02 +00:00
Table of contents
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 cheminfn prefix(self: &Self) -> &'static str- Préfixe de l'application, par exempleMONAPP.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 dossierfn 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 lafn 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
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