public
Description: The metalua programming language
Homepage: http://metalua.luaforge.net
Clone URL: git://github.com/fab13n/metalua.git
metalua / src / samples / synth.mlua
100644 561 lines (504 sloc) 17.593 kb
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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
require 'strict'
 
-{ extension 'match' }
 
synth = { }
synth.__index = synth
 
--------------------------------------------------------------------------------
-- Instanciate a new AST->source synthetizer
--------------------------------------------------------------------------------
function synth.new ()
   local self = {
      _acc = { }, -- Accumulates pieces of source as strings
      current_indent = 0, -- Current level of line indentation
      indent_step = " " -- Indentation symbol, normally spaces or '\t'
   }
   return setmetatable (self, synth)
end
 
--------------------------------------------------------------------------------
-- Run a synthetizer on the `ast' arg and return the source as a string.
-- Can also be used as a static method `synth.run (ast)'; in this case,
-- a temporary synthetizer is instanciated on the fly.
--------------------------------------------------------------------------------
function synth:run (ast)
   if not ast then
      self, ast = synth.new(), self
   end
   self._acc = { }
   self:node (ast)
   return table.concat (self._acc)
end
 
--------------------------------------------------------------------------------
-- Accumulate a piece of source file in the synthetizer.
--------------------------------------------------------------------------------
function synth:acc (x)
   if x then table.insert (self._acc, x) end
end
 
--------------------------------------------------------------------------------
-- Accumulate an indented newline.
-- Jumps an extra line if indentation is 0, so that
-- toplevel definitions are separated by an extra empty line.
--------------------------------------------------------------------------------
function synth:nl ()
   if self.current_indent == 0 then self:acc "\n" end
   self:acc ("\n" .. self.indent_step:rep (self.current_indent))
end
 
--------------------------------------------------------------------------------
-- Increase indentation and accumulate a new line.
--------------------------------------------------------------------------------
function synth:nlindent ()
   self.current_indent = self.current_indent + 1
   self:nl ()
end
 
--------------------------------------------------------------------------------
-- Decrease indentation and accumulate a new line.
--------------------------------------------------------------------------------
function synth:nldedent ()
   self.current_indent = self.current_indent - 1
   self:acc ("\n" .. self.indent_step:rep (self.current_indent))
end
 
--------------------------------------------------------------------------------
-- Keywords, which are illegal as identifiers.
--------------------------------------------------------------------------------
local keywords = table.transpose {
   "and", "break", "do", "else", "elseif",
   "end", "false", "for", "function", "if",
   "in", "local", "nil", "not", "or",
   "repeat", "return", "then", "true", "until",
   "while" }
 
--------------------------------------------------------------------------------
-- Return true iff string `id' is a legal identifier name.
--------------------------------------------------------------------------------
local function is_ident (id)
   return id:strmatch "^[%a_][%w_]*$" and not keywords[id]
end
 
--------------------------------------------------------------------------------
-- Return true iff ast represents a legal function name for
-- syntax sugar ``function foo.bar.gnat() ... end'':
-- a series of nested string indexes, with an identifier as
-- the innermost node.
--------------------------------------------------------------------------------
local function is_idx_stack (ast)
   match ast with
   | `Id{ _ } -> return true
   | `Index{ left, `String{ _ } } -> return is_idx_stack (left)
   | _ -> return false
   end
end
 
--------------------------------------------------------------------------------
-- Operator precedences, in increasing order.
-- This is not directly used, it's used to generate op_prec below.
--------------------------------------------------------------------------------
local op_preprec = {
   { "or", "and" },
   { "lt", "le", "eq", "ne" },
   { "concat" },
   { "add", "sub" },
   { "mul", "div", "mod" },
   { "unary", "not", "len" },
   { "pow" },
   { "index" } }
 
--------------------------------------------------------------------------------
-- operator --> precedence table, generated from op_preprec.
--------------------------------------------------------------------------------
local op_prec = { }
 
for prec, ops in ipairs (op_preprec) do
   for op in ivalues (ops) do
      op_prec[op] = prec
   end
end
 
