Quellenverfolgung

English | 中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Svenska | Suomi | Nederlands

Verwende load_config_with_figment, um den Figment-Graphen zu behalten, der beim Laufzeitladen verwendet wurde:

#![allow(unused)]
fn main() {
use rust_config_tree::load_config_with_figment;

let (config, figment) = load_config_with_figment::<AppConfig>("config.yaml")?;
let _ = config;
Ok::<(), Box<dyn std::error::Error + Send + Sync>>(())
}

Der zurueckgegebene Figment-Wert kann Quellenfragen fuer Laufzeitwerte beantworten:

#![allow(unused)]
fn main() {
if let Some(metadata) = figment.find_metadata("database.pool_size") {
    let source = metadata.interpolate(
        &figment::Profile::Default,
        &["database", "pool_size"],
    );

    println!("database.pool_size came from {source}");
}
}

Fuer Werte, die von ConfiqueEnvProvider geliefert werden, gibt die Interpolation den nativen Umgebungsvariablennamen zurueck, der im Schema deklariert ist:

database.pool_size came from APP_DATABASE_POOL_SIZE

TRACE-Ereignisse

Der Loader gibt Quellenverfolgungsereignisse mit tracing::trace! aus. Das geschieht nur, wenn TRACE aktiviert ist:

#![allow(unused)]
fn main() {
use rust_config_tree::{load_config_with_figment, trace_config_sources};

let (config, figment) = load_config_with_figment::<AppConfig>("config.yaml")?;

// If the tracing subscriber is initialized after config loading, emit the
// same source events again after installing the subscriber.
trace_config_sources::<AppConfig>(&figment);
let _ = config;
Ok::<(), Box<dyn std::error::Error + Send + Sync>>(())
}

Jedes Ereignis verwendet das Ziel rust_config_tree::config und enthaelt:

• config_key: den gepunkteten Konfigurationsschluessel.
• source: die gerenderte Quellenmetadatenangabe.

Werte, die nur aus confique-Defaults stammen, haben keine Figment-Laufzeitmetadaten. Sie werden als confique default or unset optional field gemeldet.