mrubyedge 2.1.2

mruby/edge is yet another mruby that is specialized for running on WASM
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
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
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
##
# Refinement test (MRB_USE_REFINEMENTS)

assert('Refinement') do
  skip "requires MRB_USE_REFINEMENTS" unless Object.const_defined?(:Refinement)
  assert_equal Module, Refinement.superclass
  assert_raise(NoMethodError) { Refinement.new }
end

if Object.const_defined?(:Refinement)

class RefTestC
  def foo; "C#foo"; end
  def bar; "C#bar"; end
  def with_super; "C"; end
  def ==(o); false; end
end

module RefTestM
  refine RefTestC do
    def foo; "M#foo"; end
    def baz; "M#baz"; end
    def with_super; "M+" + super; end
    def calls_baz; baz; end
  end
end

module RefTestM2
  refine RefTestC do
    def foo; "M2#foo"; end
    def with_super; "M2+" + super; end
  end
end

def ref_test_before_using
  RefTestC.new.foo
end

assert('Refinement: not visible before using') do
  assert_equal "C#foo", RefTestC.new.foo
  assert_raise(NoMethodError) { RefTestC.new.baz }
  assert_false RefTestC.new.respond_to?(:baz)
  assert_equal [], Module.used_modules
end

using RefTestM

assert('Refinement: visible after using') do
  c = RefTestC.new
  assert_equal "M#foo", c.foo
  assert_equal "M#baz", c.baz
  assert_equal "C#bar", c.bar
  assert_equal "M+C", c.with_super
  assert_equal "M#baz", c.calls_baz
  assert_equal [RefTestM], Module.used_modules
  assert_equal [RefTestM.refinements[0]], Module.used_refinements
end

assert('Refinement: method defined before using is unaffected') do
  assert_equal "C#foo", ref_test_before_using
end

def ref_test_after_using
  RefTestC.new.foo
end

assert('Refinement: method defined after using sees it') do
  assert_equal "M#foo", ref_test_after_using
end

assert('Refinement: blocks and lambdas in the scope') do
  assert_equal ["M#foo"], [RefTestC.new].map { |c| c.foo }
  l = -> { RefTestC.new.foo }
  assert_equal "M#foo", l.call
end

assert('Refinement: indirect calls honor the caller scope') do
  c = RefTestC.new
  assert_equal "M#foo", c.__send__(:foo)
  assert_equal "M#baz", c.__send__(:baz)
  if c.respond_to?(:send)   # mruby-metaprog
    assert_equal "M#baz", c.send(:baz)
    assert_equal "M#baz", c.public_send(:baz)
  end
  assert_true c.respond_to?(:baz)
  assert_equal "method", defined?(c.baz)
end

class RefTestProt; end

module RefTestProtM
  refine RefTestProt do
    protected def prot; "prot"; end
  end
end

class RefTestProt
  using RefTestProtM
  def call_prot(o); o.prot; end
  def defined_prot(o); defined?(o.prot); end
  def self.outside(o); [(o.prot rescue :err), defined?(o.prot)]; end
end

assert('Refinement: protected refined method is reached from the refined class') do
  a = RefTestProt.new
  assert_equal "prot", a.call_prot(RefTestProt.new)
  assert_equal "method", a.defined_prot(RefTestProt.new)
  assert_equal [:err, nil], RefTestProt.outside(a)
end

assert('Refinement: send does not reach a method the refinement undefined') do
  k = Class.new { def gone; "gone"; end }
  m = Module.new { refine(k) { undef_method :gone } }
  seen = nil
  k2 = Class.new { def gone; "gone"; end; define_method(:method_missing) { |n, *a| seen = n; "missing" } }
  m2 = Module.new { refine(k2) { undef_method :gone } }
  run = Class.new do
    using m
    using m2
    define_method(:go) { [(k.new.__send__(:gone) rescue :missing_raised), k2.new.__send__(:gone)] }
  end
  assert_equal [:missing_raised, "missing"], run.new.go
  assert_equal :gone, seen
  assert_equal "gone", k.new.__send__(:gone)
end

module RefTestLater
  def other; "other"; end
end
module RefTestLaterOps
  refine RefTestLater do
    def -(o); "later-"; end
    def [](i); "later[]"; end
  end
end
class RefTestLaterUse
  using RefTestLaterOps
  def self.run; [3 - 1, [7][0]]; end
end

