sqruff-lib-core 0.36.0

Core library that underpins the sqruff library.
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

use std::sync::OnceLock;

use super::matchable::MatchableTrait;
use crate::dialects::Dialect;
use crate::dialects::syntax::SyntaxKind;
use crate::errors::SQLParseError;
use crate::parser::context::ParseContext;
use crate::parser::match_result::{MatchResult, Matched};
use crate::parser::matchable::Matchable;
use crate::parser::segments::ErasedSegment;

#[derive(Clone)]
pub struct NodeMatcher {
    node_kind: SyntaxKind,
    match_grammar: OnceLock<Matchable>,
    factory: fn(&Dialect) -> Matchable,
}

impl NodeMatcher {
    pub fn new(node_kind: SyntaxKind, build_grammar: fn(&Dialect) -> Matchable) -> Self {
        Self {
            node_kind,
            match_grammar: OnceLock::new(),
            factory: build_grammar,
        }
    }

    pub fn match_grammar(&self, dialect: &Dialect) -> Matchable {
        self.match_grammar
            .get_or_init(|| (self.factory)(dialect))
            .clone()
    }

    pub fn replace(&mut self, match_grammar: Matchable) {
        self.match_grammar = OnceLock::new();
        let _ = self.match_grammar.set(match_grammar);
    }
}

impl std::fmt::Debug for NodeMatcher {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("NodeMatcher")
            .field("node_kind", &self.node_kind)
            .field("match_grammar", &"...")
            .field("factory", &"...")
            .finish()
    }
}

impl PartialEq for NodeMatcher {
    fn eq(&self, _other: &Self) -> bool {
        todo!()
    }
}

impl MatchableTrait for NodeMatcher {
    fn get_type(&self) -> SyntaxKind {
        self.node_kind
    }

    fn match_grammar(&self, dialect: &Dialect) -> Option<Matchable> {
        self.match_grammar(dialect).into()
    }

    fn elements(&self) -> &[Matchable] {
        &[]
    }

    fn match_segments(
        &self,
        segments: &[ErasedSegment],
        idx: u32,
        parse_context: &mut ParseContext,
    ) -> Result<MatchResult, SQLParseError> {
        if idx >= segments.len() as u32 {
            return Ok(MatchResult::empty_at(idx));
        }

        if segments[idx as usize].get_type() == self.get_type() {
            return Ok(MatchResult::from_span(idx, idx + 1));
        }

        let grammar = self.match_grammar(parse_context.dialect());
        let match_result = parse_context
            .deeper_match(false, &[], |ctx| grammar.match_segments(segments, idx, ctx))?;

        Ok(match_result.wrap(Matched::SyntaxKind(self.node_kind)))
    }
}