serde_yml/modules/
path.rs

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
use std::fmt::{self, Display};

/// `Path` represents the path to the current value in the input, like `dependencies.serde.typo1`.
///
/// The `Path` enum provides a way to represent different types of paths in a YAML-like structure.
/// It can be used to track the location of values within the input and provide meaningful error messages.
///
/// # Variants
///
/// - `Root`: Represents the root path.
/// - `Seq`: Represents a sequence (array) path with a reference to the parent path and an index.
/// - `Map`: Represents a map (object) path with a reference to the parent path and a key.
/// - `Alias`: Represents an alias path with a reference to the parent path.
/// - `Unknown`: Represents an unknown path with a reference to the parent path.
#[derive(Copy, Clone, Debug, PartialEq)]
pub enum Path<'a> {
    /// Represents the root path.
    Root,
    /// Represents a sequence (array) path with a reference to the parent path and an index.
    Seq {
        /// The parent path.
        parent: &'a Path<'a>,
        /// The index within the sequence.
        index: usize,
    },
    /// Represents a map (object) path with a reference to the parent path and a key.
    Map {
        /// The parent path.
        parent: &'a Path<'a>,
        /// The key within the map.
        key: &'a str,
    },
    /// Represents an alias path with a reference to the parent path.
    Alias {
        /// The parent path.
        parent: &'a Path<'a>,
    },
    /// Represents an unknown path with a reference to the parent path.
    Unknown {
        /// The parent path.
        parent: &'a Path<'a>,
    },
}

impl Display for Path<'_> {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        /// `Parent` is a helper struct used to format the parent path.
        ///
        /// It implements the `Display` trait to recursively format the parent path.
        struct Parent<'a>(&'a Path<'a>);

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

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