9731e2aab08a030a4072987cb7e4032feeff45b1
[nit.git] / src / parser / nit.sablecc3xx
1
2 /* This file is part of NIT ( http://www.nitlanguage.org ).
3  *
4  * Copyright 2008-2009 Jean Privat <jean@pryen.org>
5  *
6  * Licensed under the Apache License, Version 2.0 (the "License");
7  * you may not use this file except in compliance with the License.
8  * You may obtain a copy of the License at
9  *
10  *     http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  */
18
19 /* This grammar defines the NIT language. */
20 Package org.nitlanguage.gen;
21
22 /*****************************************************************************/
23 Helpers
24 /*****************************************************************************/
25
26 all = [0 .. 0xFF];
27 lowercase = ['a' .. 'z'];
28 uppercase = ['A' .. 'Z'];
29 digit = ['0' .. '9'];
30 letter = lowercase | uppercase | digit | '_';
31
32 tab = 9;
33 cr = 13;
34 lf = 10;
35 any = [all - [cr + lf]];
36
37 // characers inside strings and super-strings (atomaton powaa)
38 str_char
39         = [any - [['"' + '{'] + '\']] 
40         | '\' any 
41         ;
42 str_body = str_char*;
43
44 extern_code_char
45         = [all - ['`' + '\']]
46         | '\' all
47         ;
48 extern_code_body = extern_code_char*;
49
50 eol_helper = cr lf | cr | lf; // This takes care of different platforms
51
52 /*****************************************************************************/
53 States
54 /*****************************************************************************/
55 initial;
56
57
58 /*****************************************************************************/
59 Tokens
60 /*****************************************************************************/
61
62 blank = (' ' | tab)+;
63
64 eol = eol_helper;
65 comment = '#' any* eol_helper?;
66
67 kwmodule = 'package'|'module';
68 kwimport = 'import';
69 kwclass = 'class';
70 kwabstract = 'abstract';
71 kwinterface = 'interface';
72 kwenum = 'universal'|'enum';
73 kwend = 'end';
74 kwmeth = 'fun';
75 kwtype = 'type';
76 kwinit = 'init';
77 kwredef = 'redef';
78 kwis = 'is';
79 kwdo = 'do';
80 kwreadable = 'readable';
81 kwwritable = 'writable';
82 kwvar = 'var';
83 kwintern = 'intern';
84 kwextern = 'extern';
85 kwprotected = 'protected';
86 kwprivate = 'private';
87 kwintrude = 'intrude';
88 kwif = 'if';
89 kwthen = 'then';
90 kwelse = 'else';
91 kwwhile = 'while';
92 kwloop = 'loop';
93 kwfor = 'for';
94 kwin = 'in';
95 kwand = 'and';
96 kwor = 'or';
97 kwnot = 'not';
98 kwreturn = 'return';
99 kwcontinue = 'continue';
100 kwbreak = 'break';
101 kwabort = 'abort';
102 kwassert = 'assert';
103 kwnew = 'new';
104 kwisa = 'isa';
105 kwonce = 'once';
106 kwsuper = 'super';
107 kwself = 'self';
108 kwtrue = 'true';
109 kwfalse = 'false';
110 kwnull = 'null';
111 kwas = 'as';
112 kwnullable = 'nullable';
113 kwisset = 'isset';
114 kwlabel = 'label';
115 kwdebug = '__debug__';
116
117 opar = '(';
118 cpar = ')';
119 obra = '[';
120 cbra = ']';
121 comma = ',';
122 column = ':';
123 quad = '::';
124 assign = '=';
125 pluseq = '+=';
126 minuseq = '-=';
127 dotdotdot = '...';
128 dotdot = '..';
129 dot = '.';
130 plus = '+';
131 minus = '-';
132 star = '*';
133 slash = '/';
134 percent = '%';
135 eq = '==';
136 ne = '!=';
137 lt = '<';
138 le = '<=';
139 ll = '<<';
140 gt = '>';
141 ge = '>=';
142 gg = '>>';
143 starship = '<=>';
144 bang='!';
145
146 classid = uppercase letter*;
147 id = lowercase letter*;
148 attrid = '_' lowercase letter*;
149
150 number = digit+;
151 float = digit* '.' digit+;
152 char = (''' [[any - '''] - '\'] ''') | (''' '\' any ''');
153 string = '"' str_body '"';
154 start_string = '"' str_body '{';
155 mid_string = '}' str_body '{';
156 end_string = '}' str_body '"';
157 bad_char = ''' '\'? any;
158 bad_string = ('"'|'}') str_body;
159
160 extern_code_segment = '`' '{' extern_code_body '`' '}';
161
162 /*****************************************************************************/
163 Ignored Tokens
164 /*****************************************************************************/
165
166 blank;
167
168 /*****************************************************************************/
169 Productions
170 /*****************************************************************************/
171
172 /* MODULES *******************************************************************/
173 module
174         = moduledecl? [imports]:import* [extern_bodies]:extern_code_body* [classdefs]:classdef* implicit_top_class? implicit_main_class? {-> New module(moduledecl, [imports.import], [extern_bodies.extern_code_block], [classdefs.classdef,implicit_top_class.classdef,implicit_main_class.classdef])};
175
176 moduledecl
177         = [doc]:no kwmodule no module_name [n2]:n1 {-> New moduledecl(doc.doc, kwmodule, module_name)};
178
179 import
180         = {std} [doc]:no visibility kwimport no module_name [n2]:n1 {-> New import.std(visibility, kwimport, module_name)}
181         | {no} [doc]:no visibility kwimport no kwend [n2]:n1 {-> New import.no(visibility, kwimport, kwend)}
182         ;
183
184 implicit_top_class {-> classdef}
185         = propdefs_toplevel+ {-> New classdef.top([propdefs_toplevel.propdef])};
186
187 implicit_main_class {-> classdef?}
188         = implicit_main_meth {-> New classdef.main([implicit_main_meth.propdef])}
189         | {null} n {-> Null}
190         ;
191 implicit_main_meth {-> propdef}
192         = [doc]:no stmts {-> New propdef.main_meth(Null, stmts.expr)}
193         | {n} [doc]:no stmtsn {-> New propdef.main_meth(Null, stmtsn.expr)}
194         ;
195
196 /* CLASSES *******************************************************************/
197 classdef
198         = [doc]:no redef visibility classkind no classid formaldefs? extern_code_block? [superclasses]:superclass* propdefs* [n2]:no kwend {-> New classdef.std(doc.doc, redef.kwredef, visibility, classkind, classid, [formaldefs.formaldef], extern_code_block, [superclasses.superclass], [propdefs.propdef], kwend)};
199 redef {-> kwredef?}
200         = kwredef? {-> kwredef};
201 classkind
202         = {concrete} kwclass
203         | {abstract} kwabstract kwclass
204         | {interface} kwinterface
205         | {enum} kwenum
206         | {extern} kwextern kwclass?
207         ;
208
209 formaldefs {-> formaldef*}
210         = obra no formaldef formaldefs_tail* [n2]:no cbra {-> [formaldef, formaldefs_tail.formaldef]};
211 formaldefs_tail {-> formaldef}
212         = comma no formaldef {-> formaldef};
213 formaldef
214         = classid typing? {-> New formaldef(classid, typing.type)};
215
216 superclass {-> superclass}
217         = {super} no kwsuper [n2]:no type {-> New superclass(kwsuper, type)}
218         ;
219
220 propdefs~toplevel {-> propdef}
221         = propdef~toplevel n1 {-> propdef~toplevel.propdef}
222         ;
223 propdef~toplevel {-> propdef}
224         = {meth} [doc]:no redef visibility kwmeth methid signature kwdo stmtso kwend? {-> New propdef.concrete_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature, stmtso.expr)}
225         | {assign_return} [doc]:no redef visibility kwmeth methid signature_withret assign no assign_return {-> New propdef.concrete_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature_withret.signature, assign_return.expr)}
226 !toplevel| {deferred} [doc]:no redef visibility kwmeth methid signature kwis kwabstract {-> New propdef.deferred_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature.signature)}
227 !toplevel| {intern} [doc]:no redef visibility kwmeth methid signature kwis kwintern {-> New propdef.intern_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature.signature)}
228         | {extern} [doc]:no redef visibility kwmeth methid signature kwis kwextern string? extern_calls? extern_code_block? {-> New propdef.extern_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature.signature, string, extern_calls, extern_code_block)}
229         | {extern_implicit} [doc]:no redef visibility kwmeth methid signature extern_calls? extern_code_block {-> New propdef.extern_meth(doc.doc, redef.kwredef, visibility, kwmeth, methid, signature.signature, Null, extern_calls, extern_code_block)}
230 !toplevel| {var} [doc]:no readable? writable? redef visibility kwvar attrid typing? {-> New propdef.attr(doc.doc, readable.able, writable.able, redef.kwredef, visibility, kwvar, attrid, Null, typing.type, Null)}
231 !toplevel| {var2} [doc]:no readable? writable? redef visibility kwvar attrid typing? assign [n2]:no expr {-> New propdef.attr(doc.doc, readable.able, writable.able, redef.kwredef, visibility, kwvar, attrid, Null, typing.type, expr)}
232 !toplevel| {var3} [doc]:no redef visibility kwvar id typing? writable2? {-> New propdef.attr(doc.doc, Null, writable2.able, redef.kwredef, visibility, kwvar, Null, id, typing.type, Null)}
233 !toplevel| {var4} [doc]:no redef visibility kwvar id typing? writable2? assign [n2]:no expr {-> New propdef.attr(doc.doc, Null, writable2.able, redef.kwredef, visibility, kwvar, Null, id, typing.type, expr)}
234 !toplevel| {init} [doc]:no redef visibility kwinit methid? signature kwdo stmtso kwend? {-> New propdef.concrete_init(doc.doc, redef.kwredef, visibility, kwinit, methid, signature, stmtso.expr)}
235 !toplevel| {type} [doc]:no redef visibility kwtype classid typing {-> New propdef.type(doc.doc, redef.kwredef, visibility, kwtype, classid, typing.type)}
236 !toplevel| {extern_init} [doc]:no redef visibility kwnew methid? signature kwis kwextern string? extern_calls? extern_code_block? {-> New propdef.extern_init(doc.doc, redef.kwredef, visibility, kwnew, methid, signature, string, extern_calls, extern_code_block)}
237 !toplevel| {extern_init_implicit} [doc]:no redef visibility kwnew methid? signature string? extern_calls? extern_code_block {-> New propdef.extern_init(doc.doc, redef.kwredef, visibility, kwnew, methid, signature, string, extern_calls, extern_code_block)}
238         ;
239 readable {-> able}
240         = redef kwreadable {-> New able.read(redef.kwredef, kwreadable)}
241         ;
242 writable {-> able}
243         = redef kwwritable {-> New able.write(redef.kwredef, Null, kwwritable)}
244         ;
245 writable2 {-> able}
246         = redef visibility kwwritable {-> New able.write(redef.kwredef, visibility, kwwritable)}
247         ;
248
249 visibility
250         = {public} {-> New visibility.public()}
251         | {private} kwprivate no {-> New visibility.private(kwprivate)}
252         | {protected} kwprotected no {-> New visibility.protected(kwprotected)}
253         | {intrude} kwintrude no {-> New visibility.intrude(kwintrude)}
254         ;
255
256 methid {-> methid}
257         = {id} id {-> New methid.id(id)}
258         | {plus} plus {-> New methid.plus(plus)}
259         | {minus} minus {-> New methid.minus(minus)}
260         | {star} star {-> New methid.star(star)}
261         | {slash} slash {-> New methid.slash(slash)}
262         | {percent} percent {-> New methid.percent(percent)}
263         | {eq} eq {-> New methid.eq(eq)}
264         | {ne} ne {-> New methid.ne(ne)}
265         | {le} le {-> New methid.le(le)}
266         | {ge} ge {-> New methid.ge(ge)}
267         | {lt} lt {-> New methid.lt(lt)}
268         | {gt} gt {-> New methid.gt(gt)}
269         | {ll} ll {-> New methid.ll(ll)}
270         | {gg} gg {-> New methid.gg(gg)}
271         | {bra} obra cbra {-> New methid.bra(obra, cbra)}
272         | {starship} starship {-> New methid.starship(starship)}
273         | {assign} id assign {-> New methid.assign(id, assign)}
274         | {braassign} obra cbra assign {-> New methid.braassign(obra, cbra, assign)}
275         ;
276
277 signature~withret {-> signature}
278         = opar no params? cpar typing [no2]:no closure_decls? {-> New signature(opar, [params.param], cpar, typing.type, [closure_decls.closure_decl])}
279 !withret| {noret} opar no params? cpar [no2]:no closure_decls? {-> New signature(opar, [params.param], cpar, Null, [closure_decls.closure_decl])}
280         | {nopar} typing no closure_decls? {-> New signature(Null, [], Null, typing.type, [closure_decls.closure_decl])}
281 !withret| {noparnoret} no closure_decls? {-> New signature(Null, [], Null, Null, [closure_decls.closure_decl])}
282         ;
283
284 signature_noclosures {-> signature}
285         = opar no params? cpar typing? {-> New signature(opar, [params.param], cpar, typing.type, [])}
286         | {nopar} typing? {-> New signature(Null, [], Null, typing.type, [])}
287         ;
288
289 params {-> param*} 
290         = param params_tail* [n2]:no {-> [param, params_tail.param] }
291         ;
292 params_tail {-> param}
293         = comma no param {-> param};
294 param
295         = {untyped} id {-> New param(id, Null, Null)}
296         | id typing dotdotdot? {-> New param(id, typing.type, dotdotdot)}
297         ;
298
299 closure_decls {->closure_decl*}
300         = closure_decl+ {-> [closure_decl]};
301 closure_decl
302         = kwbreak? bang id signature_noclosures n {-> New closure_decl(kwbreak, bang, id, signature_noclosures.signature, Null)}
303         | {optionnal} kwbreak? bang id signature_noclosures kwdo stmtso n {-> New closure_decl(kwbreak, bang, id, signature_noclosures.signature, stmtso.expr)}
304         | {assign} kwbreak? bang id signature_noclosures assign no assign_continue n {-> New closure_decl(kwbreak, bang, id, signature_noclosures.signature, assign_continue.expr)}
305         ;
306
307 assign_return{-> expr}
308         = expr_final {-> New expr.return(Null, expr_final.expr)}
309         ;
310
311 extern_calls {-> extern_calls}
312         = kwimport no extern_call extern_call_tail* {-> New extern_calls( kwimport, [extern_call, extern_call_tail.extern_call] )}
313         ;
314 extern_call_tail {-> extern_call}
315         = comma no extern_call {-> extern_call};
316 extern_call {-> extern_call}
317     = {prop} extern_call_prop {-> extern_call_prop.extern_call}
318     | {cast} extern_call_cast {-> extern_call_cast.extern_call}
319         | {super} kwsuper {-> New extern_call.super( kwsuper )}
320     ;
321 extern_call_prop {-> extern_call}
322     = {local} methid {-> New extern_call.local_prop( methid )}
323         | {full} classid quad methid {-> New extern_call.full_prop( classid, quad, methid )}
324         | {init} classid {-> New extern_call.init_prop( classid )}
325         ;
326 extern_call_cast {-> extern_call}
327     = {as_cast} [from_type]:type kwas [n2]:no opar [n3]:no [to_type]:type [n4]:no cpar {-> New extern_call.cast_as(from_type, kwas, to_type)}
328         | {as_nullable} type kwas [n2]:no kwnullable {-> New extern_call.as_nullable( type, kwas, kwnullable)}
329         | {as_not_nullable} type kwas [n2]:no kwnot [n3]:no kwnullable {-> New extern_call.as_not_nullable( type, kwas, kwnot, kwnullable)}
330         ;
331
332 in_language = kwin string;
333 extern_code_block = in_language? extern_code_segment;
334 extern_code_body {-> extern_code_block} = no extern_code_block {-> extern_code_block};
335
336 /* TYPES *********************************************************************/
337 type~nobra {-> type}
338         = {simple} kwnullable? classid {-> New type(kwnullable, classid, [])}
339 !nobra  | {generic} kwnullable? classid obra no types [n2]:no cbra {-> New type(kwnullable, classid, [types.type])}
340         ;
341 types {-> type*} 
342         = type types_tail* {-> [type, types_tail.type]};
343 types_tail {-> type}
344         = comma no type {-> type};
345 typing {-> type}
346         = column no type {-> type};
347
348 /* STATMENTS *****************************************************************/
349 stmtso~withelse~withend {-> expr?}
350         = {block} n stmtsnend {-> stmtsnend.expr}
351         | {emptyblock} n kwend {-> New expr.block([], kwend)}
352         | {emptyoneline} kwend {-> New expr.block([], kwend)}
353 !withend| {oneline} stmt~withelse {-> stmt~withelse.expr}
354         ;
355 stmts {-> expr}
356         = stmt stmts_tail* {-> New expr.block([stmt.expr, stmts_tail.expr], Null)};
357 stmtsn {-> expr}
358         = stmt stmts_tail* n {-> New expr.block([stmt.expr, stmts_tail.expr], Null)};
359 stmtsnend {-> expr}
360         = stmt stmts_tail* n kwend {-> New expr.block([stmt.expr, stmts_tail.expr], kwend)};
361 stmts_tail {-> expr}
362         = n stmt {-> stmt.expr};
363 stmt~withelse {-> expr}
364         = {vardecl} vardecl~withelse {-> vardecl~withelse.expr}
365         | {assign} assignment~withelse {-> assignment~withelse.expr}
366         | {return} kwreturn expr_final~withelse? {-> New expr.return(kwreturn, expr_final~withelse.expr)}
367         | {break} kwbreak label? expr_final~withelse? {-> New expr.break(kwbreak, label, expr_final~withelse.expr)}
368         | {abort} kwabort {-> New expr.abort(kwabort)}
369         | {continue} kwcontinue label? expr_final~withelse? {-> New expr.continue(kwcontinue, label, expr_final~withelse.expr)}
370         | {do} do~withelse {-> do~withelse.expr}
371         | {if} if~withelse {-> if~withelse.expr}
372         | {while} while~withelse {-> while~withelse.expr}
373         | {loop} loop~withelse {-> loop~withelse.expr}
374         | {for} for~withelse {-> for~withelse.expr}
375         | {assert} assert~withelse {-> assert~withelse.expr}
376         | {call} recv id args_nopar closure_defs~withelse? {-> New expr.call(recv.expr, id, args_nopar.exprs, [closure_defs~withelse.closure_def])}
377         | {super} qualified? kwsuper args_nopar {-> New expr.super(qualified, kwsuper, args_nopar.exprs)}
378         | {init} recv kwinit args_nopar {-> New expr.init(recv.expr, kwinit, args_nopar.exprs)}
379         | {debug_type_is} kwdebug kwtype type column expr_final~withelse {-> New expr.debug_type(kwdebug, kwtype, expr_final~withelse.expr, type) }
380         ;
381
382 label= kwlabel id;
383
384 closure_defs~withelse {-> closure_def*}
385         = {one} closure_def_last~withelse {-> [closure_def_last~withelse.closure_def]}
386         | closure_def closure_defs~withelse {-> [closure_def, closure_defs~withelse.closure_def]}
387         ;
388
389 closure_def_last~withelse {-> closure_def}
390         = bang [id]:closure_id idlist? kwdo stmtso_withend label {-> New closure_def(bang, id, [idlist.id], kwdo, stmtso_withend.expr, label)}
391         | {nolabel} bang [id]:closure_id idlist? kwdo stmtso~withelse {-> New closure_def(bang, id, [idlist.id], kwdo, stmtso~withelse.expr, Null)}
392         | {assign} bang [id]:closure_id idlist? assign no assign_continue~withelse {-> New closure_def(bang, id, [idlist.id], Null, assign_continue~withelse.expr, Null)}
393         ;
394
395 closure_def {-> closure_def}
396         = bang [id]:closure_id idlist? kwdo n stmtsn {-> New closure_def(bang, id, [idlist.id], kwdo, stmtsn.expr, Null)}
397         | {empty} bang [id]:closure_id idlist? kwdo n {-> New closure_def(bang, id, [idlist.id], kwdo, Null, Null)}
398         ;
399 closure_id
400         = {simple} id
401         | {break} kwbreak
402         ;
403
404 assign_continue~withelse{-> expr}
405         = expr_final~withelse {-> New expr.continue(Null, Null, expr_final~withelse.expr)}
406         ;
407
408 vardecl~withelse{-> expr}
409         = kwvar id typing? {-> New expr.vardecl(kwvar, id, typing.type, Null, Null)}
410         | {assign} kwvar id typing? assign no expr_final~withelse {-> New expr.vardecl(kwvar, id, typing.type, assign, expr_final~withelse.expr)}
411         ;
412
413 assignment~withelse {-> expr}
414         = {attr} recv attrid assign expr_final~withelse {-> New expr.attr_assign(recv.expr, attrid, assign, expr_final~withelse.expr)}
415         | {call} recv id args assign expr_final~withelse {-> New expr.call_assign(recv.expr, id, args.exprs, assign,  expr_final~withelse.expr)}
416         | {bra} expr_atom braargs assign expr_final~withelse {-> New expr.bra_assign(expr_atom.expr, braargs.exprs, assign,  expr_final~withelse.expr)}
417         | {attr_re} recv attrid assign_op expr_final~withelse {-> New expr.attr_reassign(recv.expr, attrid, assign_op,  expr_final~withelse.expr)}
418         | {call_re} recv id args assign_op expr_final~withelse {-> New expr.call_reassign(recv.expr, id, args.exprs, assign_op,  expr_final~withelse.expr)}
419         | {bra_re} expr_atom braargs assign_op expr_final~withelse {-> New expr.bra_reassign(expr_atom.expr, braargs.exprs, assign_op,  expr_final~withelse.expr)}
420         ;
421 assign_op
422         = {plus} pluseq
423         | {minus} minuseq
424         ;
425
426 do~withelse {-> expr}
427         = kwdo stmtso_withend label {-> New expr.do(kwdo, stmtso_withend.expr, label)}
428         | {nolabel} kwdo stmtso~withelse {-> New expr.do(kwdo, stmtso~withelse.expr, Null)}
429         ;
430
431 if~withelse {-> expr}
432         = {onelineelse} kwif no expr [n2]:no kwthen stmt_withelse kwelse stmtso~withelse {-> New expr.if(kwif, expr, stmt_withelse.expr, stmtso~withelse.expr)}
433 !withelse       | {oneline} kwif no expr [n2]:no kwthen stmt {-> New expr.if(kwif, expr, stmt.expr, Null)}
434 !withelse       | {block} kwif no expr [n2]:no kwthen [n3]:n stmtsn elsepartblock {-> New expr.if(kwif, expr, stmtsn.expr, elsepartblock.expr)}
435 !withelse       | {emptyblock} kwif no expr [n2]:no kwthen [n3]:n? elsepartblock {-> New expr.if(kwif, expr, Null, elsepartblock.expr)}
436         ;
437 elsepartblock {-> expr?}
438         = {else} kwelse stmtso {-> stmtso.expr}
439         | {empty} kwend {-> New expr.block([], kwend)}
440         ;
441
442 loop~withelse {-> expr}
443         = kwloop stmtso_withend label {-> New expr.loop(kwloop, stmtso_withend.expr, label)}
444         | {nolabel} kwloop stmtso~withelse {-> New expr.loop(kwloop, stmtso~withelse.expr, Null)}
445         ;
446
447 while~withelse {-> expr}
448         = kwwhile no expr [n2]:no kwdo stmtso_withend label {-> New expr.while(kwwhile, expr, kwdo, stmtso_withend.expr, label)}
449         | {nolabel} kwwhile no expr [n2]:no kwdo stmtso~withelse {-> New expr.while(kwwhile, expr, kwdo, stmtso~withelse.expr, Null)}
450         ;
451
452 for~withelse {-> expr}
453         = kwfor no [ids]:idlist [n2]:no kwin [n3]:no expr [n4]:no kwdo stmtso_withend label {-> New expr.for(kwfor, [ids.id], expr, kwdo, stmtso_withend.expr, label)}
454         | {nolabel} kwfor no [ids]:idlist [n2]:no kwin [n3]:no expr [n4]:no kwdo stmtso~withelse {-> New expr.for(kwfor, [ids.id], expr, kwdo, stmtso~withelse.expr, Null)}
455         ;
456
457 assert~withelse {-> expr}
458         = {else} kwassert assertid? expr_final_withelse kwelse stmtso~withelse {-> New expr.assert(kwassert, assertid.id, expr_final_withelse.expr, stmtso~withelse.expr)}
459 !withelse| {noelse} kwassert assertid? expr_final {-> New expr.assert(kwassert, assertid.id, expr_final.expr, Null)}
460         ;
461 assertid {-> id}
462         = id column {-> id};
463
464 /* EXPRESSIONS ***************************************************************/
465 expr_final~nopar~withelse~nobra {-> expr}
466         = expr~nopar~nobra {-> expr~nopar~nobra.expr}
467         | {closure_call} recv~nobra id args closure_defs~withelse {-> New expr.call(recv~nobra.expr, id, args.exprs, [closure_defs~withelse.closure_def])}
468 !nobra!nopar    | {closure_bra} expr_atom braargs closure_defs~withelse {-> New expr.bra(expr_atom.expr, braargs.exprs, [closure_defs~withelse.closure_def])}
469         ;
470
471 expr~nopar~nobra {-> expr}
472         = expr_and~nopar~nobra {-> expr_and~nopar~nobra.expr}
473         | {ifexpr} kwif [n1]:no expr [n2]:no kwthen [n3]:no [then]:expr [n4]:no kwelse [n5]:no [else]:expr~nopar~nobra {-> New expr.ifexpr(kwif, expr, kwthen, then, kwelse, else.expr)}
474         ;
475
476 expr_and~nopar~nobra {-> expr}
477         = expr_not~nopar~nobra {-> expr_not~nopar~nobra.expr}
478         | {:or} expr_and~nopar~nobra :kwor :no expr_not~nopar~nobra
479         | {:and} expr_and~nopar~nobra :kwand :no expr_not~nopar~nobra
480         | {:or_else} expr_and~nopar~nobra :kwor :kwelse :no expr_not~nopar~nobra
481         ;
482
483 expr_not~nopar~nobra {-> expr}
484         = expr_eq~nopar~nobra {-> expr_eq~nopar~nobra.expr}
485         | {not} kwnot no expr_not~nopar~nobra {-> New expr.not(kwnot, expr_not~nopar~nobra.expr)}
486         ;
487
488 expr_eq~nopar~nobra {-> expr}
489         = expr_add~nopar~nobra {-> expr_add~nopar~nobra.expr}
490         | {:eq} expr_add~nopar~nobra :eq :no [expr2]:expr_add~nopar~nobra
491         | {:ee} expr_add~nopar~nobra :kwis :no [expr2]:expr_add~nopar~nobra
492         | {:ne} expr_add~nopar~nobra :ne :no [expr2]:expr_add~nopar~nobra
493         | {:lt} expr_add~nopar~nobra :lt :no [expr2]:expr_add~nopar~nobra
494         | {:le} expr_add~nopar~nobra :le :no [expr2]:expr_add~nopar~nobra
495         | {:ll} expr_eq~nopar~nobra :ll :no [expr2]:expr_add~nopar~nobra
496         | {:gt} expr_add~nopar~nobra :gt :no [expr2]:expr_add~nopar~nobra
497         | {:ge} expr_add~nopar~nobra :ge :no [expr2]:expr_add~nopar~nobra
498         | {:gg} expr_eq~nopar~nobra :gg :no [expr2]:expr_add~nopar~nobra
499         | {:starship} expr_add~nopar~nobra :starship :no [expr2]:expr_add~nopar~nobra
500         | {:isa} expr_add~nopar~nobra :kwisa :no type~nobra
501         ;
502
503 expr_add~nopar~nobra {-> expr}
504         =  expr_mul~nopar~nobra {-> expr_mul~nopar~nobra.expr}
505         | {:plus} expr_add~nopar~nobra :plus :no [expr2]:expr_mul~nopar~nobra
506         | {:minus} expr_add~nopar~nobra :minus :no [expr2]:expr_mul~nopar~nobra
507         ;
508
509 expr_mul~nopar~nobra {-> expr}
510         = expr_minus~nopar~nobra {-> expr_minus~nopar~nobra.expr}
511         | {:star} expr_mul~nopar~nobra :star :no [expr2]:expr_minus~nopar~nobra
512         | {:slash} expr_mul~nopar~nobra :slash :no [expr2]:expr_minus~nopar~nobra
513         | {:percent} expr_mul~nopar~nobra :percent :no [expr2]:expr_minus~nopar~nobra
514         ;
515
516 expr_minus~nopar~nobra {-> expr}
517         = expr_new~nopar~nobra {-> expr_new~nopar~nobra.expr}
518         | {:uminus} minus :no expr_minus~nopar~nobra
519         | {:once} kwonce :no expr_minus~nopar~nobra
520         ;
521
522 expr_new~nopar~nobra {-> expr}
523         = expr_atom~nopar~nobra {-> expr_atom~nopar~nobra.expr}
524         | {new} kwnew no type~nobra args {-> New expr.new(kwnew, type~nobra.type, Null, args.exprs)}
525         | {isset_attr} kwisset recv~nopar~nobra attrid {-> New expr.isset_attr(kwisset, recv~nopar~nobra.expr, attrid)}
526         ;
527
528 expr_atom~nopar~nobra {-> expr}
529         = {attr} recv~nopar~nobra attrid {-> New expr.attr(recv~nopar~nobra.expr, attrid)}
530         | {call} recv~nopar~nobra id args {-> New expr.call(recv~nopar~nobra.expr, id, args.exprs, [])}
531         | {super} qualified? kwsuper args {-> New expr.super(qualified, kwsuper, args.exprs)}
532         | {init} recv~nopar~nobra kwinit args {-> New expr.init(recv~nopar~nobra.expr, kwinit, args.exprs)}
533 !nobra  | {bra} expr_atom~nopar braargs {-> New expr.bra(expr_atom~nopar.expr, braargs.exprs, [])}
534         | {new} kwnew no type~nobra dot [n2]:no id args {-> New expr.new(kwnew, type~nobra.type, id, args.exprs)}
535 // !nopar to unambiguise 'foo[5].bar' between '(foo[5]).bar' and 'foo([5].bar),
536 !nobra!nopar    | {range} obra no expr [n2]:no dotdot [n3]:no [expr2]:expr_nobra [n4]:no cbra {-> New expr.crange(obra, expr, expr2.expr, cbra)}
537 !nobra!nopar    | {orange} obra no expr [n2]:no dotdot [n3]:no [expr2]:expr_nobra [n4]:no [cbra]:obra  {-> New expr.orange(obra, expr, expr2.expr, cbra)}
538 !nobra!nopar    | {array} braargs {-> New expr.array(braargs.exprs)}
539         | {:self} kwself
540         | {:true} kwtrue
541         | {:false} kwfalse
542         | {:null} kwnull
543         | {:int} number
544         | {:float} float
545         | {:char} char
546         | {:string} string
547         | {superstring} superstring  {-> superstring.expr}
548 !nopar  | {par} opar expr cpar {-> New expr.par(opar, expr, cpar)}
549         | {as_cast} expr_atom~nopar~nobra dot no kwas [n2]:no opar [n3]:no type [n4]:no cpar {-> New expr.as_cast(expr_atom~nopar~nobra.expr, kwas, opar, type, cpar)}
550         | {as_notnull} expr_atom~nopar~nobra dot no kwas [n2]:no opar [n3]:no kwnot [n4]:no kwnull [n5]:no cpar {-> New expr.as_notnull(expr_atom~nopar~nobra.expr, kwas, opar, kwnot, kwnull, cpar)}
551         ;
552
553 superstring {-> expr} 
554         = superstring_start superstring_middle* superstring_end {-> New expr.superstring([superstring_start.expr, superstring_middle.expr, superstring_end.expr])};
555 superstring_start {-> expr*}
556         = start_string_p no expr [n2]:no {-> [start_string_p.expr, expr]};
557 start_string_p {-> expr}
558         = start_string {-> New expr.start_string(start_string)};
559 superstring_middle {-> expr*}
560         = mid_string_p no expr [n2]:no {-> [mid_string_p.expr, expr]};
561 mid_string_p {-> expr}
562         = mid_string {-> New expr.mid_string(mid_string)};
563 superstring_end {-> expr}
564         = end_string {-> New expr.end_string(end_string)};
565
566 /* MISC **********************************************************************/
567
568 recv~nopar~nobra {-> expr}
569         = expr_atom~nopar~nobra dot no {-> expr_atom~nopar~nobra.expr}
570         | {implicit} {-> New expr.implicit_self()}
571         ;
572
573 args {-> exprs}
574         = opar no expr_list cpar {-> New exprs.par(opar, [expr_list.expr], cpar) }
575         | {emptypar} opar no cpar {-> New exprs.par(opar, [], cpar) }
576         | {empty} {-> New exprs.list([])}
577         ;
578 args_nopar {-> exprs}
579         = opar no expr_list cpar {-> New exprs.par(opar, [expr_list.expr], cpar) }
580         | {onearg} expr_nopar {-> New exprs.list([expr_nopar.expr])}
581         | {emptypar} opar no cpar {-> New exprs.par(opar, [], cpar) }
582         | {empty} {-> New exprs.list([])}
583         ;
584 braargs {-> exprs}
585         = obra no expr_list cbra {-> New exprs.bra(obra, [expr_list.expr], cbra)};
586 expr_list {-> expr*}
587         = expr [n2]:no expr_tail* {-> [expr, expr_tail.expr]};
588 expr_tail {-> expr} 
589         = comma no expr [n2]:no {-> expr};
590 idlist {-> id*}
591         = opar idlist_nopar cpar {-> [idlist_nopar.id]}
592         | {nopar} idlist_nopar {-> [idlist_nopar.id]}
593         ;
594 idlist_nopar {-> id*}
595         = {single} id {-> [id]}
596         | {more} idlist_nopar no comma [n2]:no id {-> [idlist_nopar.id, id]}
597         ;
598
599 module_name {-> module_name}
600         = {mod} modquad* id {-> New module_name(Null, [modquad.id], id)}
601         | {root} quad no modquad* id {-> New module_name(quad, [modquad.id], id)}
602         ;
603
604 qualified 
605         = {cla} modquad* classquad {-> New qualified([modquad.id], classquad.classid)}
606         | {mod} modquad+ {-> New qualified([modquad.id], Null)}
607         ; 
608 modquad {-> id}
609         = id quad no {-> id};
610 classquad {-> classid} 
611         = classid quad no {-> classid};
612
613 n1      = {a} comment | {b} eol;
614 n {-> doc?}
615         = {a} n2? comment+ {-> New doc([comment])}
616         | {b} n2 {-> Null}
617         ;
618 no {-> doc?}
619         = {empty} {-> Null}
620         | n {-> n.doc}
621         ;
622
623 n2
624         = {a} n2? comment+ eol+
625         | {b} eol+
626         ;
627
628 /*****************************************************************************/
629 Abstract Syntax Tree
630 /*****************************************************************************/
631
632 module  = moduledecl? [imports]:import* [extern_code_blocks]:extern_code_block* [classdefs]:classdef*;
633
634 moduledecl
635         = doc? kwmodule [name]:module_name;
636
637 import  = {std} visibility kwimport [name]:module_name
638         | {no} visibility kwimport kwend
639         ;
640
641 visibility
642         = {public}
643         | {private} kwprivate
644         | {protected} kwprotected
645         | {intrude} kwintrude
646         ;
647
648 classdef= {std} doc? kwredef? visibility classkind [id]:classid? [formaldefs]:formaldef* extern_code_block? [superclasses]:superclass* [propdefs]:propdef* kwend
649         | {top} [propdefs]:propdef*
650         | {main} [propdefs]:propdef*
651         ;
652 classkind
653         = {concrete} kwclass
654         | {abstract} kwabstract kwclass
655         | {interface} kwinterface
656         | {enum} kwenum
657         | {extern} kwextern kwclass?
658         ;
659 formaldef = [id]:classid type?;
660 superclass = kwsuper type;
661
662
663 propdef = {attr} doc? [readable]:able? [writable]:able? kwredef? visibility kwvar [id]:attrid? [id2]:id? type? expr?
664         | {meth} doc? kwredef? visibility methid signature
665         | {deferred_meth} doc? kwredef? visibility kwmeth methid signature
666         | {intern_meth} doc? kwredef? visibility kwmeth methid signature
667         | {extern_meth} doc? kwredef? visibility kwmeth methid signature [extern]:string? extern_calls? extern_code_block?
668         | {concrete_meth} doc? kwredef? visibility kwmeth methid signature [block]:expr?
669         | {concrete_init} doc? kwredef? visibility kwinit methid? signature [block]:expr?
670         | {extern_init} doc? kwredef? visibility kwnew methid? signature [extern]:string? extern_calls? extern_code_block?
671         | {main_meth} kwredef? [block]:expr?
672         | {type} doc? kwredef? visibility kwtype [id]:classid type
673         ;
674
675 able    = {read} kwredef? kwreadable
676         | {write} kwredef? visibility? kwwritable
677         ;
678
679 methid = {id} id | {plus} plus | {minus} minus | {star} star | {slash} slash | {percent} percent | {eq} eq | {ne} ne | {le} le | {ge} ge | {lt} lt | {gt} gt |  {ll} ll | {gg} gg | {bra} obra cbra | {starship} starship | {assign} id assign | {braassign} obra cbra assign;
680
681 signature = opar? [params]:param* cpar? type? [closure_decls]:closure_decl*;
682
683 param   = id type? dotdotdot?
684         ;
685
686 closure_decl = kwbreak? bang id signature expr?
687         ;
688
689 type    = kwnullable? [id]:classid [types]:type*;
690
691 label = kwlabel id;
692
693 expr    = {block} expr* kwend? 
694         | {vardecl} kwvar id type? assign? expr? 
695         | {return} kwreturn? expr?
696         | {break} kwbreak label? expr?
697         | {abort} kwabort
698         | {continue} kwcontinue? label? expr?
699         | {do} kwdo [block]:expr? label?
700         | {if} kwif expr [then]:expr? [else]:expr? 
701         | {ifexpr} kwif expr kwthen [then]:expr kwelse [else]:expr
702         | {while} kwwhile expr kwdo [block]:expr? label?
703         | {loop} kwloop [block]:expr? label?
704         | {for} kwfor [ids]:id* expr kwdo [block]:expr? label?
705         | {assert} kwassert id? expr [else]:expr?
706         | {once} kwonce expr 
707         | {send} expr 
708         | {binop} expr [expr2]:expr 
709         | {or} expr [expr2]:expr 
710         | {and} expr [expr2]:expr 
711         | {or_else} expr [expr2]:expr
712         | {not} kwnot expr 
713         | {eq} expr [expr2]:expr 
714         | {ee} expr [expr2]:expr 
715         | {ne} expr [expr2]:expr 
716         | {lt} expr [expr2]:expr 
717         | {le} expr [expr2]:expr 
718         | {ll} expr [expr2]:expr
719         | {gt} expr [expr2]:expr 
720         | {ge} expr [expr2]:expr 
721         | {gg} expr [expr2]:expr
722         | {isa} expr type 
723         | {plus} expr [expr2]:expr 
724         | {minus} expr [expr2]:expr 
725         | {starship} expr [expr2]:expr 
726         | {star} expr [expr2]:expr 
727         | {slash} expr [expr2]:expr 
728         | {percent} expr [expr2]:expr 
729         | {uminus} minus expr 
730         | {new} kwnew type id? [args]:exprs
731         | {attr} expr [id]:attrid 
732         | {attr_assign} expr [id]:attrid assign [value]:expr 
733         | {attr_reassign} expr [id]:attrid assign_op [value]:expr 
734         | {call} expr id [args]:exprs [closure_defs]:closure_def*
735         | {call_assign} expr id [args]:exprs assign [value]:expr 
736         | {call_reassign} expr id [args]:exprs assign_op [value]:expr 
737         | {super} qualified? kwsuper [args]:exprs
738         | {init} expr kwinit [args]:exprs 
739         | {bra} expr [args]:exprs [closure_defs]:closure_def* 
740         | {bra_assign} expr [args]:exprs assign [value]:expr 
741         | {bra_reassign} expr [args]:exprs assign_op [value]:expr 
742         | {closure_call} id [args]:exprs [closure_defs]:closure_def*
743         | {var} id
744         | {var_assign} id assign [value]:expr 
745         | {var_reassign} id assign_op [value]:expr 
746         | {range} expr [expr2]:expr 
747         | {crange} obra expr [expr2]:expr cbra
748         | {orange} obra expr [expr2]:expr [cbra]:obra
749         | {array} [exprs]:exprs
750         | {self} kwself 
751         | {implicit_self} 
752         | {true} kwtrue 
753         | {false} kwfalse 
754         | {null} kwnull
755         | {int} number
756         | {float} float
757         | {char} char
758         | {string} string 
759         | {start_string} [string]:start_string 
760         | {mid_string} [string]:mid_string 
761         | {end_string} [string]:end_string 
762         | {superstring} [exprs]:expr*
763         | {par} opar expr cpar
764         | {as_cast} expr kwas opar type cpar
765         | {as_notnull} expr kwas opar kwnot kwnull cpar
766         | {isset_attr} kwisset expr [id]:attrid
767         | {debug_type} kwdebug kwtype expr type
768         ;
769 exprs
770         = {list} [exprs]:expr*
771         | {par} opar [exprs]:expr* cpar
772         | {bra} obra [exprs]:expr* cbra
773         ;
774 assign_op
775         = {plus} pluseq
776         | {minus} minuseq
777         ;
778
779 closure_def
780         = bang [id]:closure_id [ids]:id* kwdo? expr? label?
781         ;
782 closure_id
783         = {simple} id
784         | {break} kwbreak
785         ;
786
787 module_name = quad? [path]:id* id;
788 extern_calls = kwimport [extern_calls]:extern_call*
789         ;
790 extern_call =
791         | {super} kwsuper
792         | {local_prop} methid
793         | {full_prop} classid quad? methid
794         | {init_prop} classid
795         | {cast_as} [from_type]:type kwas [to_type]:type
796         | {as_nullable} type kwas kwnullable
797         | {as_not_nullable} type kwas kwnot kwnullable
798         ;
799 in_language = kwin string;
800 extern_code_block = in_language? extern_code_segment;
801
802 qualified = id* classid? ;
803
804 doc = comment+;
805
806 /*****************************************************************************/
807