serde_yaml_gtc 2.5.2

Temp copy for serde_yaml_bw until version 2.5.2 is on crates. YAML support for Serde with an emphasis on panic-free parsing (including malformed YAML).
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

use std::fmt::{self, Display};

/// Path to the current value in the input, like `dependencies.serde.typo1`.
#[derive(Debug, Copy, Clone)]
pub enum Path<'a> {
    Root,
    Seq { parent: &'a Path<'a>, index: usize },
    Map { parent: &'a Path<'a>, key: &'a str },
    Alias { parent: &'a Path<'a> },
    Unknown { parent: &'a Path<'a> },
}

impl Display for Path<'_> {
    fn fmt(&self, formatter: &mut fmt::Formatter) -> Result<(), fmt::Error> {
        struct Parent<'a>(&'a Path<'a>);

        impl Display for Parent<'_> {
            fn fmt(&self, formatter: &mut fmt::Formatter) -> Result<(), fmt::Error> {
                match self.0 {
                    Path::Root => Ok(()),
                    path => write!(formatter, "{}.", path),
                }
            }
        }

        match self {
            Path::Root => formatter.write_str("."),
            Path::Seq { parent, index } => write!(formatter, "{}[{}]", parent, index),
            Path::Map { parent, key } => write!(formatter, "{}{}", Parent(parent), key),
            Path::Alias { parent } => write!(formatter, "{}", parent),
            Path::Unknown { parent } => write!(formatter, "{}?", Parent(parent)),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::Path;

    #[test]
    fn test_display_variants() {
        let root = Path::Root;
        assert_eq!(format!("{}", root), ".");

        let seq = Path::Seq {
            parent: &root,
            index: 1,
        };
        assert_eq!(format!("{}", seq), ".[1]");

        let map = Path::Map {
            parent: &seq,
            key: "name",
        };
        assert_eq!(format!("{}", map), ".[1].name");

        let alias = Path::Alias { parent: &map };
        assert_eq!(format!("{}", alias), ".[1].name");

        let unknown = Path::Unknown { parent: &map };
        assert_eq!(format!("{}", unknown), ".[1].name.?");
    }

    #[test]
    fn test_debug_variants() {
        let root = Path::Root;
        assert_eq!(format!("{:?}", root), "Root");

        let seq = Path::Seq {
            parent: &root,
            index: 1,
        };
        assert_eq!(format!("{:?}", seq), "Seq { parent: Root, index: 1 }");
    }
}