assert('Refinement: a refined module prepended later to a guarded class') do
  # the module's refinement comes before the class's own operator only once
  # the module stands before the class, which is what prepend does; the
  # guarded fast paths must notice the change of ancestry
  assert_equal [2, 7], RefTestLaterUse.run
  Integer.prepend(RefTestLater)
  Array.prepend(RefTestLater)
  assert_equal ["later-", "later[]"], RefTestLaterUse.run
  assert_equal [2, 7], [3 - 1, [7][0]]
end

module RefTestModG; def a; "G" + super; end; end
module RefTestModF; include RefTestModG; def a; "F" + super; end; end
class RefTestModA; def a; "A"; end; end
class RefTestModB < RefTestModA; include RefTestModF; end
module RefTestModR
  refine RefTestModF do
    def a; "R" + super; end
    def own; "own"; end
  end
end

assert('Refinement: super into a refined module method cannot go on (Bug #22071)') do
  assert_equal "FGA", RefTestModB.new.a
  c = Class.new do
    using RefTestModR
    define_method(:go) { RefTestModB.new.a }
    define_method(:own) { RefTestModB.new.own }
  end
  assert_equal "own", c.new.own
  e = assert_raise(NoMethodError) { c.new.go }
  assert_true e.message.include?("called via super from a refinement method")
end

class RefTestSupC; def foo; "C"; end; end
module RefTestSupM1; refine(RefTestSupC) { def foo; "M1+" + super; end }; end
module RefTestSupM2
  refine(RefTestSupC) { using RefTestSupM1; def foo; "M2+" + super; end }
end
module RefTestSupM3; refine(RefTestSupC) { def foo; "M3+" + super; end }; end

assert('Refinement: super goes to the next refinement active where super is written') do
  a = Class.new { using RefTestSupM2; define_method(:go) { RefTestSupC.new.foo } }
  assert_equal "M2+M1+C", a.new.go
  # refinements active at the caller do not affect a super inside the method
  b = Class.new { using RefTestSupM2; using RefTestSupM3; define_method(:go) { RefTestSupC.new.foo } }
  assert_equal "M3+C", b.new.go
end

assert('Refinement: method_missing is not refined') do
  c = RefTestC.new
  assert_raise(NoMethodError) { c.no_such_method }
end

assert('Refinement: later using wins, super passes over the current refinement') do
  using RefTestM2
  c = RefTestC.new
  assert_equal "M2#foo", c.foo
  assert_equal "M#baz", c.baz
  assert_equal "M2+C", c.with_super
  assert_equal [RefTestM2, RefTestM], Module.used_modules
end

assert('Refinement: scope of using inside a block does not leak out') do
  # the `using` above was written in a block at top level, so it installed
  # into the file scope (documented divergence from CRuby)
  assert_equal "M2#foo", RefTestC.new.foo
end

class RefTestD < RefTestC
  def foo; "D+" + super; end
end

assert('Refinement: super from a subclass method sees the refinement') do
  assert_equal "D+M2#foo", RefTestD.new.foo
end

module RefTestPre
  def foo; "Pre+" + super; end
end

class RefTestP
  prepend RefTestPre
  def foo; "P#foo"; end
end

module RefTestPM
  refine RefTestP do
    def foo; "R+" + super; end
  end
end

assert('Refinement: refinements come before prepended modules') do
  assert_equal "Pre+P#foo", RefTestP.new.foo
  using RefTestPM
  assert_equal "R+Pre+P#foo", RefTestP.new.foo
end

module RefTestEnum
  refine Enumerable do
    def ref_sum; inject(0) { |a, b| a + b }; end
  end
end

assert('Refinement: refine a module') do
  assert_raise(NoMethodError) { [1, 2, 3].ref_sum }
  using RefTestEnum
  assert_equal 6, [1, 2, 3].ref_sum
  assert_equal 3, (1..2).ref_sum
end

module RefTestOps
  refine Integer do
    def +(o); "int+"; end
    def <(o); "int<"; end
  end
  refine String do
    def [](i); "str[]"; end
  end
  refine Array do
    def []=(i, v); "ary[]="; end
  end
  refine RefTestC do
    def ==(o); "eq"; end
  end
end

def ref_test_ops_unrefined
  a = [1]
  a[0] = 5
  [1 + 2, 1 < 2, "abc"[0], [1][0], a[0], RefTestC.new == 1]
end

