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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use std::collections::{BTreeMap, BTreeSet, HashMap, HashSet};
use std::hash::BuildHasher;
use std::sync::Arc;

/// Hidden helper trait used by [`path_pattern!`](macro@crate::path_pattern).
#[doc(hidden)]
pub trait PathPatternItem {
    /// Item type yielded by the collection-like path segment.
    type Item;
}

impl<T> PathPatternItem for Vec<T> {
    type Item = T;
}

impl<C> PathPatternItem for Option<C>
where
    C: PathPatternItem,
{
    type Item = C::Item;
}

impl<C> PathPatternItem for Box<C>
where
    C: PathPatternItem,
{
    type Item = C::Item;
}

impl<C> PathPatternItem for Arc<C>
where
    C: PathPatternItem,
{
    type Item = C::Item;
}

impl<T, const N: usize> PathPatternItem for [T; N] {
    type Item = T;
}

impl<K, V> PathPatternItem for BTreeMap<K, V> {
    type Item = V;
}

impl<K, V, S> PathPatternItem for HashMap<K, V, S>
where
    S: BuildHasher,
{
    type Item = V;
}

impl<T> PathPatternItem for BTreeSet<T> {
    type Item = T;
}

impl<T, S> PathPatternItem for HashSet<T, S>
where
    S: BuildHasher,
{
    type Item = T;
}

/// Hidden helper used by [`path_pattern!`](macro@crate::path_pattern).
#[doc(hidden)]
#[must_use]
pub fn pattern_item_ref<C>(_: &C) -> Option<&C::Item>
where
    C: PathPatternItem,
{
    None
}

/// Hidden helper used by path macros to normalize `stringify!` output.
#[doc(hidden)]
#[must_use]
pub fn normalize_macro_path(path: &str) -> String {
    path.split('.')
        .map(str::trim)
        .map(|segment| segment.strip_prefix("r#").unwrap_or(segment))
        .collect::<Vec<_>>()
        .join(".")
}