sscanf 0.5.0

A sscanf (inverse of format!()) macro with near unlimited parsing capabilities
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

#[derive(Clone, Copy)]
pub(crate) enum Context {
    Root,

    // Match methods
    Parse(&'static str),
    AsSeq,
    AsAlt(usize),
    AsAltEnum(&'static str),
    AsOpt,

    // SeqMatch methods
    At(usize),
    Get(usize),
    ParseAt(&'static str, usize),
    ParseField(&'static str, usize, &'static str),
}

#[derive(Clone, Copy)]
pub(crate) struct ContextChain<'t> {
    current: Context,
    parent: Option<&'t ContextChain<'t>>,
}

impl<'t> ContextChain<'t> {
    pub fn and(&'t self, child: Context) -> Self {
        Self {
            current: child,
            parent: Some(self),
        }
    }
}

impl From<Context> for ContextChain<'_> {
    fn from(context: Context) -> Self {
        Self {
            current: context,
            parent: None,
        }
    }
}

impl std::fmt::Display for ContextChain<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        if let Some(parent) = &self.parent {
            // this recursion could probably be optimized, but it is only used for panic messages, so it doesn't matter
            parent.fmt(f)?;
            f.write_str(" -> ")?;
        }
        match &self.current {
            Context::Root => f.write_str("sscanf"),

            Context::Parse(ty) => write!(f, "parse as {ty}"),
            Context::AsSeq => f.write_str("as_seq()"),
            Context::AsAlt(index) => write!(f, "as_alt({index} matched)"),
            Context::AsAltEnum(variant) => write!(f, "as_alt({variant} matched)"),
            Context::AsOpt => f.write_str("as_opt()"),

            Context::At(index) => write!(f, "at({index})"),
            Context::Get(index) => write!(f, "get({index})"),
            Context::ParseAt(ty, index) => write!(f, "parse {index} as {ty}"),
            Context::ParseField(name, index, ty) => {
                write!(f, "parse .{name} (index {index} as {ty})")
            }
        }
    }
}