class RefTestOpsScope
  using RefTestOps
  def self.run
    c = RefTestC.new
    a = [1]
    [1 + 2, 1 < 2, "abc"[0], (a[0] = 5), a.orig_aref(0), RefTestC.new == 1, c == c, 2.0 + 3.0]
  end
end

class Array
  alias orig_aref []
end

assert('Refinement: guarded operators') do
  assert_equal ["int+", "int<", "str[]", 5, 1, "eq", "eq", 5.0], RefTestOpsScope.run
  assert_equal [3, true, "a", 1, 5, false], ref_test_ops_unrefined
  assert_equal 3, 1 + 2
  assert_equal "a", "abc"[0]
end

assert('Refinement: class body scope ends with the class') do
  klass = Class.new
  m = Module.new do
    refine(klass) { def hi; "hi"; end }
  end
  c = Class.new do
    using m
    define_method(:x) { klass.new.hi }
  end
  assert_equal "hi", c.new.x
  assert_raise(NoMethodError) { klass.new.hi }
end

assert('Refinement: using in a block given a class is scoped to the block') do
  klass = Class.new
  m = Module.new do
    refine(klass) { def hi; "hi"; end }
  end
  holder = Module.new
  r = holder.module_eval do
    using m
    [klass.new.hi, [klass.new].map { |o| o.hi }, Module.used_modules]
  end
  assert_equal ["hi", ["hi"], [m]], r
  assert_raise(NoMethodError) { klass.new.hi }
  assert_false Module.used_modules.include?(m)
end

assert('Refinement: a frozen block keeps its refinements') do
  klass = Class.new
  m = Module.new do
    refine(klass) { def hi; "hi"; end }
  end
  c = Class.new do
    using m
    define_method(:blk) { -> { klass.new.hi } }
  end
  pr = c.new.blk
  assert_equal "hi", pr.call
  pr.freeze
  assert_equal "hi", pr.call
end

assert('Refinement: using errors') do
  assert_raise(TypeError) { using RefTestC }
  assert_raise(TypeError) { using RefTestM.refinements[0] }
  assert_raise(TypeError) { using 1 }
  assert_raise(RuntimeError) { def ref_test_using_in_method; using RefTestM; end; ref_test_using_in_method }
  m = Module.new { def self.m; using RefTestM; end }
  assert_raise(RuntimeError) { m.m }
  m2 = Class.new { define_method(:m) { self.class.__send__(:using, RefTestM) } }
  assert_raise(RuntimeError) { m2.new.m }
  o = Object.new
  assert_raise(RuntimeError) { RefTestM.__send__(:using, RefTestM2) }
  assert_raise(RuntimeError) { o.instance_eval { RefTestM.__send__(:using, RefTestM2) } }
end

assert('Refinement: refine errors') do
  assert_raise(ArgumentError) { Module.new { refine(RefTestC) } }
  assert_raise(TypeError) { Module.new { refine(1) { } } }
  assert_raise(TypeError) { Module.new { refine(RefTestM.refinements[0]) { } } }
  assert_raise(NoMethodError) { RefTestM.refinements[0].instance_eval { refine(RefTestC) { } } }
end

assert('Refinement: cannot be included, prepended or extended') do
  r = RefTestM.refinements[0]
  assert_raise(TypeError) { Module.new { include r } }
  assert_raise(TypeError) { Class.new { prepend r } }
  assert_raise(TypeError) { Object.new.extend(r) }
  assert_raise(TypeError) { r.instance_eval { include Comparable } }
  assert_raise(TypeError) { r.instance_eval { prepend Comparable } }
end

assert('Refinement: introspection') do
  r = RefTestM.refinements[0]
  assert_kind_of Refinement, r
  assert_true r.is_a?(Module)
  assert_equal RefTestC, r.target
  assert_equal RefTestC, r.refined_class
  assert_equal 1, RefTestM.refinements.size
  assert_equal "#<refinement:RefTestC@RefTestM>", r.to_s
  assert_equal "#<refinement:RefTestC@RefTestM>", r.inspect
  assert_equal [r, RefTestC, Object], r.ancestors.first(3)
  assert_equal BasicObject, r.ancestors.last
  assert_false RefTestC.new.is_a?(r)
  assert_equal [], Class.new.refinements
end

class RefTestA; end
class RefTestB; end

assert('Refinement: refine block sees a later refinement of the same owner') do
  m = Module.new do
    refine(RefTestA) { def go; RefTestB.new.hello; end }
    refine(RefTestB) { def hello; "hello"; end }
  end
  using m
  assert_equal "hello", RefTestA.new.go