--------------------------------------------------------------------------------
-- operator --> source representation.
--------------------------------------------------------------------------------
local op_symbol = {
   add = " + ", sub = " - ", mul = " * ",
   div = " / ", mod = " % ", pow = " ^ ",
   concat = " .. ", eq = " == ", ne = " ~= ",
   lt = " < ", le = " <= ", ["and"] = " and ",
   ["or"] = " or ", ["not"] = "not ", len = "# " }
 
--------------------------------------------------------------------------------
-- Accumulate the source representation of AST `node' in
-- the synthetizer. Most of the work is done by delegating to
-- the method having the name of the AST tag.
-- If something can't be converted to normal sources, it's
-- instead dumped as a `-{ ... }' splice in the source accumulator.
--------------------------------------------------------------------------------
function synth:node (node)
   assert (self~=synth and self._acc)
   if not node.tag then -- tagless block.
      self:list (node, self.nl)
   else
      local f = synth[node.tag]
      if type (f) == "function" then -- Delegate to tag method.
         f (self, node, unpack (node))
      elseif type (f) == "string" then -- tag string.
         self:acc (f)
      else -- No appropriate method, fall back to splice dumping.
           -- This cannot happen in a plain Lua AST.
         self:acc " -{ "
         self:acc (table.tostring (node, "nohash"), 80)
         self:acc " }"
      end
   end
end
 
