scarf-syntax 0.2.1

A helper crate of scarf for expressing a SystemVerilog concrete syntax tree
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

// =======================================================================
// task_declarations.rs
// =======================================================================
//! CST Nodes from 1800-2023 A.2.7
use crate::*;

#[derive(Clone, Debug, PartialEq)]
pub struct TaskDeclaration<'a>(
    pub Metadata<'a>, // task
    pub Option<DynamicOverrideSpecifiers<'a>>,
    pub Option<Lifetime<'a>>,
    pub TaskBodyDeclaration<'a>,
);

#[derive(Clone, Debug, PartialEq)]
pub enum InterfaceIdentifierOrClassScope<'a> {
    InterfaceIdentifier(
        Box<(
            InterfaceIdentifier<'a>,
            Metadata<'a>, // .
        )>,
    ),
    ClassScope(Box<ClassScope<'a>>),
}

#[derive(Clone, Debug, PartialEq)]
pub enum TaskBodyDeclaration<'a> {
    Tf(
        Box<(
            Option<InterfaceIdentifierOrClassScope<'a>>,
            TaskIdentifier<'a>,
            Metadata<'a>, // ;
            Vec<TfItemDeclaration<'a>>,
            Vec<StatementOrNull<'a>>,
            Metadata<'a>, // endtask
            Option<(
                Metadata<'a>, // :
                TaskIdentifier<'a>,
            )>,
        )>,
    ),
    Block(
        Box<(
            Option<InterfaceIdentifierOrClassScope<'a>>,
            TaskIdentifier<'a>,
            Metadata<'a>, // (
            Option<TfPortList<'a>>,
            Metadata<'a>, // )
            Metadata<'a>, // ;
            Vec<BlockItemDeclaration<'a>>,
            Vec<StatementOrNull<'a>>,
            Metadata<'a>, // endtask
            Option<(
                Metadata<'a>, // :
                TaskIdentifier<'a>,
            )>,
        )>,
    ),
}

#[derive(Clone, Debug, PartialEq)]
pub enum TfItemDeclaration<'a> {
    Block(Box<BlockItemDeclaration<'a>>),
    Tf(Box<TfPortDeclaration<'a>>),
}

#[derive(Clone, Debug, PartialEq)]
pub struct TfPortList<'a>(
    pub TfPortItem<'a>,
    pub  Vec<(
        Metadata<'a>, // ,
        TfPortItem<'a>,
    )>,
);

#[derive(Clone, Debug, PartialEq)]
pub struct TfPortItem<'a>(
    pub Vec<AttributeInstance<'a>>,
    pub Option<TfPortDirection<'a>>,
    pub Option<Metadata<'a>>, // var
    pub DataTypeOrImplicit<'a>,
    pub  Option<(
        PortIdentifier<'a>,
        Vec<VariableDimension<'a>>,
        Option<(
            Metadata<'a>, // eq
            Expression<'a>,
        )>,
    )>,
);

#[derive(Clone, Debug, PartialEq)]
pub enum TfPortDirection<'a> {
    Port(Box<PortDirection<'a>>),
    Ref(
        Box<(
            Option<Metadata<'a>>, // const
            Metadata<'a>,         // ref
            Option<Metadata<'a>>, // static
        )>,
    ),
}

#[derive(Clone, Debug, PartialEq)]
pub struct TfPortDeclaration<'a>(
    pub Vec<AttributeInstance<'a>>,
    pub TfPortDirection<'a>,
    pub Option<Metadata<'a>>, // var
    pub DataTypeOrImplicit<'a>,
    pub ListOfTfVariableIdentifiers<'a>,
    pub Metadata<'a>, // ;
);

#[derive(Clone, Debug, PartialEq)]
pub struct TaskPrototype<'a>(
    pub Metadata<'a>, // task
    pub Option<DynamicOverrideSpecifiers<'a>>,
    pub TaskIdentifier<'a>,
    pub  Option<(
        Metadata<'a>, // (
        Option<TfPortList<'a>>,
        Metadata<'a>, // )
    )>,
);

#[derive(Clone, Debug, PartialEq)]
pub struct DynamicOverrideSpecifiers<'a>(
    pub Option<InitialOrExtendsSpecifier<'a>>,
    pub Option<FinalSpecifier<'a>>,
);

#[derive(Clone, Debug, PartialEq)]
pub enum InitialOrExtendsSpecifier<'a> {
    Initial((Metadata<'a>, Metadata<'a>)),
    Extends((Metadata<'a>, Metadata<'a>)),
}

#[derive(Clone, Debug, PartialEq)]
pub struct FinalSpecifier<'a>(
    pub Metadata<'a>, // :
    pub Metadata<'a>, // final
);