end

assert('Refinement: refine is reopened, alias finds the refined class') do
  k = Class.new { def orig; "orig"; end }
  m = Module.new do
    refine(k) { def one; "one"; end }
    refine(k) { def two; "two"; end; alias_method :orig2, :orig }
  end
  assert_equal 1, m.refinements.size
  using m
  assert_equal "onetwo", k.new.one + k.new.two
  assert_equal "orig", k.new.orig2
end

assert('Refinement#import_methods') do
  k = Class.new
  helper = Module.new { def imported; "imported"; end; def uses_sibling; sibling; end }
  m = Module.new do
    refine(k) { def sibling; "sibling"; end; import_methods helper }
  end
  assert_raise(ArgumentError) { Module.new { refine(k) { import_methods Kernel } } }
  assert_raise(TypeError) { Module.new { refine(k) { import_methods k } } }
  using m
  assert_equal "imported", k.new.imported
  assert_equal "sibling", k.new.uses_sibling
end

assert('Refinement: using a module that includes a refining module') do
  k = Class.new
  inner = Module.new { refine(k) { def inner; "inner"; end } }
  outer = Module.new { include inner }
  using outer
  assert_equal "inner", k.new.inner
end

assert('Refinement: undef within a refinement hides the method') do
  k = Class.new { def gone; "gone"; end }
  m = Module.new { refine(k) { undef_method :gone } }
  assert_equal "gone", k.new.gone
  using m
  assert_raise(NoMethodError) { k.new.gone }
end

module RefTestProcRef
  refine String do
    def shout; upcase + "!"; end
  end
  refine Integer do
    def tripled; self * 3; end
  end
end

module RefTestProcRefStr
  refine(String) { def shout; upcase + "!"; end }
end

module RefTestProcRefInt
  refine(Integer) { def doubled; self * 2; end }
end

module RefTestProcRefWhisper
  refine(String) { def whisper; downcase + "..."; end }
end

assert('Proc#refined') do
  orig = ->(s) { s.shout }
  refined = orig.refined(RefTestProcRef)
  assert_equal "HI!", refined.call("hi")
  assert_raise(NoMethodError) { orig.call("hi") }
  assert_equal "HI!", refined.call("hi")
  assert_false orig.equal?(refined)
  # no modules: the proc itself
  assert_same orig, orig.refined
end

assert('Proc#refined: nested blocks, several modules, shared environment') do
  refined = ->(a) { a.map { |s| s.shout } }.refined(RefTestProcRef)
  assert_equal ["A!", "B!"], refined.call(["a", "b"])

  refined = ->(s, n) { "#{s.shout}#{n.tripled}" }.refined(RefTestProcRef)
  assert_equal "A!6", refined.call("a", 2)

  counter = 0
  inc = -> { counter += 1 }
  inc.refined(RefTestProcRef).call
  inc.call
  assert_equal 2, counter
end

assert('Proc#refined: called through yield, each, send and Fiber') do
  refined = ->(s) { s.shout }.refined(RefTestProcRef)
  out = []
  [1, 2].each { |i| out << refined.call("x#{i}") }
  assert_equal ["X1!", "X2!"], out
  forwarded = []
  rr = ->(s) { forwarded << s.shout }.refined(RefTestProcRef)
  %w[p q].each(&rr)
  assert_equal ["P!", "Q!"], forwarded
  assert_equal "A!", refined.__send__(:call, "a")
  assert_equal "C!", Fiber.new(&refined).resume("c") if Object.const_defined?(:Fiber)
end

assert('Proc#refined: instance_eval and class_eval with the proc') do
  refined = Proc.new { self.shout }.refined(RefTestProcRef)
  assert_equal "HI!", "hi".instance_eval(&refined)
  assert_raise(NoMethodError) { "hi".instance_eval(&Proc.new { self.shout }) }
  refined = Proc.new { "ok".shout }.refined(RefTestProcRef)
  assert_equal "OK!", Class.new.class_eval(&refined)
  again = Proc.new { "ok".shout }.refined(RefTestProcRef)
  assert_equal "OK!", Class.new.class_eval(&again)
end

assert('Proc#refined: kept by dup and clone, and by a def in the body') do
  refined = ->(s) { s.shout }.refined(RefTestProcRef)
  assert_equal "Z!", refined.dup.call("z") if refined.respond_to?(:dup)
  assert_equal "Z!", refined.clone.call("z") if refined.respond_to?(:clone)
  r = -> { obj = Object.new; def obj.shout_hi; "hi".shout; end; obj.shout_hi }.refined(RefTestProcRef)
  assert_equal "HI!", r.call