--------------------------------------------------------------------------------
-- Convert every node in the AST list `list' passed as 1st arg.
-- `sep' is an optional separator to be accumulated between each list element,
-- it can be a string or a synth method.
-- `start' is an optional number (default == 1), indicating which is the
-- first element of list to be converted, so that we can skip the begining
-- of a list.
--------------------------------------------------------------------------------
function synth:list (list, sep, start)
   for i = start or 1, # list do
      self:node (list[i])
      if list[i + 1] then
         if not sep then
         elseif type (sep) == "function" then sep (self)
         elseif type (sep) == "string" then self:acc (sep)
         else error "Invalid list separator" end
      end
   end
end
 
--------------------------------------------------------------------------------
--
-- Tag methods.
-- ------------
--
-- Specific AST node dumping methods, associated to their node kinds
-- by their name, which is the corresponding AST tag.
-- synth:node() is in charge of delegating a node's treatment to the
-- appropriate tag method.
--
-- Such tag methods are called with the AST node as 1st arg.
-- As a convenience, the n node's children are passed as args #2 ... n+1.
--
-- There are several things that could be refactored into common subroutines
-- here: statement blocks dumping, function dumping...
-- However, given their small size and linear execution
-- (they basically perform series of :acc(), :node(), :list(),
-- :nl(), :nlindent() and :nldedent() calls), it seems more readable
-- to avoid multiplication of such tiny functions.
--
-- To make sense out of these, you need to know metalua's AST syntax, as
-- found in the reference manual or in metalua/doc/ast.txt.
--
--------------------------------------------------------------------------------
 
function synth:Do (node)
   self:acc "do"
   self:nlindent ()
   self:list (node, self.nl)
   self:nldedent ()
   self:acc "end"
end
 
function synth:Set (node)
   match node with
   | `Set{ { `Index{ lhs, `String{ method } } },
           { `Function{ { `Id "self", ... } == params, body } } }
         if is_idx_stack (lhs) and is_ident (method) ->
      -- ``function foo:bar(...) ... end'' --
      self:acc "function "
      self:node (lhs)
      self:acc ":"
      self:acc (method)
      self:acc " ("
      self:list (params, ", ", 2)
      self:acc ")"
      self:nlindent ()
      self:list (body, self.nl)
      self:nldedent ()
      self:acc "end"
 
   | `Set{ { lhs }, { `Function{ params, body } } } if is_idx_stack (lhs) ->
      -- ``function foo(...) ... end'' --
      self:acc "function "
      self:node (lhs)
      self:acc " ("
      self:list (params, ", ")
      self:acc ")"
      self:nlindent ()
      self:list (body, self.nl)
      self:nldedent ()
      self:acc "end"
 
   | `Set{ { `Id{ lhs1name } == lhs1, ... } == lhs, rhs }
         if not is_ident (lhs1name) ->
      -- ``foo, ... = ...'' when foo is *not* a valid identifier.
      -- In that case, the spliced 1st variable must get parentheses,
      -- to be distinguished from a statement splice.
      -- This cannot happen in a plain Lua AST.
      self:acc "("
      self:node (lhs1)
      self:acc ")"
      if lhs[2] then -- more than one lhs variable
         self:acc ", "
         self:list (lhs, ", ", 2)
      end
      self:acc " = "
      self:list (rhs, ", ")
 
   | `Set{ lhs, rhs } ->
      -- ``... = ...'', no syntax sugar --
      self:list (lhs, ", ")
      self:acc " = "
      self:list (rhs, ", ")
   end
end
 
function synth:While (node, cond, body)
   self:acc "while "
   self:node (cond)
   self:acc " do"
   self:nlindent ()
   self:list (body, self.nl)
   self:nldedent ()
   self:acc "end"
end
 
function synth:Repeat (node, body, cond)
   self:acc "repeat"
   self:nlindent ()
   self:list (body, self.nl)
   self:nldedent ()
   self:acc "until "
   self:node (cond)
end
 
function synth:If (node)
   for i = 1, #node-1, 2 do
      -- for each ``if/then'' and ``elseif/then'' pair --
      local cond, body = node[i], node[i+1]
      self:acc (i==1 and "if " or "elseif ")
      self:node (cond)
      self:acc " then"
      self:nlindent ()
      self:list (body, self.nl)
      self:nldedent ()
   end
   -- odd number of children --> last one is an `else' clause --
   if #node%2 == 1 then
      self:acc "else"
      self:nlindent ()
      self:list (node[#node], self.nl)
      self:nldedent ()
   end
   self:acc "end"
end
 
function synth:Fornum (node, var, first, last)
   local body = node[#node]
   self:acc "for "
   self:node (var)
   self:acc " = "
   self:node (first)
   self:acc ", "
   self:node (last)
   if #node==5 then -- 5 children --> child #4 is a step increment.
      self:acc ", "
      self:node (node[4])
   end
   self:acc " do"
   self:nlindent ()
   self:list (body, self.nl)
   self:nldedent ()
   self:acc "end"
end
 
function synth:Forin (node, vars, generators, body)
   self:acc "for "
   self:list (vars, ", ")
   self:acc " in "
   self:list (generators, ", ")
   self:acc " do"
   self:nlindent ()
   self:list (body, self.nl)
   self:nldedent ()
   self:acc "end"
end
 
function synth:Local (node, lhs, rhs)
   self:acc "local "
   self:list (lhs, ", ")
   if rhs[1] then
      self:acc " = "
      self:list (rhs, ", ")
   end
end
 
function synth:Localrec (node, lhs, rhs)
   match node with
   | `Localrec{ { `Id{name} }, { `Function{ params, body } } }
         if is_ident (name) ->
      -- ``local function name() ... end'' --
      self:acc "local function "
      self:acc (name)
      self:acc " ("
      self:list (params, ", ")
      self:acc ")"
      self:nlindent ()
      self:list (body, self.nl)
      self:nldedent ()
      self:acc "end"
 
   | _ ->
      -- Other localrec are unprintable ==> splice them --
          -- This cannot happen in a plain Lua AST. --
      self:acc "-{ "
      self:acc (table.tostring (node, 'nohash', 80))
      self:acc " }"
   end
end
 
function synth:Call (node, f)
   -- single string or table literal arg ==> no need for parentheses. --
   local parens
   match node with
   | `Call{ _, `String{_} }
   | `Call{ _, `Table{...}} -> parens = false
   | _ -> parens = true
   end
   self:node (f)
   self:acc (parens and " (" or " ")
   self:list (node, ", ", 2) -- skip `f'.
   self:acc (parens and ")")
end
 
function synth:Invoke (node, f, method)
   -- single string or table literal arg ==> no need for parentheses. --
   local parens
   match node with
   | `Invoke{ _, _, `String{_} }
   | `Invoke{ _, _, `Table{...}} -> parens = false
   | _ -> parens = true
   end
   self:node (f)
   self:acc ":"
   self:acc (method[1])
   self:acc (parens and " (" or " ")
   self:list (node, ", ", 3) -- Skip args #1 and #2, object and method name.
   self:acc (parens and ")")
end
 
function synth:Return (node)
   self:acc "return "
   self:list (node, ", ")
end
 
synth.Break = "break"
synth.Nil = "nil"
synth.False = "false"
synth.True = "true"
synth.Dots = "..."
 
function synth:Number (node, n)
   self:acc (tostring (n))
end
 
function synth:String (node, str)
   -- format "%q" prints '\n' in an umpractical way IMO,
   -- so this is fixed with the :gsub( ) call.
   self:acc (string.format ("%q", str):gsub ("\\\n", "\\n"))
end
 
function synth:Function (node, params, body)
   self:acc "function "
   self:acc " ("
   self:list (params, ", ")
   self:acc ")"
   self:nlindent ()
   self:list (body, self.nl)
   self:nldedent ()
   self:acc "end"
end
 
function synth:Table (node)
   if not node[1] then self:acc "{ }" else
      self:acc "{"
      self:nlindent ()
      for i, elem in ipairs (node) do
         match elem with
         | `Pair{ `String{ key }, value } if is_ident (key) ->
            -- ``key = value''. --
            self:acc (key)
            self:acc " = "
            self:node (value)
 
         | `Pair{ key, value } ->
            -- ``[key] = value''. --
            self:acc "["
            self:node (key)
            self:acc "] = "
            self:node (value)
 
         | _ ->
            -- ``value''. --
            self:node (elem)
         end
         if node [i+1] then
            self:acc ","
            self:nl ()
         end
      end
      self:nldedent ()
      self:acc "}"
   end
end
 
function synth:Op (node, op, a, b)
   -- Transform ``not (a == b)'' into ``a ~= b''. --
   match node with
   | `Op{ "not", `Op{ "eq", _a, _b } }
   | `Op{ "not", `Paren{ `Op{ "eq", _a, _b } } } ->
      op, a, b = "ne", _a, _b
   | _ ->
   end
 
   if b then -- binary operator.
      local left_paren, right_paren
      match a with
      | `Op{ op_a, ...} if op_prec[op] >= op_prec[op_a] -> left_paren = true
      | _ -> left_paren = false
      end
 
      match b with -- FIXME: might not work with right assoc operators ^ and ..
      | `Op{ op_b, ...} if op_prec[op] >= op_prec[op_b] -> right_paren = true
      | _ -> right_paren = false
      end
 
      self:acc (left_paren and "(")
      self:node (a)
      self:acc (left_paren and ")")
 
      self:acc (op_symbol [op])
 
      self:acc (right_paren and "(")
      self:node (b)
      self:acc (right_paren and ")")
 
   else -- unary operator.
      local paren
      match a with
      | `Op{ op_a, ... } if op_prec[op] >= op_prec[op_a] -> paren = true
      | _ -> paren = false
      end
      self:acc (op_symbol[op])
      self:acc (paren and "(")
      self:node (a)
      self:acc (paren and ")")
   end
end
 
function synth:Paren (node, content)
   self:acc "("
   self:node (content)
   self:acc ")"
end
 
function synth:Index (node, table, key)
   local paren_table
   -- Check precedence, see if parens are needed around the table --
   match table with
   | `Op{ op, ... } if op_prec[op] < op_prec.index -> paren_table = true
   | _ -> paren_table = false
   end
 
   self:acc (paren_table and "(")
   self:node (table)
   self:acc (paren_table and ")")
 
   match key with
   | `String{ field } if is_ident (field) ->
      -- ``table.key''. --
      self:acc "."
      self:acc (field)
   | _ ->
      -- ``table [key]''. --
      self:acc "["
      self:node (key)
      self:acc "]"
   end
end
 
function synth:Id (node, name)
   if is_ident (name) then
      self:acc (name)
   else -- Unprintable identifier, fall back to splice representation.
        -- This cannot happen in a plain Lua AST.
      self:acc "-{`Id "
      self:String (node, name)
      self:acc "}"
   end
end
 
 
--------------------------------------------------------------------------------
-- Read a file, get its AST, use synth to regenerate sources
-- from that AST
--------------------------------------------------------------------------------
require 'metalua.compiler'
local filename = (arg[2] or arg[1]) or arg[0]
local ast = mlc.luafile_to_ast (filename)
 
print(synth.run(ast))