oak-ini 0.0.11

High-performance incremental INI parser for the oak ecosystem with flexible configuration, optimized for simple configuration file processing.
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

use oak_core::{ElementType, UniversalElementRole};

/// INI element types used in the syntax tree.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub enum IniElementType {
    /// Whitespace characters.
    Whitespace,
    /// Newline character.
    Newline,
    /// Comment.
    Comment,
    /// Error element.
    Error,
    /// End of file.
    Eof,

    /// `{` symbol.
    LeftBrace,
    /// `}` symbol.
    RightBrace,
    /// `[` symbol.
    LeftBracket,
    /// `]` symbol.
    RightBracket,
    /// `[[` symbol.
    DoubleLeftBracket,
    /// `]]` symbol.
    DoubleRightBracket,
    /// `,` symbol.
    Comma,
    /// `.` symbol.
    Dot,
    /// `=` operator.
    Equal,

    /// Identifier.
    Identifier,
    /// String literal.
    String,
    /// Integer literal.
    Integer,
    /// Floating-point literal.
    Float,
    /// Boolean literal.
    Boolean,
    /// Date and time literal.
    DateTime,

    /// Root of the INI document.
    Root,
    /// The entire INI document.
    Document,
    /// A section in the INI file.
    Section,
    /// A table definition.
    Table,
    /// An array of tables definition.
    ArrayOfTables,
    /// A key-value pair.
    KeyValue,
    /// The key part of a key-value pair.
    Key,
    /// The value part of a key-value pair.
    Value,
    /// An array value.
    Array,
    /// An inline table value.
    InlineTable,
}

impl ElementType for IniElementType {
    type Role = UniversalElementRole;

    fn role(&self) -> Self::Role {
        match self {
            Self::Root | Self::Document => UniversalElementRole::Root,
            Self::Section | Self::Table | Self::ArrayOfTables | Self::Array | Self::InlineTable => UniversalElementRole::Container,
            Self::KeyValue => UniversalElementRole::Attribute,
            Self::Key => UniversalElementRole::AttributeKey,
            Self::Value => UniversalElementRole::Value,
            _ => UniversalElementRole::None,
        }
    }
}

impl From<crate::lexer::token_type::IniTokenType> for IniElementType {
    fn from(token: crate::lexer::token_type::IniTokenType) -> Self {
        match token {
            crate::lexer::token_type::IniTokenType::Whitespace => Self::Whitespace,
            crate::lexer::token_type::IniTokenType::Newline => Self::Newline,
            crate::lexer::token_type::IniTokenType::Comment => Self::Comment,
            crate::lexer::token_type::IniTokenType::Error => Self::Error,
            crate::lexer::token_type::IniTokenType::Eof => Self::Eof,
            crate::lexer::token_type::IniTokenType::LeftBrace => Self::LeftBrace,
            crate::lexer::token_type::IniTokenType::RightBrace => Self::RightBrace,
            crate::lexer::token_type::IniTokenType::LeftBracket => Self::LeftBracket,
            crate::lexer::token_type::IniTokenType::RightBracket => Self::RightBracket,
            crate::lexer::token_type::IniTokenType::DoubleLeftBracket => Self::DoubleLeftBracket,
            crate::lexer::token_type::IniTokenType::DoubleRightBracket => Self::DoubleRightBracket,
            crate::lexer::token_type::IniTokenType::Comma => Self::Comma,
            crate::lexer::token_type::IniTokenType::Dot => Self::Dot,
            crate::lexer::token_type::IniTokenType::Equal => Self::Equal,
            crate::lexer::token_type::IniTokenType::Identifier => Self::Identifier,
            crate::lexer::token_type::IniTokenType::String => Self::String,
            crate::lexer::token_type::IniTokenType::Integer => Self::Integer,
            crate::lexer::token_type::IniTokenType::Float => Self::Float,
            crate::lexer::token_type::IniTokenType::Boolean => Self::Boolean,
            crate::lexer::token_type::IniTokenType::DateTime => Self::DateTime,
        }
    }
}