star-toml 26.7.3

Framework for loading, layering, and validating any *.toml configuration file
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Demonstrates exploratory mode for configurations with unknown fields.
//!
//! Run with: `cargo run --example exploratory_unknown_fields`

use serde::{Deserialize, Serialize};
use star_toml::{
    loader::{ConfigLifecycle, TrustedLoader},
    Validate, Validator,
};

#[derive(Debug, Deserialize, Serialize, Clone)]
struct AppConfig {
    name: String,
    port: u16,
}

impl Validate for AppConfig {
    fn validate(&self, v: &mut Validator) {
        v.check_non_empty("name", &self.name);
        v.check_range("port", self.port, 1024..=65535);
    }
}
impl ConfigLifecycle for AppConfig {}

fn main() {
    println!("--- Exploratory Unknown Fields Example ---");

    // Load invalid_unknown_field.toml which has the extra field: `extra_field = "must_fail"`
    let loader =
        TrustedLoader::new().layer_file("examples/config_patterns/invalid_unknown_field.toml");

    // DfCM Invariant: load_admitted_exploratory() allows unknown fields,
    // but should only be used in non-production environments.
    match loader.load_admitted_exploratory::<AppConfig>() {
        Ok(admitted) => {
            println!("Exploratory Admission Successful (Unknown fields ignored)!");
            println!("Value: {:?}", admitted.value());
            println!("Witness: {}", admitted.witness().hash());
        }
        Err(e) => {
            println!("Failed to load in exploratory mode: {:?}", e);
        }
    }
}