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

use crate::{IniParser, ast::*, language::IniLanguage, lexer::token_type::IniTokenType, parser::element_type::IniElementType};
use oak_core::{Builder, BuilderCache, GreenNode, OakDiagnostics, OakError, Parser, RedNode, RedTree, SourceText, TextEdit, source::Source};

/// INI AST builder implementation.
pub struct IniBuilder<'config> {
    /// The INI language configuration.
    config: &'config IniLanguage,
}

impl<'config> IniBuilder<'config> {
    /// Creates a new `IniBuilder` with the given configuration.
    pub fn new(config: &'config IniLanguage) -> Self {
        Self { config }
    }
}

impl<'config> Builder<IniLanguage> for IniBuilder<'config> {
    fn build<'a, S: Source + ?Sized>(&self, source: &S, edits: &[TextEdit], _cache: &'a mut impl BuilderCache<IniLanguage>) -> OakDiagnostics<IniRoot> {
        let parser = IniParser::new(self.config);
        let mut cache = oak_core::parser::session::ParseSession::<IniLanguage>::default();
        let parse_result = parser.parse(source, edits, &mut cache);

        match parse_result.result {
            Ok(green_tree) => {
                let source_text = SourceText::new(source.get_text_in((0..source.length()).into()).into_owned());
                match self.build_root(green_tree, &source_text) {
                    Ok(ast_root) => OakDiagnostics { result: Ok(ast_root), diagnostics: parse_result.diagnostics },
                    Err(build_error) => {
                        let mut diagnostics = parse_result.diagnostics;
                        diagnostics.push(build_error.clone());
                        OakDiagnostics { result: Err(build_error), diagnostics }
                    }
                }
            }
            Err(parse_error) => OakDiagnostics { result: Err(parse_error), diagnostics: parse_result.diagnostics },
        }
    }
}

impl<'config> IniBuilder<'config> {
    /// Builds the AST root from a green tree.
    pub(crate) fn build_root<'a>(&self, green_tree: &'a GreenNode<'a, IniLanguage>, source: &SourceText) -> Result<IniRoot, OakError> {
        let red_root = RedNode::new(green_tree, 0);
        let mut sections = Vec::new();
        let mut properties = Vec::new();

        for child in red_root.children() {
            if let RedTree::Node(n) = child {
                if n.green.kind == IniElementType::Table {
                    sections.push(self.build_section(n, source)?);
                }
                else if n.green.kind == IniElementType::KeyValue {
                    properties.push(self.build_property(n, source)?);
                }
            }
        }
        Ok(IniRoot { sections, properties })
    }

    /// Builds a section from a red node.
    fn build_section(&self, node: RedNode<IniLanguage>, source: &SourceText) -> Result<Section, OakError> {
        let span = node.span();
        let mut name = String::new();
        let mut properties = Vec::new();

        for child in node.children() {
            match child {
                RedTree::Leaf(t) if t.kind == IniTokenType::Identifier => name = source.get_text_in(t.span.clone().into()).to_string(),
                RedTree::Node(n) if n.green.kind == IniElementType::KeyValue => properties.push(self.build_property(n, source)?),
                _ => {}
            }
        }
        Ok(Section { name, properties, span })
    }

    /// Builds a property from a red node.
    fn build_property(&self, node: RedNode<IniLanguage>, source: &SourceText) -> Result<Property, OakError> {
        let span = node.span();
        let mut key = String::new();
        let mut value = String::new();

        for child in node.children() {
            if let RedTree::Node(n) = child {
                if n.green.kind == IniElementType::Key {
                    key = source.get_text_in(n.span().into()).to_string();
                }
                else if n.green.kind == IniElementType::Value {
                    value = source.get_text_in(n.span().into()).to_string();
                }
            }
        }
        Ok(Property { key, value, span })
    }
}