end

assert('Proc#refined: rejected by define_method') do
  refined = ->(s) { s.shout }.refined(RefTestProcRef)
  assert_raise(ArgumentError) { Class.new { define_method(:m, refined) } }
  assert_raise(ArgumentError) { Class.new { define_method(:m, &refined) } }
  assert_raise(ArgumentError) { define_method(:ref_test_top_m, refined) }
  # a proc made inside a refined proc is not itself refined
  assert_nothing_raised { -> { Class.new { define_method(:m, ->(s) { s }) } }.refined(RefTestProcRef).call }
end

assert('Proc#refined: errors') do
  assert_raise(TypeError) { ->(s) { s }.refined(42) }
  assert_raise(TypeError) { ->(s) { s }.refined(String) }
  assert_raise(TypeError) { ->(s) { s }.refined(RefTestProcRef.refinements[0]) }
end

assert('Proc#refined: using is refused inside the proc') do
  r = Proc.new { using RefTestProcRefWhisper }.refined(RefTestProcRef)
  e = assert_raise(RuntimeError) { r.call }
  assert_true e.message.include?("not permitted in a proc with refinements")
  e = Proc.new { using RefTestProcRefWhisper }.refined(RefTestProcRef)
  assert_raise(RuntimeError) { Module.new.module_eval(&e) }
  c = Proc.new { class ::RefTestProcRefUsingTmp; using RefTestProcRefWhisper; end }.refined(RefTestProcRef)
  assert_raise(RuntimeError) { c.call }
  n = Proc.new { -> { using RefTestProcRefWhisper }.call }.refined(RefTestProcRef)
  assert_raise(RuntimeError) { n.call }
  # a block made in the proc and given a class to run under
  g = Proc.new { blk = Proc.new { using RefTestProcRefWhisper }; Module.new.module_eval(&blk) }.refined(RefTestProcRef)
  assert_raise(RuntimeError) { g.call }
  g2 = Proc.new { blk = Proc.new { Class.new { using RefTestProcRefWhisper } }; blk.call }.refined(RefTestProcRef)
  assert_raise(RuntimeError) { g2.call }
  # a plain proc is unaffected, and the refined proc still works
  assert_equal "ok...", Module.new.module_eval(&Proc.new { using RefTestProcRefWhisper; "ok".whisper })
  assert_equal "OK!", Proc.new { "ok".shout }.refined(RefTestProcRef).call
end

assert('Proc#refined: chained and nested, later modules first') do
  result = -> {
    inner = ->(s, n) { [s.shout, n.doubled] }
    inner.refined(RefTestProcRefStr).call("hi", 3)
  }.refined(RefTestProcRefInt).call
  assert_equal ["HI!", 6], result

  loud = Module.new { refine(String) { def shout; "LOUD"; end } }
  assert_equal "LOUD", ->(s) { s.shout }.refined(RefTestProcRef, loud).call("x")
  assert_equal "LOUD", ->(s) { s.shout }.refined(RefTestProcRef).refined(loud).call("x")
  assert_equal "X!", ->(s) { s.shout }.refined(loud).refined(RefTestProcRef).call("x")
  assert_equal [RefTestProcRef, loud], -> { Module.used_modules }.refined(loud, RefTestProcRef).call.first(2)
end

assert('Refinement: survives GC and scope slots are reused') do
  k = Class.new { def base; "base"; end }
  m = Module.new { refine(k) { def base; "refined"; end } }
  using m
  GC.start
  assert_equal "refined", k.new.base
  100.times do
    mm = Module.new { refine(k) { def tmp; 1; end } }
    Class.new { using mm }
  end
  GC.start
  assert_equal "refined", k.new.base
  # dead scopes are reclaimed even while the collector is turned off
  GC.disable
  begin
    2100.times { Module.new { refine(k) { } } }
  ensure
    GC.enable
  end
  assert_equal "refined", k.new.base
end

assert('string interpolation with refinement') do
  Module.new do
    c = Class.new
    o = c.new
    using Module.new {
      refine c do
        def to_s
          "with refinement!"
        end
      end
    }
    assert_equal "string with refinement!" do
      "string #{o}"
    end
  end
end

end # defined? Refinement