kiki 7.1.0

A minimalist parser generator for Rust.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

use crate::data::*;

use std::collections::HashSet;
use std::fmt::{self, Display, Formatter};

#[derive(Debug, Clone)]
pub struct File {
    pub start: String,
    pub terminal_enum: TerminalEnum,
    pub nonterminals: Vec<Nonterminal>,
}

impl File {
    pub fn get_rules(&self) -> impl Iterator<Item = Rule> {
        self.nonterminals
            .iter()
            .flat_map(|nonterminal| match nonterminal {
                Nonterminal::Struct(s) => {
                    vec![Rule {
                        constructor_name: ConstructorName::Struct(&s.name.name),
                        fieldset: &s.fieldset,
                    }]
                }
                Nonterminal::Enum(e) => e
                    .variants
                    .iter()
                    .map(|v| {
                        let enum_name = &e.name.name;
                        let variant_name = &v.name.name;
                        Rule {
                            constructor_name: ConstructorName::EnumVariant {
                                enum_name,
                                variant_name,
                            },
                            fieldset: &v.fieldset,
                        }
                    })
                    .collect(),
            })
    }
}

#[derive(Debug, Clone, Copy)]
pub struct Rule<'a> {
    pub constructor_name: ConstructorName<'a>,
    pub fieldset: &'a Fieldset,
}

#[derive(Debug, Clone, Copy)]
pub enum ConstructorName<'a> {
    Struct(&'a str),
    EnumVariant {
        enum_name: &'a str,
        variant_name: &'a str,
    },
}

impl Display for ConstructorName<'_> {
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        match self {
            ConstructorName::Struct(name) => write!(f, "{}", name),
            ConstructorName::EnumVariant {
                enum_name,
                variant_name,
            } => write!(f, "{}::{}", enum_name, variant_name),
        }
    }
}

impl ConstructorName<'_> {
    pub fn type_name(&self) -> &str {
        match self {
            ConstructorName::Struct(name) => name,
            ConstructorName::EnumVariant { enum_name, .. } => enum_name,
        }
    }
}

impl File {
    pub fn get_defined_identifiers(&self) -> HashSet<String> {
        self.get_nonterminal_names()
            .chain(self.get_terminal_enum_variant_names())
            .chain(std::iter::once(self.terminal_enum.name.clone()))
            .collect()
    }

    fn get_nonterminal_names(&self) -> impl Iterator<Item = String> + '_ {
        self.nonterminals
            .iter()
            .map(|nonterminal| match nonterminal {
                Nonterminal::Struct(s) => &s.name.name,
                Nonterminal::Enum(e) => &e.name.name,
            })
            .cloned()
    }

    fn get_terminal_enum_variant_names(&self) -> impl Iterator<Item = String> + '_ {
        self.terminal_enum
            .variants
            .iter()
            .map(|variant| variant.dollarless_name.to_string())
    }
}

#[derive(Debug, Clone)]
pub struct TerminalEnum {
    pub attributes: Vec<Attribute>,
    pub name: String,
    pub variants: Vec<TerminalVariant>,
}

impl TerminalEnum {
    pub fn get_type(&self, variant_name: &DollarlessTerminalName) -> Option<&str> {
        self.variants
            .iter()
            .find(|variant| variant.dollarless_name == *variant_name)
            .map(|variant| -> &str { &variant.type_ })
    }
}

#[derive(Debug, Clone)]
pub struct TerminalVariant {
    pub dollarless_name: DollarlessTerminalName,
    pub type_: String,
}

#[derive(Debug, Clone)]
pub enum Nonterminal {
    Struct(Struct),
    Enum(Enum),
}

impl Nonterminal {
    pub fn name(&self) -> &str {
        match self {
            Nonterminal::Struct(s) => &s.name.name,
            Nonterminal::Enum(e) => &e.name.name,
        }
    }
}

pub use crate::data::ast::{
    Attribute, ComplexType, Enum, EnumVariant, Fieldset, NamedField, NamedFieldset, Struct,
    TupleField, TupleFieldset, Type,
};
pub use crate::data::ast::{Ident, IdentOrTerminalIdent, IdentOrUnderscore, TerminalIdent, Token};