tier 0.1.17

Rust configuration library for layered TOML, env, and CLI settings
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use std::path::PathBuf;

use crate::loader::{SourceKind, SourceTrace};

use super::{LineColumn, UnknownField};

pub(super) fn format_location(location: Option<LineColumn>) -> String {
    match location {
        Some(location) => format!(" ({location})"),
        None => String::new(),
    }
}

pub(super) fn format_missing_paths(paths: &[PathBuf]) -> String {
    paths
        .iter()
        .map(|path| format!("- {}", path.display()))
        .collect::<Vec<_>>()
        .join("\n")
}

pub(super) fn format_unknown_fields(fields: &[UnknownField]) -> String {
    fields
        .iter()
        .map(|field| format!("- {field}"))
        .collect::<Vec<_>>()
        .join("\n")
}

pub(super) fn format_path_location(path: &str) -> String {
    if path.is_empty() {
        "the configuration root".to_owned()
    } else {
        format!("`{path}`")
    }
}

pub(super) fn format_source_policy(allowed: &[SourceKind], denied: &[SourceKind]) -> String {
    match (allowed.is_empty(), denied.is_empty()) {
        (false, true) => format!("allowed sources: {}", format_source_kind_list(allowed)),
        (true, false) => format!("denied sources: {}", format_source_kind_list(denied)),
        (false, false) => format!(
            "allowed sources: {}; denied sources: {}",
            format_source_kind_list(allowed),
            format_source_kind_list(denied)
        ),
        (true, true) => "no source policy matched".to_owned(),
    }
}

pub(super) fn deserialize_source_suffix(provenance: &Option<SourceTrace>) -> String {
    provenance
        .as_ref()
        .map_or_else(String::new, |source| format!(" from {source}"))
}

fn format_source_kind_list(kinds: &[SourceKind]) -> String {
    kinds
        .iter()
        .map(ToString::to_string)
        .collect::<Vec<_>>()
        .join(", ")
}