parser.py revision 9219
16313Sgblack@eecs.umich.edu# Copyright (c) 2009 The Hewlett-Packard Development Company
26313Sgblack@eecs.umich.edu# All rights reserved.
36313Sgblack@eecs.umich.edu#
46313Sgblack@eecs.umich.edu# Redistribution and use in source and binary forms, with or without
56313Sgblack@eecs.umich.edu# modification, are permitted provided that the following conditions are
66313Sgblack@eecs.umich.edu# met: redistributions of source code must retain the above copyright
76313Sgblack@eecs.umich.edu# notice, this list of conditions and the following disclaimer;
86313Sgblack@eecs.umich.edu# redistributions in binary form must reproduce the above copyright
96313Sgblack@eecs.umich.edu# notice, this list of conditions and the following disclaimer in the
106313Sgblack@eecs.umich.edu# documentation and/or other materials provided with the distribution;
116313Sgblack@eecs.umich.edu# neither the name of the copyright holders nor the names of its
126313Sgblack@eecs.umich.edu# contributors may be used to endorse or promote products derived from
136313Sgblack@eecs.umich.edu# this software without specific prior written permission.
146313Sgblack@eecs.umich.edu#
156313Sgblack@eecs.umich.edu# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
166313Sgblack@eecs.umich.edu# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
176313Sgblack@eecs.umich.edu# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
186313Sgblack@eecs.umich.edu# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
196313Sgblack@eecs.umich.edu# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
206313Sgblack@eecs.umich.edu# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
216313Sgblack@eecs.umich.edu# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
226313Sgblack@eecs.umich.edu# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
236313Sgblack@eecs.umich.edu# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
246313Sgblack@eecs.umich.edu# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
256313Sgblack@eecs.umich.edu# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
266313Sgblack@eecs.umich.edu#
276313Sgblack@eecs.umich.edu# Authors: Nathan Binkert
286313Sgblack@eecs.umich.edu
296313Sgblack@eecs.umich.eduimport os.path
306313Sgblack@eecs.umich.eduimport re
316313Sgblack@eecs.umich.eduimport sys
326313Sgblack@eecs.umich.edu
336313Sgblack@eecs.umich.edufrom m5.util import code_formatter
348229Snate@binkert.orgfrom m5.util.grammar import Grammar, ParseError
358229Snate@binkert.org
366330Sgblack@eecs.umich.eduimport slicc.ast as ast
376330Sgblack@eecs.umich.eduimport slicc.util as util
386330Sgblack@eecs.umich.edufrom slicc.symbols import SymbolTable
396313Sgblack@eecs.umich.edu
406330Sgblack@eecs.umich.educlass SLICC(Grammar):
4112106SRekai.GonzalezAlberquilla@arm.com    def __init__(self, filename, base_dir, verbose=False, traceback=False, **kwargs):
429384SAndreas.Sandberg@arm.com        self.protocol = None
4310033SAli.Saidi@ARM.com        self.traceback = traceback
446313Sgblack@eecs.umich.edu        self.verbose = verbose
459384SAndreas.Sandberg@arm.com        self.symtab = SymbolTable(self)
466330Sgblack@eecs.umich.edu        self.base_dir = base_dir
476313Sgblack@eecs.umich.edu
486313Sgblack@eecs.umich.edu        try:
496330Sgblack@eecs.umich.edu            self.decl_list = self.parse_file(filename, **kwargs)
506313Sgblack@eecs.umich.edu        except ParseError, e:
516313Sgblack@eecs.umich.edu            if not self.traceback:
526313Sgblack@eecs.umich.edu                sys.exit(str(e))
539384SAndreas.Sandberg@arm.com            raise
546313Sgblack@eecs.umich.edu
556330Sgblack@eecs.umich.edu    def currentLocation(self):
566330Sgblack@eecs.umich.edu        return util.Location(self.current_source, self.current_line,
579384SAndreas.Sandberg@arm.com                             no_warning=not self.verbose)
586330Sgblack@eecs.umich.edu
596313Sgblack@eecs.umich.edu    def codeFormatter(self, *args, **kwargs):
6010033SAli.Saidi@ARM.com        code = code_formatter(*args, **kwargs)
6110033SAli.Saidi@ARM.com        code['protocol'] = self.protocol
6210033SAli.Saidi@ARM.com        return code
636330Sgblack@eecs.umich.edu
646330Sgblack@eecs.umich.edu    def process(self):
656330Sgblack@eecs.umich.edu        self.decl_list.findMachines()
666330Sgblack@eecs.umich.edu        self.decl_list.generate()
676330Sgblack@eecs.umich.edu
686330Sgblack@eecs.umich.edu    def writeCodeFiles(self, code_path, includes):
696330Sgblack@eecs.umich.edu        self.symtab.writeCodeFiles(code_path, includes)
706330Sgblack@eecs.umich.edu
716330Sgblack@eecs.umich.edu    def writeHTMLFiles(self, html_path):
726330Sgblack@eecs.umich.edu        self.symtab.writeHTMLFiles(html_path)
736330Sgblack@eecs.umich.edu
746313Sgblack@eecs.umich.edu    def files(self):
756313Sgblack@eecs.umich.edu        f = set([
766313Sgblack@eecs.umich.edu            'MachineType.cc',
7710698Sandreas.hansson@arm.com            'MachineType.hh',
786330Sgblack@eecs.umich.edu            'Types.hh' ])
796330Sgblack@eecs.umich.edu
806330Sgblack@eecs.umich.edu        f |= self.decl_list.files()
816330Sgblack@eecs.umich.edu
826330Sgblack@eecs.umich.edu        return f
836330Sgblack@eecs.umich.edu
846330Sgblack@eecs.umich.edu    t_ignore = '\t '
856330Sgblack@eecs.umich.edu
866330Sgblack@eecs.umich.edu    # C or C++ comment (ignore)
876313Sgblack@eecs.umich.edu    def t_c_comment(self, t):
886330Sgblack@eecs.umich.edu        r'/\*(.|\n)*?\*/'
896330Sgblack@eecs.umich.edu        t.lexer.lineno += t.value.count('\n')
906330Sgblack@eecs.umich.edu
916330Sgblack@eecs.umich.edu    def t_cpp_comment(self, t):
926330Sgblack@eecs.umich.edu        r'//.*'
937702Sgblack@eecs.umich.edu
946313Sgblack@eecs.umich.edu    # Define a rule so we can track line numbers
956313Sgblack@eecs.umich.edu    def t_newline(self, t):
9611168Sandreas.hansson@arm.com        r'\n+'
9711168Sandreas.hansson@arm.com        t.lexer.lineno += len(t.value)
986330Sgblack@eecs.umich.edu
9912106SRekai.GonzalezAlberquilla@arm.com    reserved = {
10012106SRekai.GonzalezAlberquilla@arm.com        'protocol' : 'PROTOCOL',
1016313Sgblack@eecs.umich.edu        'include' : 'INCLUDE',
10210035Sandreas.hansson@arm.com        'global' : 'GLOBAL',
1036313Sgblack@eecs.umich.edu        'machine' : 'MACHINE',
1046313Sgblack@eecs.umich.edu        'in_port' : 'IN_PORT',
1056313Sgblack@eecs.umich.edu        'out_port' : 'OUT_PORT',
1066313Sgblack@eecs.umich.edu        'action' : 'ACTION',
1076313Sgblack@eecs.umich.edu        'transition' : 'TRANS',
10810035Sandreas.hansson@arm.com        'structure' : 'STRUCT',
1096313Sgblack@eecs.umich.edu        'external_type' : 'EXTERN_TYPE',
1106313Sgblack@eecs.umich.edu        'enumeration' : 'ENUM',
1116313Sgblack@eecs.umich.edu        'state_declaration' : 'STATE_DECL',
1126313Sgblack@eecs.umich.edu        'peek' : 'PEEK',
1139920Syasuko.eckert@amd.com        'stall_and_wait' : 'STALL_AND_WAIT',
1149920Syasuko.eckert@amd.com        'enqueue' : 'ENQUEUE',
11510035Sandreas.hansson@arm.com        'copy_head' : 'COPY_HEAD',
1169920Syasuko.eckert@amd.com        'check_allocate' : 'CHECK_ALLOCATE',
1179920Syasuko.eckert@amd.com        'check_stop_slots' : 'CHECK_STOP_SLOTS',
1189920Syasuko.eckert@amd.com        'static_cast' : 'STATIC_CAST',
1199920Syasuko.eckert@amd.com        'if' : 'IF',
12010033SAli.Saidi@ARM.com        'is_valid' : 'IS_VALID',
12110035Sandreas.hansson@arm.com        'is_invalid' : 'IS_INVALID',
12210033SAli.Saidi@ARM.com        'else' : 'ELSE',
12310033SAli.Saidi@ARM.com        'return' : 'RETURN',
12410033SAli.Saidi@ARM.com        'THIS' : 'THIS',
12510033SAli.Saidi@ARM.com        'CHIP' : 'CHIP',
1269384SAndreas.Sandberg@arm.com        'void' : 'VOID',
1279384SAndreas.Sandberg@arm.com        'new' : 'NEW',
1289384SAndreas.Sandberg@arm.com        'OOD' : 'OOD',
1299461Snilay@cs.wisc.edu    }
1309461Snilay@cs.wisc.edu
1319553Sandreas.hansson@arm.com    literals = ':[]{}(),='
1329553Sandreas.hansson@arm.com
1339553Sandreas.hansson@arm.com    tokens = [ 'EQ', 'NE', 'LT', 'GT', 'LE', 'GE',
1346313Sgblack@eecs.umich.edu               'LEFTSHIFT', 'RIGHTSHIFT',
1356313Sgblack@eecs.umich.edu               'NOT', 'AND', 'OR',
1366313Sgblack@eecs.umich.edu               'PLUS', 'DASH', 'STAR', 'SLASH',
1376313Sgblack@eecs.umich.edu               'DOUBLE_COLON', 'SEMI',
138               'ASSIGN', 'DOT',
139               'IDENT', 'LIT_BOOL', 'FLOATNUMBER', 'NUMBER', 'STRING' ]
140    tokens += reserved.values()
141
142    t_EQ = r'=='
143    t_NE = r'!='
144    t_LT = r'<'
145    t_GT = r'>'
146    t_LE = r'<='
147    t_GE = r'>='
148    t_LEFTSHIFT = r'<<'
149    t_RIGHTSHIFT = r'>>'
150    t_NOT = r'!'
151    t_AND = r'&&'
152    t_OR = r'\|\|'
153    t_PLUS = r'\+'
154    t_DASH = r'-'
155    t_STAR = r'\*'
156    t_SLASH = r'/'
157    t_DOUBLE_COLON = r'::'
158    t_SEMI = r';'
159    t_ASSIGN = r':='
160    t_DOT = r'\.'
161
162    precedence = (
163        ('left', 'AND', 'OR'),
164        ('left', 'EQ', 'NE'),
165        ('left', 'LT', 'GT', 'LE', 'GE'),
166        ('left', 'RIGHTSHIFT', 'LEFTSHIFT'),
167        ('left', 'PLUS', 'DASH'),
168        ('left', 'STAR', 'SLASH'),
169        ('right', 'NOT', 'UMINUS'),
170    )
171
172    def t_IDENT(self, t):
173        r'[a-zA-Z_][a-zA-Z_0-9]*'
174        if t.value == 'true':
175            t.type = 'LIT_BOOL'
176            t.value = True
177            return t
178
179        if t.value == 'false':
180            t.type = 'LIT_BOOL'
181            t.value = False
182            return t
183
184        # Check for reserved words
185        t.type = self.reserved.get(t.value, 'IDENT')
186        return t
187
188    def t_FLOATNUMBER(self, t):
189        '[0-9]+[.][0-9]+'
190        try:
191            t.value = float(t.value)
192        except ValueError:
193            raise ParseError("Illegal float", t)
194        return t
195
196    def t_NUMBER(self, t):
197        r'[0-9]+'
198        try:
199            t.value = int(t.value)
200        except ValueError:
201            raise ParseError("Illegal number", t)
202        return t
203
204    def t_STRING1(self, t):
205        r'\"[^"\n]*\"'
206        t.type = 'STRING'
207        t.value = t.value[1:-1]
208        return t
209
210    def t_STRING2(self, t):
211        r"\'[^'\n]*\'"
212        t.type = 'STRING'
213        t.value = t.value[1:-1]
214        return t
215
216    def p_file(self, p):
217        "file : decls"
218        p[0] = p[1]
219
220    def p_empty(self, p):
221        "empty :"
222
223    def p_decls(self, p):
224        "decls : declsx"
225        p[0] = ast.DeclListAST(self, p[1])
226
227    def p_declsx__list(self, p):
228        "declsx : decl declsx"
229        if isinstance(p[1], ast.DeclListAST):
230            decls = p[1].decls
231        elif p[1] is None:
232            decls = []
233        else:
234            decls = [ p[1] ]
235        p[0] = decls + p[2]
236
237    def p_declsx__none(self, p):
238        "declsx : empty"
239        p[0] = []
240
241    def p_decl__protocol(self, p):
242        "decl : PROTOCOL STRING SEMI"
243        if self.protocol:
244            msg = "Protocol can only be set once! Error at %s:%s\n" % \
245                (self.current_source, self.current_line)
246            raise ParseError(msg)
247        self.protocol = p[2]
248        p[0] = None
249
250    def p_decl__include(self, p):
251        "decl : INCLUDE STRING SEMI"
252        dirname = os.path.dirname(self.current_source)
253        if os.path.exists(os.path.join(dirname, p[2])):
254            filename = os.path.join(dirname, p[2])
255        else:
256            filename = os.path.join(self.base_dir, p[2])
257        p[0] = self.parse_file(filename)
258
259    def p_decl__machine(self, p):
260        "decl : MACHINE '(' ident pairs ')' ':' params '{' decls '}'"
261        p[0] = ast.MachineAST(self, p[3], p[4], p[7], p[9])
262
263    def p_decl__action(self, p):
264        "decl : ACTION '(' ident pairs ')' statements"
265        p[0] = ast.ActionDeclAST(self, p[3], p[4], p[6])
266
267    def p_decl__in_port(self, p):
268        "decl : IN_PORT '(' ident ',' type ',' var pairs ')' statements"
269        p[0] = ast.InPortDeclAST(self, p[3], p[5], p[7], p[8], p[10])
270
271    def p_decl__out_port(self, p):
272        "decl : OUT_PORT '(' ident ',' type ',' var pairs ')' SEMI"
273        p[0] = ast.OutPortDeclAST(self, p[3], p[5], p[7], p[8])
274
275    def p_decl__trans0(self, p):
276        "decl : TRANS '(' idents ',' idents ',' ident pairs ')' idents"
277        p[0] = ast.TransitionDeclAST(self, [], p[3], p[5], p[7], p[8], p[10])
278
279    def p_decl__trans1(self, p):
280        "decl : TRANS '(' idents ',' idents           pairs ')' idents"
281        p[0] = ast.TransitionDeclAST(self, [], p[3], p[5], None, p[6], p[8])
282
283    def p_decl__trans2(self, p):
284        "decl : TRANS '(' idents ',' idents ',' ident pairs ')' idents idents"
285        p[0] = ast.TransitionDeclAST(self, p[10], p[3], p[5], p[7], p[8], p[11])
286
287    def p_decl__trans3(self, p):
288        "decl : TRANS '(' idents ',' idents           pairs ')' idents idents"
289        p[0] = ast.TransitionDeclAST(self, p[8], p[3], p[5], None, p[6], p[9])
290
291    def p_decl__extern0(self, p):
292        "decl : EXTERN_TYPE '(' type pairs ')' SEMI"
293        p[4]["external"] = "yes"
294        p[0] = ast.TypeDeclAST(self, p[3], p[4], [])
295
296    def p_decl__global(self, p):
297        "decl : GLOBAL '(' type pairs ')' '{' type_members '}'"
298        p[4]["global"] = "yes"
299        p[0] = ast.TypeDeclAST(self, p[3], p[4], p[7])
300
301    def p_decl__struct(self, p):
302        "decl : STRUCT '(' type pairs ')' '{' type_members '}'"
303        p[0] = ast.TypeDeclAST(self, p[3], p[4], p[7])
304
305    def p_decl__enum(self, p):
306        "decl : ENUM '(' type pairs ')' '{' type_enums   '}'"
307        p[4]["enumeration"] = "yes"
308        p[0] = ast.EnumDeclAST(self, p[3], p[4], p[7])
309
310    def p_decl__state_decl(self, p):
311        "decl : STATE_DECL '(' type pairs ')' '{' type_states   '}'"
312        p[4]["enumeration"] = "yes"
313        p[4]["state_decl"] = "yes"
314        p[0] = ast.StateDeclAST(self, p[3], p[4], p[7])
315
316    def p_decl__object(self, p):
317        "decl : type ident pairs SEMI"
318        p[0] = ast.ObjDeclAST(self, p[1], p[2], p[3])
319
320    def p_decl__func_decl(self, p):
321        """decl : void ident '(' params ')' pairs SEMI
322                | type ident '(' params ')' pairs SEMI"""
323        p[0] = ast.FuncDeclAST(self, p[1], p[2], p[4], p[6], None)
324
325    def p_decl__func_def(self, p):
326        """decl : void ident '(' params ')' pairs statements
327                | type ident '(' params ')' pairs statements"""
328        p[0] = ast.FuncDeclAST(self, p[1], p[2], p[4], p[6], p[7])
329
330    # Type fields
331    def p_type_members__list(self, p):
332        "type_members : type_member type_members"
333        p[0] = [ p[1] ] + p[2]
334
335    def p_type_members__empty(self, p):
336        "type_members : empty"
337        p[0] = []
338
339    def p_type_method__0(self, p):
340        "type_member : type_or_void ident '(' types ')' pairs SEMI"
341        p[0] = ast.TypeFieldMethodAST(self, p[1], p[2], p[4], p[6])
342
343    def p_type_member__1(self, p):
344        "type_member : type_or_void ident pairs SEMI"
345        p[0] = ast.TypeFieldMemberAST(self, p[1], p[2], p[3], None)
346
347    def p_type_member__2(self, p):
348        "type_member : type_or_void ident ASSIGN expr SEMI"
349        p[0] = ast.TypeFieldMemberAST(self, p[1], p[2],
350                                      ast.PairListAST(self), p[4])
351
352    # Enum fields
353    def p_type_enums__list(self, p):
354        "type_enums : type_enum type_enums"
355        p[0] = [ p[1] ] + p[2]
356
357    def p_type_enums__empty(self, p):
358        "type_enums : empty"
359        p[0] = []
360
361    def p_type_enum(self, p):
362        "type_enum : ident pairs SEMI"
363        p[0] = ast.TypeFieldEnumAST(self, p[1], p[2])
364
365    # States
366    def p_type_states__list(self, p):
367        "type_states : type_state type_states"
368        p[0] = [ p[1] ] + p[2]
369
370    def p_type_states__empty(self, p):
371        "type_states : empty"
372        p[0] = []
373
374    def p_type_state(self, p):
375        "type_state : ident ',' enumeration pairs SEMI"
376        p[0] = ast.TypeFieldStateAST(self, p[1], p[3], p[4])
377
378    # Type
379    def p_types__multiple(self, p):
380        "types : type ',' types"
381        p[0] = [ p[1] ] + p[3]
382
383    def p_types__one(self, p):
384        "types : type"
385        p[0] = [ p[1] ]
386
387    def p_types__empty(self, p):
388        "types : empty"
389        p[0] = []
390
391    def p_typestr__multi(self, p):
392        "typestr : typestr DOUBLE_COLON ident"
393        p[0] = '%s::%s' % (p[1], p[3])
394
395    def p_typestr__single(self, p):
396        "typestr : ident"
397        p[0] = p[1]
398
399    def p_type__one(self, p):
400        "type : typestr"
401        p[0] = ast.TypeAST(self, p[1])
402
403    def p_void(self, p):
404        "void : VOID"
405        p[0] = ast.TypeAST(self, p[1])
406
407    def p_type_or_void(self, p):
408        """type_or_void : type
409                        | void"""
410        p[0] = p[1]
411
412    # Formal Param
413    def p_params__many(self, p):
414        "params : param ',' params"
415        p[0] = [ p[1] ] + p[3]
416
417    def p_params__one(self, p):
418        "params : param"
419        p[0] = [ p[1] ]
420
421    def p_params__none(self, p):
422        "params : empty"
423        p[0] = []
424
425    def p_param(self, p):
426        "param : type ident"
427        p[0] = ast.FormalParamAST(self, p[1], p[2])
428
429    def p_param__pointer(self, p):
430        "param : type STAR ident"
431        p[0] = ast.FormalParamAST(self, p[1], p[3], None, True)
432
433    def p_param__pointer_default(self, p):
434        "param : type STAR ident '=' STRING"
435        p[0] = ast.FormalParamAST(self, p[1], p[3], p[5], True)
436
437    def p_param__default_number(self, p):
438        "param : type ident '=' NUMBER"
439        p[0] = ast.FormalParamAST(self, p[1], p[2], p[4])
440
441    def p_param__default_bool(self, p):
442        "param : type ident '=' LIT_BOOL"
443        p[0] = ast.FormalParamAST(self, p[1], p[2], p[4])
444
445    def p_param__default_string(self, p):
446        "param : type ident '=' STRING"
447        p[0] = ast.FormalParamAST(self, p[1], p[2], p[4])
448
449    # Idents and lists
450    def p_idents__braced(self, p):
451        "idents : '{' identx '}'"
452        p[0] = p[2]
453
454    def p_idents__bare(self, p):
455        "idents : ident"
456        p[0] = [ p[1] ]
457
458    def p_identx__multiple_1(self, p):
459        """identx : ident SEMI identx
460                  | ident ',' identx"""
461        p[0] = [ p[1] ] + p[3]
462
463    def p_identx__multiple_2(self, p):
464        "identx : ident identx"
465        p[0] = [ p[1] ] + p[2]
466
467    def p_identx__single(self, p):
468        "identx : empty"
469        p[0] = [ ]
470
471    def p_ident(self, p):
472        "ident : IDENT"
473        p[0] = p[1]
474
475    # Pair and pair lists
476    def p_pairs__list(self, p):
477        "pairs : ',' pairsx"
478        p[0] = p[2]
479
480    def p_pairs__empty(self, p):
481        "pairs : empty"
482        p[0] = ast.PairListAST(self)
483
484    def p_pairsx__many(self, p):
485        "pairsx : pair ',' pairsx"
486        p[0] = p[3]
487        p[0].addPair(p[1])
488
489    def p_pairsx__one(self, p):
490        "pairsx : pair"
491        p[0] = ast.PairListAST(self)
492        p[0].addPair(p[1])
493
494    def p_pair__assign(self, p):
495        """pair : ident '=' STRING
496                | ident '=' ident
497                | ident '=' NUMBER"""
498        p[0] = ast.PairAST(self, p[1], p[3])
499
500    def p_pair__literal(self, p):
501        "pair : STRING"
502        p[0] = ast.PairAST(self, "short", p[1])
503
504    # Below are the rules for action descriptions
505    def p_statements__inner(self, p):
506        "statements : '{' statements_inner '}'"
507        p[0] = ast.StatementListAST(self, p[2])
508
509    def p_statements__none(self, p):
510        "statements : '{' '}'"
511        p[0] = ast.StatementListAST(self, [])
512
513    def p_statements_inner__many(self, p):
514        "statements_inner : statement statements_inner"
515        p[0] = [ p[1] ] + p[2]
516
517    def p_statements_inner__one(self, p):
518        "statements_inner : statement"
519        p[0] = [ p[1] ]
520
521    def p_exprs__multiple(self, p):
522        "exprs : expr ',' exprs"
523        p[0] = [ p[1] ] + p[3]
524
525    def p_exprs__one(self, p):
526        "exprs : expr"
527        p[0] = [ p[1] ]
528
529    def p_exprs__empty(self, p):
530        "exprs : empty"""
531        p[0] = []
532
533    def p_statement__expression(self, p):
534        "statement : expr SEMI"
535        p[0] = ast.ExprStatementAST(self, p[1])
536
537    def p_statement__assign(self, p):
538        "statement : expr ASSIGN expr SEMI"
539        p[0] = ast.AssignStatementAST(self, p[1], p[3])
540
541    def p_statement__enqueue(self, p):
542        "statement : ENQUEUE '(' var ',' type pairs ')' statements"
543        p[0] = ast.EnqueueStatementAST(self, p[3], p[5], p[6], p[8])
544
545    def p_statement__stall_and_wait(self, p):
546        "statement : STALL_AND_WAIT '(' var ',' var ')' SEMI"
547        p[0] = ast.StallAndWaitStatementAST(self, p[3], p[5])
548
549    def p_statement__peek(self, p):
550        "statement : PEEK '(' var ',' type pairs ')' statements"
551        p[0] = ast.PeekStatementAST(self, p[3], p[5], p[6], p[8], "peek")
552
553    def p_statement__copy_head(self, p):
554        "statement : COPY_HEAD '(' var ',' var pairs ')' SEMI"
555        p[0] = ast.CopyHeadStatementAST(self, p[3], p[5], p[6])
556
557    def p_statement__check_allocate(self, p):
558        "statement : CHECK_ALLOCATE '(' var ')' SEMI"
559        p[0] = ast.CheckAllocateStatementAST(self, p[3])
560
561    def p_statement__check_stop(self, p):
562        "statement : CHECK_STOP_SLOTS '(' var ',' STRING ',' STRING ')' SEMI"
563        p[0] = ast.CheckStopStatementAST(self, p[3], p[5], p[7])
564
565    def p_statement__static_cast(self, p):
566        "aexpr : STATIC_CAST '(' type ',' expr ')'"
567        p[0] = ast.StaticCastAST(self, p[3], "ref", p[5])
568
569    def p_statement__static_cast_ptr(self, p):
570        "aexpr : STATIC_CAST '(' type ',' STRING ',' expr ')'"
571        p[0] = ast.StaticCastAST(self, p[3], p[5], p[7])
572
573    def p_statement__return(self, p):
574        "statement : RETURN expr SEMI"
575        p[0] = ast.ReturnStatementAST(self, p[2])
576
577    def p_statement__if(self, p):
578        "statement : if_statement"
579        p[0] = p[1]
580
581    def p_if_statement__if(self, p):
582        "if_statement : IF '(' expr ')' statements"
583        p[0] = ast.IfStatementAST(self, p[3], p[5], None)
584
585    def p_if_statement__if_else(self, p):
586        "if_statement : IF '(' expr ')' statements ELSE statements"
587        p[0] = ast.IfStatementAST(self, p[3], p[5], p[7])
588
589    def p_statement__if_else_if(self, p):
590        "if_statement : IF '(' expr ')' statements ELSE if_statement"
591        p[0] = ast.IfStatementAST(self, p[3], p[5],
592                                  ast.StatementListAST(self, p[7]))
593
594    def p_expr__var(self, p):
595        "aexpr : var"
596        p[0] = p[1]
597
598    def p_expr__localvar(self, p):
599        "aexpr : type ident"
600        p[0] = ast.LocalVariableAST(self, p[1], p[2])
601
602    def p_expr__literal(self, p):
603        "aexpr : literal"
604        p[0] = p[1]
605
606    def p_expr__enumeration(self, p):
607        "aexpr : enumeration"
608        p[0] = p[1]
609
610    def p_expr__func_call(self, p):
611        "aexpr : ident '(' exprs ')'"
612        p[0] = ast.FuncCallExprAST(self, p[1], p[3])
613
614    def p_expr__new(self, p):
615        "aexpr : NEW type"
616        p[0] = ast.NewExprAST(self, p[2])
617
618    def p_expr__null(self, p):
619        "aexpr : OOD"
620        p[0] = ast.OodAST(self)
621
622    # globally access a local chip component and call a method
623    def p_expr__local_chip_method(self, p):
624        "aexpr : THIS DOT var '[' expr ']' DOT var DOT ident '(' exprs ')'"
625        p[0] = ast.LocalChipMethodAST(self, p[3], p[5], p[8], p[10], p[12])
626
627    # globally access a local chip component and access a data member
628    def p_expr__local_chip_member(self, p):
629        "aexpr : THIS DOT var '[' expr ']' DOT var DOT field"
630        p[0] = ast.LocalChipMemberAST(self, p[3], p[5], p[8], p[10])
631
632    # globally access a specified chip component and call a method
633    def p_expr__specified_chip_method(self, p):
634        "aexpr : CHIP '[' expr ']' DOT var '[' expr ']' DOT var DOT ident '(' exprs ')'"
635        p[0] = ast.SpecifiedChipMethodAST(self, p[3], p[6], p[8], p[11], p[13],
636                                          p[15])
637
638    # globally access a specified chip component and access a data member
639    def p_expr__specified_chip_member(self, p):
640        "aexpr : CHIP '[' expr ']' DOT var '[' expr ']' DOT var DOT field"
641        p[0] = ast.SpecifiedChipMemberAST(self, p[3], p[6], p[8], p[11], p[13])
642
643    def p_expr__member(self, p):
644        "aexpr : aexpr DOT ident"
645        p[0] = ast.MemberExprAST(self, p[1], p[3])
646
647    def p_expr__member_method_call(self, p):
648        "aexpr : aexpr DOT ident '(' exprs ')'"
649        p[0] = ast.MemberMethodCallExprAST(self, p[1], p[3], p[5])
650
651    def p_expr__member_method_call_lookup(self, p):
652        "aexpr : aexpr '[' exprs ']'"
653        p[0] = ast.MemberMethodCallExprAST(self, p[1], "lookup", p[3])
654
655    def p_expr__class_method_call(self, p):
656        "aexpr : type DOUBLE_COLON ident '(' exprs ')'"
657        p[0] = ast.ClassMethodCallExprAST(self, p[1], p[3], p[5])
658
659    def p_expr__aexpr(self, p):
660        "expr : aexpr"
661        p[0] = p[1]
662
663    def p_expr__binary_op(self, p):
664        """expr : expr STAR  expr
665                | expr SLASH expr
666                | expr PLUS  expr
667                | expr DASH  expr
668                | expr LT    expr
669                | expr GT    expr
670                | expr LE    expr
671                | expr GE    expr
672                | expr EQ    expr
673                | expr NE    expr
674                | expr AND   expr
675                | expr OR    expr
676                | expr RIGHTSHIFT expr
677                | expr LEFTSHIFT  expr"""
678        p[0] = ast.InfixOperatorExprAST(self, p[1], p[2], p[3])
679
680    # FIXME - unary not
681    def p_expr__unary_op(self, p):
682        """expr : NOT expr
683                | DASH expr %prec UMINUS"""
684        p[0] = PrefixOperatorExpr(p[1], p[2])
685
686    def p_expr__parens(self, p):
687        "aexpr : '(' expr ')'"
688        p[0] = p[2]
689
690    def p_expr__is_valid_ptr(self, p):
691        "aexpr : IS_VALID '(' var ')'"
692        p[0] = ast.IsValidPtrExprAST(self, p[3], True)
693
694    def p_expr__is_invalid_ptr(self, p):
695        "aexpr : IS_INVALID '(' var ')'"
696        p[0] = ast.IsValidPtrExprAST(self, p[3], False)
697
698    def p_literal__string(self, p):
699        "literal : STRING"
700        p[0] = ast.LiteralExprAST(self, p[1], "std::string")
701
702    def p_literal__number(self, p):
703        "literal : NUMBER"
704        p[0] = ast.LiteralExprAST(self, p[1], "int")
705
706    def p_literal__float(self, p):
707        "literal : FLOATNUMBER"
708        p[0] = ast.LiteralExprAST(self, p[1], "int")
709
710    def p_literal__bool(self, p):
711        "literal : LIT_BOOL"
712        p[0] = ast.LiteralExprAST(self, p[1], "bool")
713
714    def p_enumeration(self, p):
715        "enumeration : ident ':' ident"
716        p[0] = ast.EnumExprAST(self, ast.TypeAST(self, p[1]), p[3])
717
718    def p_var(self, p):
719        "var : ident"
720        p[0] = ast.VarExprAST(self, p[1])
721
722    def p_field(self, p):
723        "field : ident"
724        p[0] = p[1]
725