scarf-parser 0.1.0

A helper crate of scarf for parsing a SystemVerilog source file
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

// =======================================================================
// utils.rs
// =======================================================================
// Helper functions for implementing parsers

use crate::*;
use chumsky::input::ValueInput;
use chumsky::prelude::*;
use scarf_syntax::Span;
use scarf_syntax::*;

// Fold parsed text into a vector
pub fn foldl_vector<T>(mut a: Vec<T>, b: T) -> Vec<T> {
    a.push(b);
    a
}

// Span conversion
pub fn convert_span(simple_span: ParserSpan) -> Span {
    simple_span.into()
}

// A parser for matching extra nodes
pub fn extra_node_parser<'a, I>() -> impl Parser<'a, I, Vec<(ExtraNode<'a>, Span)>, ParserError<'a>>
where
    I: ValueInput<'a, Token = Token<'a>, Span = ParserSpan>,
{
    select! {
        Token::OnelineComment(text) = e => (ExtraNode::OnelineComment(text), convert_span(e.span())),
        Token::BlockComment(text) = e => (ExtraNode::BlockComment(text), convert_span(e.span())),
        Token::Newline = e => (ExtraNode::Newline, convert_span(e.span()))
    }
    .labelled("whitespace/comment")
    .repeated()
    .collect::<Vec<(ExtraNode<'a>, Span)>>()
}

// A mapping function for replacing extra nodes in metadata
pub fn replace_nodes<'a>(
    old_metadata: Metadata<'a>,
    new_nodes: Vec<(ExtraNode<'a>, Span)>,
) -> Metadata<'a> {
    Metadata {
        span: old_metadata.span,
        extra_nodes: new_nodes,
    }
}

// A parser for matching a token and extra nodes, producing metadata
pub fn token<'a, I>(token_to_match: Token<'a>) -> impl Parser<'a, I, Metadata<'a>, ParserError<'a>>
where
    I: ValueInput<'a, Token = Token<'a>, Span = ParserSpan>,
{
    just(token_to_match)
        .map_with(|_, e| Metadata {
            span: convert_span(e.span()),
            extra_nodes: Vec::default(),
        })
        .then(extra_node_parser())
        .map(|(a, b)| replace_nodes(a, b))
}

pub fn todo_parser<'a, I>() -> impl Parser<'a, I, (), ParserError<'a>>
where
    I: ValueInput<'a, Token = Token<'a>, Span = ParserSpan>,
{
    // Match against nothing
    just(Token::Error).to(())
}