dfect 0.0.0 → 0.1.0
Sign up to get free protection for your applications and to get access to all the features.
- data/CREDITS +1 -0
- data/doc/api/{files/ANN_txt.html → classes/Class.html} +21 -28
- data/doc/api/classes/Dfect.html +446 -139
- data/doc/api/created.rid +1 -1
- data/doc/api/files/CREDITS.html +62 -0
- data/doc/api/files/LICENSE.html +4 -2
- data/doc/api/files/lib/dfect/auto_rb.html +4 -2
- data/doc/api/files/lib/dfect_rb.html +3 -1
- data/doc/api/js/searchdoc.js +1 -2
- data/doc/api/panel/search_index.js +1 -1
- data/doc/history.erb +31 -2
- data/doc/index.xhtml +773 -0
- data/doc/intro.erb +28 -15
- data/doc/setup.erb +4 -4
- data/doc/usage.erb +105 -46
- data/lib/dfect.rb +385 -87
- data/rakefile +4 -2
- data/test/dfect.rb +168 -15
- metadata +21 -19
data/doc/api/classes/Dfect.html
CHANGED
|
@@ -58,7 +58,11 @@
|
|
|
58
58
|
<dd>
|
|
59
59
|
<ul>
|
|
60
60
|
|
|
61
|
-
<li><a href="#
|
|
61
|
+
<li><a href="#M000012">C</a>,</li>
|
|
62
|
+
|
|
63
|
+
<li><a href="#M000013">C!</a>,</li>
|
|
64
|
+
|
|
65
|
+
<li><a href="#M000014">C?</a></li>
|
|
62
66
|
|
|
63
67
|
</ul>
|
|
64
68
|
</dd>
|
|
@@ -76,7 +80,11 @@
|
|
|
76
80
|
<dd>
|
|
77
81
|
<ul>
|
|
78
82
|
|
|
79
|
-
<li><a href="#
|
|
83
|
+
<li><a href="#M000009">E</a>,</li>
|
|
84
|
+
|
|
85
|
+
<li><a href="#M000010">E!</a>,</li>
|
|
86
|
+
|
|
87
|
+
<li><a href="#M000011">E?</a></li>
|
|
80
88
|
|
|
81
89
|
</ul>
|
|
82
90
|
</dd>
|
|
@@ -85,7 +93,7 @@
|
|
|
85
93
|
<dd>
|
|
86
94
|
<ul>
|
|
87
95
|
|
|
88
|
-
<li><a href="#
|
|
96
|
+
<li><a href="#M000008">F?</a></li>
|
|
89
97
|
|
|
90
98
|
</ul>
|
|
91
99
|
</dd>
|
|
@@ -94,7 +102,11 @@
|
|
|
94
102
|
<dd>
|
|
95
103
|
<ul>
|
|
96
104
|
|
|
97
|
-
<li><a href="#M000005">T</a
|
|
105
|
+
<li><a href="#M000005">T</a>,</li>
|
|
106
|
+
|
|
107
|
+
<li><a href="#M000006">T!</a>,</li>
|
|
108
|
+
|
|
109
|
+
<li><a href="#M000007">T?</a></li>
|
|
98
110
|
|
|
99
111
|
</ul>
|
|
100
112
|
</dd>
|
|
@@ -103,7 +115,7 @@
|
|
|
103
115
|
<dd>
|
|
104
116
|
<ul>
|
|
105
117
|
|
|
106
|
-
<li><a href="#
|
|
118
|
+
<li><a href="#M000015">run</a></li>
|
|
107
119
|
|
|
108
120
|
</ul>
|
|
109
121
|
</dd>
|
|
@@ -112,7 +124,7 @@
|
|
|
112
124
|
<dd>
|
|
113
125
|
<ul>
|
|
114
126
|
|
|
115
|
-
<li><a href="#
|
|
127
|
+
<li><a href="#M000016">stop</a></li>
|
|
116
128
|
|
|
117
129
|
</ul>
|
|
118
130
|
</dd>
|
|
@@ -165,7 +177,7 @@ when this module is mixed-in:
|
|
|
165
177
|
</td>
|
|
166
178
|
<td class='attr-name'>report</td>
|
|
167
179
|
<td class='attr-desc'><p>
|
|
168
|
-
Hash of test results, assembled by <a href="Dfect.html#
|
|
180
|
+
Hash of test results, assembled by <a href="Dfect.html#M000015">run</a>.
|
|
169
181
|
</p>
|
|
170
182
|
<dl>
|
|
171
183
|
<dt>:execution</dt><dd>Hierarchical trace of all tests executed, where each test is represented by
|
|
@@ -241,12 +253,12 @@ The default value is false.
|
|
|
241
253
|
<div class="method">
|
|
242
254
|
<div class="title" id="M000001">
|
|
243
255
|
|
|
244
|
-
<a name="M000001"></a><b
|
|
256
|
+
<a name="M000001"></a><b> <(&block)
|
|
257
|
+
</b>
|
|
245
258
|
|
|
246
259
|
</div>
|
|
247
260
|
|
|
248
261
|
<div class="description">
|
|
249
|
-
|
|
250
262
|
<p>
|
|
251
263
|
Registers the given block to be executed before each nested test inside
|
|
252
264
|
this test.
|
|
@@ -269,14 +281,19 @@ this test.
|
|
|
269
281
|
<p class="source-link">
|
|
270
282
|
Source: <a href="javascript:toggleSource('M000001_source')" id="l_M000001_source">show</a>
|
|
271
283
|
|
|
272
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
284
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L138" target="_blank" class="github_url">on GitHub</a>
|
|
273
285
|
|
|
274
286
|
</p>
|
|
275
287
|
<div id="M000001_source" class="dyn-source">
|
|
276
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
277
|
-
<span class="ruby-keyword kw">def</span> <span class="ruby-operator"><</span> <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
278
|
-
<span class="ruby-
|
|
279
|
-
|
|
288
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 138</span>
|
|
289
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-operator"><</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>)
|
|
290
|
+
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span>
|
|
291
|
+
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'block must be given'</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block</span>
|
|
292
|
+
<span class="ruby-ivar">@curr_suite</span>.<span class="ruby-identifier">before_each</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">block</span>
|
|
293
|
+
<span class="ruby-keyword kw">else</span>
|
|
294
|
+
<span class="ruby-comment cmt"># the < method is being used as a check for inheritance</span>
|
|
295
|
+
<span class="ruby-keyword kw">super</span>
|
|
296
|
+
<span class="ruby-keyword kw">end</span>
|
|
280
297
|
<span class="ruby-keyword kw">end</span></pre>
|
|
281
298
|
</div>
|
|
282
299
|
</div>
|
|
@@ -291,7 +308,6 @@ this test.
|
|
|
291
308
|
</div>
|
|
292
309
|
|
|
293
310
|
<div class="description">
|
|
294
|
-
|
|
295
311
|
<p>
|
|
296
312
|
Registers the given block to be executed before all nested tests inside
|
|
297
313
|
this test.
|
|
@@ -314,11 +330,11 @@ this test.
|
|
|
314
330
|
<p class="source-link">
|
|
315
331
|
Source: <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show</a>
|
|
316
332
|
|
|
317
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
333
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L177" target="_blank" class="github_url">on GitHub</a>
|
|
318
334
|
|
|
319
335
|
</p>
|
|
320
336
|
<div id="M000003_source" class="dyn-source">
|
|
321
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
337
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 177</span>
|
|
322
338
|
<span class="ruby-keyword kw">def</span> <span class="ruby-operator"><<</span> <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
323
339
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'block must be given'</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block</span>
|
|
324
340
|
<span class="ruby-ivar">@curr_suite</span>.<span class="ruby-identifier">before_all</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">block</span>
|
|
@@ -336,7 +352,6 @@ this test.
|
|
|
336
352
|
</div>
|
|
337
353
|
|
|
338
354
|
<div class="description">
|
|
339
|
-
|
|
340
355
|
<p>
|
|
341
356
|
Registers the given block to be executed after each nested test inside this
|
|
342
357
|
test.
|
|
@@ -359,11 +374,11 @@ test.
|
|
|
359
374
|
<p class="source-link">
|
|
360
375
|
Source: <a href="javascript:toggleSource('M000002_source')" id="l_M000002_source">show</a>
|
|
361
376
|
|
|
362
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
377
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L160" target="_blank" class="github_url">on GitHub</a>
|
|
363
378
|
|
|
364
379
|
</p>
|
|
365
380
|
<div id="M000002_source" class="dyn-source">
|
|
366
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
381
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 160</span>
|
|
367
382
|
<span class="ruby-keyword kw">def</span> <span class="ruby-operator">></span> <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
368
383
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'block must be given'</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block</span>
|
|
369
384
|
<span class="ruby-ivar">@curr_suite</span>.<span class="ruby-identifier">after_each</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">block</span>
|
|
@@ -381,7 +396,6 @@ test.
|
|
|
381
396
|
</div>
|
|
382
397
|
|
|
383
398
|
<div class="description">
|
|
384
|
-
|
|
385
399
|
<p>
|
|
386
400
|
Registers the given block to be executed after all nested tests inside this
|
|
387
401
|
test.
|
|
@@ -404,11 +418,11 @@ test.
|
|
|
404
418
|
<p class="source-link">
|
|
405
419
|
Source: <a href="javascript:toggleSource('M000004_source')" id="l_M000004_source">show</a>
|
|
406
420
|
|
|
407
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
421
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L194" target="_blank" class="github_url">on GitHub</a>
|
|
408
422
|
|
|
409
423
|
</p>
|
|
410
424
|
<div id="M000004_source" class="dyn-source">
|
|
411
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
425
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 194</span>
|
|
412
426
|
<span class="ruby-keyword kw">def</span> <span class="ruby-operator">>></span> <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
413
427
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'block must be given'</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block</span>
|
|
414
428
|
<span class="ruby-ivar">@curr_suite</span>.<span class="ruby-identifier">after_all</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">block</span>
|
|
@@ -419,17 +433,22 @@ test.
|
|
|
419
433
|
</div>
|
|
420
434
|
|
|
421
435
|
<div class="method">
|
|
422
|
-
<div class="title" id="
|
|
436
|
+
<div class="title" id="M000012">
|
|
423
437
|
|
|
424
|
-
<a name="
|
|
438
|
+
<a name="M000012"></a><b>C</b>(message = nil, symbol = nil, &block)
|
|
425
439
|
|
|
426
440
|
</div>
|
|
427
441
|
|
|
428
442
|
<div class="description">
|
|
429
|
-
|
|
430
443
|
<p>
|
|
431
|
-
Asserts that the given symbol is thrown when the given block is executed
|
|
432
|
-
|
|
444
|
+
Asserts that the given symbol is thrown when the given block is executed.
|
|
445
|
+
</p>
|
|
446
|
+
<p>
|
|
447
|
+
If a value is thrown along with the expected symbol, then that value is
|
|
448
|
+
returned.
|
|
449
|
+
</p>
|
|
450
|
+
<p>
|
|
451
|
+
Otherwise, nil is returned.
|
|
433
452
|
</p>
|
|
434
453
|
<h4>Parameters</h4>
|
|
435
454
|
<dl>
|
|
@@ -444,14 +463,13 @@ and returns the value that was thrown along with the symbol.
|
|
|
444
463
|
<pre>
|
|
445
464
|
# no message specified:
|
|
446
465
|
|
|
447
|
-
C(:foo) { throw :foo } # passes
|
|
448
|
-
|
|
449
|
-
C(:foo) {
|
|
450
|
-
C(:foo) { } # fails
|
|
466
|
+
C(:foo) { throw :foo, 123 } # passes, => 123
|
|
467
|
+
C(:foo) { throw :bar, 456 } # fails, => 456
|
|
468
|
+
C(:foo) { } # fails, => nil
|
|
451
469
|
|
|
452
470
|
# message specified:
|
|
453
471
|
|
|
454
|
-
C( ":foo must be thrown", :foo ) { throw :bar } # fails
|
|
472
|
+
C( ":foo must be thrown", :foo ) { throw :bar, 789 } # fails, => nil
|
|
455
473
|
</pre>
|
|
456
474
|
|
|
457
475
|
</div>
|
|
@@ -461,37 +479,130 @@ and returns the value that was thrown along with the symbol.
|
|
|
461
479
|
|
|
462
480
|
<div class="sourcecode">
|
|
463
481
|
<p class="source-link">
|
|
464
|
-
Source: <a href="javascript:toggleSource('
|
|
482
|
+
Source: <a href="javascript:toggleSource('M000012_source')" id="l_M000012_source">show</a>
|
|
465
483
|
|
|
466
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
484
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L456" target="_blank" class="github_url">on GitHub</a>
|
|
467
485
|
|
|
468
486
|
</p>
|
|
469
|
-
<div id="
|
|
470
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
487
|
+
<div id="M000012_source" class="dyn-source">
|
|
488
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 456</span>
|
|
471
489
|
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">C</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">symbol</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
472
|
-
<span class="ruby-identifier">
|
|
490
|
+
<span class="ruby-identifier">assert_catch</span> <span class="ruby-identifier">:assert</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">symbol</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
491
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
492
|
+
</div>
|
|
493
|
+
</div>
|
|
494
|
+
|
|
495
|
+
</div>
|
|
496
|
+
|
|
497
|
+
<div class="method">
|
|
498
|
+
<div class="title" id="M000013">
|
|
499
|
+
|
|
500
|
+
<a name="M000013"></a><b>C!</b>(message = nil, symbol = nil, &block)
|
|
501
|
+
|
|
502
|
+
</div>
|
|
503
|
+
|
|
504
|
+
<div class="description">
|
|
505
|
+
<p>
|
|
506
|
+
Asserts that the given symbol is not thrown when the given block is
|
|
507
|
+
executed.
|
|
508
|
+
</p>
|
|
509
|
+
<p>
|
|
510
|
+
Returns nil, always.
|
|
511
|
+
</p>
|
|
512
|
+
<h4>Parameters</h4>
|
|
513
|
+
<dl>
|
|
514
|
+
<dt>message</dt><dd>Optional message to show in the report if this assertion fails.
|
|
473
515
|
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
<span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>
|
|
477
|
-
<span class="ruby-keyword kw">end</span>
|
|
516
|
+
</dd>
|
|
517
|
+
<dt>symbol</dt><dd>Symbol that must not be thrown by the given block.
|
|
478
518
|
|
|
479
|
-
|
|
519
|
+
</dd>
|
|
520
|
+
</dl>
|
|
521
|
+
<h4>Examples</h4>
|
|
522
|
+
<pre>
|
|
523
|
+
# no message specified:
|
|
524
|
+
|
|
525
|
+
C!(:foo) { throw :foo, 123 } # fails, => nil
|
|
526
|
+
C!(:foo) { throw :bar, 456 } # passes, => nil
|
|
527
|
+
C!(:foo) { } # passes, => nil
|
|
480
528
|
|
|
481
|
-
|
|
482
|
-
<span class="ruby-identifier">message</span> <span class="ruby-operator">||=</span> <span class="ruby-node">"block must throw #{symbol.inspect}"</span>
|
|
529
|
+
# message specified:
|
|
483
530
|
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
<span class="ruby-identifier">result</span> = <span class="ruby-identifier">catch</span>(<span class="ruby-identifier">symbol</span>) { <span class="ruby-identifier">call</span> <span class="ruby-identifier">block</span>; <span class="ruby-keyword kw">self</span> }
|
|
531
|
+
C!( ":foo must be thrown", :foo ) { throw :bar, 789 } # passes, => nil
|
|
532
|
+
</pre>
|
|
487
533
|
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
534
|
+
</div>
|
|
535
|
+
|
|
536
|
+
|
|
537
|
+
|
|
538
|
+
|
|
539
|
+
<div class="sourcecode">
|
|
540
|
+
<p class="source-link">
|
|
541
|
+
Source: <a href="javascript:toggleSource('M000013_source')" id="l_M000013_source">show</a>
|
|
542
|
+
|
|
543
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L487" target="_blank" class="github_url">on GitHub</a>
|
|
544
|
+
|
|
545
|
+
</p>
|
|
546
|
+
<div id="M000013_source" class="dyn-source">
|
|
547
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 487</span>
|
|
548
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">C!</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">symbol</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
549
|
+
<span class="ruby-identifier">assert_catch</span> <span class="ruby-identifier">:negate</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">symbol</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
550
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
551
|
+
</div>
|
|
552
|
+
</div>
|
|
553
|
+
|
|
554
|
+
</div>
|
|
555
|
+
|
|
556
|
+
<div class="method">
|
|
557
|
+
<div class="title" id="M000014">
|
|
558
|
+
|
|
559
|
+
<a name="M000014"></a><b>C?</b>(message = nil, symbol = nil, &block)
|
|
560
|
+
|
|
561
|
+
</div>
|
|
562
|
+
|
|
563
|
+
<div class="description">
|
|
564
|
+
<p>
|
|
565
|
+
Returns true if the given symbol is thrown when the given block is
|
|
566
|
+
executed. Otherwise, returns false.
|
|
567
|
+
</p>
|
|
568
|
+
<h4>Parameters</h4>
|
|
569
|
+
<dl>
|
|
570
|
+
<dt>message</dt><dd>This parameter is optional and completely ignored.
|
|
571
|
+
|
|
572
|
+
</dd>
|
|
573
|
+
<dt>symbol</dt><dd>Symbol that must be thrown by the given block.
|
|
574
|
+
|
|
575
|
+
</dd>
|
|
576
|
+
</dl>
|
|
577
|
+
<h4>Examples</h4>
|
|
578
|
+
<pre>
|
|
579
|
+
# no message specified:
|
|
580
|
+
|
|
581
|
+
C?(:foo) { throw :foo, 123 } # => true
|
|
582
|
+
C?(:foo) { throw :bar, 456 } # => false
|
|
583
|
+
C?(:foo) { } # => false
|
|
584
|
+
|
|
585
|
+
# message specified:
|
|
586
|
+
|
|
587
|
+
C?( ":foo must be thrown", :foo ) { throw :bar, 789 } # => false
|
|
588
|
+
</pre>
|
|
589
|
+
|
|
590
|
+
</div>
|
|
591
|
+
|
|
592
|
+
|
|
593
|
+
|
|
594
|
+
|
|
595
|
+
<div class="sourcecode">
|
|
596
|
+
<p class="source-link">
|
|
597
|
+
Source: <a href="javascript:toggleSource('M000014_source')" id="l_M000014_source">show</a>
|
|
598
|
+
|
|
599
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L515" target="_blank" class="github_url">on GitHub</a>
|
|
600
|
+
|
|
601
|
+
</p>
|
|
602
|
+
<div id="M000014_source" class="dyn-source">
|
|
603
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 515</span>
|
|
604
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">C?</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">symbol</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
605
|
+
<span class="ruby-identifier">assert_catch</span> <span class="ruby-identifier">:sample</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">symbol</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
495
606
|
<span class="ruby-keyword kw">end</span></pre>
|
|
496
607
|
</div>
|
|
497
608
|
</div>
|
|
@@ -506,7 +617,6 @@ and returns the value that was thrown along with the symbol.
|
|
|
506
617
|
</div>
|
|
507
618
|
|
|
508
619
|
<div class="description">
|
|
509
|
-
|
|
510
620
|
<p>
|
|
511
621
|
Defines a new test, composed of the given description and the given block
|
|
512
622
|
to execute.
|
|
@@ -548,11 +658,11 @@ A test may contain nested tests.
|
|
|
548
658
|
<p class="source-link">
|
|
549
659
|
Source: <a href="javascript:toggleSource('M000000_source')" id="l_M000000_source">show</a>
|
|
550
660
|
|
|
551
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
661
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L119" target="_blank" class="github_url">on GitHub</a>
|
|
552
662
|
|
|
553
663
|
</p>
|
|
554
664
|
<div id="M000000_source" class="dyn-source">
|
|
555
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
665
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 119</span>
|
|
556
666
|
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">D</span> <span class="ruby-identifier">description</span> = <span class="ruby-identifier">caller</span>.<span class="ruby-identifier">first</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
557
667
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'block must be given'</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block</span>
|
|
558
668
|
<span class="ruby-ivar">@curr_suite</span>.<span class="ruby-identifier">tests</span> <span class="ruby-operator"><<</span> <span class="ruby-constant">Suite</span><span class="ruby-operator">::</span><span class="ruby-constant">Test</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">description</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-identifier">block</span>)
|
|
@@ -563,17 +673,22 @@ A test may contain nested tests.
|
|
|
563
673
|
</div>
|
|
564
674
|
|
|
565
675
|
<div class="method">
|
|
566
|
-
<div class="title" id="
|
|
676
|
+
<div class="title" id="M000009">
|
|
567
677
|
|
|
568
|
-
<a name="
|
|
678
|
+
<a name="M000009"></a><b>E</b>(message = nil, *kinds, &block)
|
|
569
679
|
|
|
570
680
|
</div>
|
|
571
681
|
|
|
572
682
|
<div class="description">
|
|
573
|
-
|
|
574
683
|
<p>
|
|
575
684
|
Asserts that one of the given kinds of exceptions is raised when the given
|
|
576
|
-
block is executed
|
|
685
|
+
block is executed.
|
|
686
|
+
</p>
|
|
687
|
+
<p>
|
|
688
|
+
If the block raises an exception, then that exception is returned.
|
|
689
|
+
</p>
|
|
690
|
+
<p>
|
|
691
|
+
Otherwise, nil is returned.
|
|
577
692
|
</p>
|
|
578
693
|
<h4>Parameters</h4>
|
|
579
694
|
<dl>
|
|
@@ -614,41 +729,87 @@ StandardError).
|
|
|
614
729
|
|
|
615
730
|
<div class="sourcecode">
|
|
616
731
|
<p class="source-link">
|
|
617
|
-
Source: <a href="javascript:toggleSource('
|
|
732
|
+
Source: <a href="javascript:toggleSource('M000009_source')" id="l_M000009_source">show</a>
|
|
618
733
|
|
|
619
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
734
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L344" target="_blank" class="github_url">on GitHub</a>
|
|
620
735
|
|
|
621
736
|
</p>
|
|
622
|
-
<div id="
|
|
623
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
737
|
+
<div id="M000009_source" class="dyn-source">
|
|
738
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 344</span>
|
|
624
739
|
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">E</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
625
|
-
<span class="ruby-identifier">
|
|
740
|
+
<span class="ruby-identifier">assert_raise</span> <span class="ruby-identifier">:assert</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
741
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
742
|
+
</div>
|
|
743
|
+
</div>
|
|
744
|
+
|
|
745
|
+
</div>
|
|
746
|
+
|
|
747
|
+
<div class="method">
|
|
748
|
+
<div class="title" id="M000010">
|
|
749
|
+
|
|
750
|
+
<a name="M000010"></a><b>E!</b>(message = nil, *kinds, &block)
|
|
751
|
+
|
|
752
|
+
</div>
|
|
753
|
+
|
|
754
|
+
<div class="description">
|
|
755
|
+
<p>
|
|
756
|
+
Asserts that one of the given kinds of exceptions is not raised when the
|
|
757
|
+
given block is executed.
|
|
758
|
+
</p>
|
|
759
|
+
<p>
|
|
760
|
+
If the block raises an exception, then that exception is returned.
|
|
761
|
+
</p>
|
|
762
|
+
<p>
|
|
763
|
+
Otherwise, nil is returned.
|
|
764
|
+
</p>
|
|
765
|
+
<h4>Parameters</h4>
|
|
766
|
+
<dl>
|
|
767
|
+
<dt>message</dt><dd>Optional message to show in the report if this assertion fails.
|
|
626
768
|
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
<span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>
|
|
630
|
-
<span class="ruby-keyword kw">end</span>
|
|
769
|
+
</dd>
|
|
770
|
+
<dt>kinds</dt><dd>Exception classes that must not be raised by the given block.
|
|
631
771
|
|
|
632
|
-
|
|
633
|
-
|
|
772
|
+
<p>
|
|
773
|
+
If none are given, then StandardError is assumed (similar to how a plain
|
|
774
|
+
‘rescue’ statement without any arguments catches
|
|
775
|
+
StandardError).
|
|
776
|
+
</p>
|
|
777
|
+
</dd>
|
|
778
|
+
</dl>
|
|
779
|
+
<h4>Examples</h4>
|
|
780
|
+
<pre>
|
|
781
|
+
# no exceptions specified:
|
|
634
782
|
|
|
635
|
-
|
|
636
|
-
|
|
783
|
+
E! { } # passes
|
|
784
|
+
E! { raise } # fails
|
|
637
785
|
|
|
638
|
-
|
|
639
|
-
<span class="ruby-ivar">@exec_stats</span>[<span class="ruby-identifier">:passed_assertions</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
|
|
786
|
+
# single exception specified:
|
|
640
787
|
|
|
641
|
-
|
|
642
|
-
|
|
788
|
+
E!( ArgumentError ) { raise ArgumentError } # fails
|
|
789
|
+
E!( "argument must be invalid", ArgumentError ) { raise ArgumentError }
|
|
643
790
|
|
|
644
|
-
|
|
645
|
-
<span class="ruby-identifier">debug_uncaught_exception</span> <span class="ruby-identifier">block</span>, <span class="ruby-identifier">raised</span>
|
|
791
|
+
# multiple exceptions specified:
|
|
646
792
|
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
793
|
+
E!( SyntaxError, NameError ) { eval "..." }
|
|
794
|
+
E!( "string must compile", SyntaxError, NameError ) { eval "..." }
|
|
795
|
+
</pre>
|
|
650
796
|
|
|
651
|
-
|
|
797
|
+
</div>
|
|
798
|
+
|
|
799
|
+
|
|
800
|
+
|
|
801
|
+
|
|
802
|
+
<div class="sourcecode">
|
|
803
|
+
<p class="source-link">
|
|
804
|
+
Source: <a href="javascript:toggleSource('M000010_source')" id="l_M000010_source">show</a>
|
|
805
|
+
|
|
806
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L386" target="_blank" class="github_url">on GitHub</a>
|
|
807
|
+
|
|
808
|
+
</p>
|
|
809
|
+
<div id="M000010_source" class="dyn-source">
|
|
810
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 386</span>
|
|
811
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">E!</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
812
|
+
<span class="ruby-identifier">assert_raise</span> <span class="ruby-identifier">:negate</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
652
813
|
<span class="ruby-keyword kw">end</span></pre>
|
|
653
814
|
</div>
|
|
654
815
|
</div>
|
|
@@ -656,36 +817,45 @@ StandardError).
|
|
|
656
817
|
</div>
|
|
657
818
|
|
|
658
819
|
<div class="method">
|
|
659
|
-
<div class="title" id="
|
|
820
|
+
<div class="title" id="M000011">
|
|
660
821
|
|
|
661
|
-
<a name="
|
|
822
|
+
<a name="M000011"></a><b>E?</b>(message = nil, *kinds, &block)
|
|
662
823
|
|
|
663
824
|
</div>
|
|
664
825
|
|
|
665
826
|
<div class="description">
|
|
666
|
-
|
|
667
827
|
<p>
|
|
668
|
-
|
|
669
|
-
|
|
828
|
+
Returns true if one of the given kinds of exceptions is raised when the
|
|
829
|
+
given block is executed. Otherwise, returns false.
|
|
670
830
|
</p>
|
|
671
831
|
<h4>Parameters</h4>
|
|
672
832
|
<dl>
|
|
673
|
-
<dt>message</dt><dd>
|
|
833
|
+
<dt>message</dt><dd>This parameter is optional and completely ignored.
|
|
834
|
+
|
|
835
|
+
</dd>
|
|
836
|
+
<dt>kinds</dt><dd>Exception classes that must be raised by the given block.
|
|
674
837
|
|
|
838
|
+
<p>
|
|
839
|
+
If none are given, then StandardError is assumed (similar to how a plain
|
|
840
|
+
‘rescue’ statement without any arguments catches
|
|
841
|
+
StandardError).
|
|
842
|
+
</p>
|
|
675
843
|
</dd>
|
|
676
844
|
</dl>
|
|
677
845
|
<h4>Examples</h4>
|
|
678
846
|
<pre>
|
|
679
|
-
# no
|
|
847
|
+
# no exceptions specified:
|
|
680
848
|
|
|
681
|
-
|
|
849
|
+
E? { } # => false
|
|
850
|
+
E? { raise } # => true
|
|
682
851
|
|
|
683
|
-
|
|
684
|
-
F { nil } # passes
|
|
852
|
+
# single exception specified:
|
|
685
853
|
|
|
686
|
-
#
|
|
854
|
+
E?( ArgumentError ) { raise ArgumentError } # => true
|
|
855
|
+
|
|
856
|
+
# multiple exceptions specified:
|
|
687
857
|
|
|
688
|
-
|
|
858
|
+
E?( SyntaxError, NameError ) { eval "..." } # => true
|
|
689
859
|
</pre>
|
|
690
860
|
|
|
691
861
|
</div>
|
|
@@ -695,24 +865,68 @@ returns that result.
|
|
|
695
865
|
|
|
696
866
|
<div class="sourcecode">
|
|
697
867
|
<p class="source-link">
|
|
698
|
-
Source: <a href="javascript:toggleSource('
|
|
868
|
+
Source: <a href="javascript:toggleSource('M000011_source')" id="l_M000011_source">show</a>
|
|
699
869
|
|
|
700
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
870
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L421" target="_blank" class="github_url">on GitHub</a>
|
|
701
871
|
|
|
702
872
|
</p>
|
|
703
|
-
<div id="
|
|
704
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
705
|
-
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">
|
|
706
|
-
<span class="ruby-identifier">
|
|
873
|
+
<div id="M000011_source" class="dyn-source">
|
|
874
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 421</span>
|
|
875
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">E?</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
876
|
+
<span class="ruby-identifier">assert_raise</span> <span class="ruby-identifier">:sample</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kinds</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
877
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
878
|
+
</div>
|
|
879
|
+
</div>
|
|
880
|
+
|
|
881
|
+
</div>
|
|
882
|
+
|
|
883
|
+
<div class="method">
|
|
884
|
+
<div class="title" id="M000008">
|
|
885
|
+
|
|
886
|
+
<a name="M000008"></a><b>F?</b>(message = nil, &block)
|
|
887
|
+
|
|
888
|
+
</div>
|
|
889
|
+
|
|
890
|
+
<div class="description">
|
|
891
|
+
<p>
|
|
892
|
+
Returns true if the result of the given block is either nil or false.
|
|
893
|
+
Otherwise, returns false.
|
|
894
|
+
</p>
|
|
895
|
+
<h4>Parameters</h4>
|
|
896
|
+
<dl>
|
|
897
|
+
<dt>message</dt><dd>This parameter is optional and completely ignored.
|
|
707
898
|
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
899
|
+
</dd>
|
|
900
|
+
</dl>
|
|
901
|
+
<h4>Examples</h4>
|
|
902
|
+
<pre>
|
|
903
|
+
# no message specified:
|
|
904
|
+
|
|
905
|
+
F? { true } # => false
|
|
906
|
+
F? { false } # => true
|
|
907
|
+
F? { nil } # => true
|
|
908
|
+
|
|
909
|
+
# message specified:
|
|
910
|
+
|
|
911
|
+
F?( "computers do not doublethink" ) { 2 + 2 == 5 } # => true
|
|
912
|
+
</pre>
|
|
714
913
|
|
|
715
|
-
|
|
914
|
+
</div>
|
|
915
|
+
|
|
916
|
+
|
|
917
|
+
|
|
918
|
+
|
|
919
|
+
<div class="sourcecode">
|
|
920
|
+
<p class="source-link">
|
|
921
|
+
Source: <a href="javascript:toggleSource('M000008_source')" id="l_M000008_source">show</a>
|
|
922
|
+
|
|
923
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L301" target="_blank" class="github_url">on GitHub</a>
|
|
924
|
+
|
|
925
|
+
</p>
|
|
926
|
+
<div id="M000008_source" class="dyn-source">
|
|
927
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 301</span>
|
|
928
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">F?</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
929
|
+
<span class="ruby-keyword kw">not</span> <span class="ruby-constant">T?</span> <span class="ruby-identifier">message</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
716
930
|
<span class="ruby-keyword kw">end</span></pre>
|
|
717
931
|
</div>
|
|
718
932
|
</div>
|
|
@@ -722,12 +936,11 @@ returns that result.
|
|
|
722
936
|
<div class="method">
|
|
723
937
|
<div class="title" id="M000005">
|
|
724
938
|
|
|
725
|
-
<a name="M000005"></a><b>T</b>(message =
|
|
939
|
+
<a name="M000005"></a><b>T</b>(message = nil, &block)
|
|
726
940
|
|
|
727
941
|
</div>
|
|
728
942
|
|
|
729
943
|
<div class="description">
|
|
730
|
-
|
|
731
944
|
<p>
|
|
732
945
|
Asserts that the result of the given block is neither nil nor false and
|
|
733
946
|
returns that result.
|
|
@@ -743,7 +956,6 @@ returns that result.
|
|
|
743
956
|
# no message specified:
|
|
744
957
|
|
|
745
958
|
T { true } # passes
|
|
746
|
-
|
|
747
959
|
T { false } # fails
|
|
748
960
|
T { nil } # fails
|
|
749
961
|
|
|
@@ -761,22 +973,66 @@ returns that result.
|
|
|
761
973
|
<p class="source-link">
|
|
762
974
|
Source: <a href="javascript:toggleSource('M000005_source')" id="l_M000005_source">show</a>
|
|
763
975
|
|
|
764
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
976
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L221" target="_blank" class="github_url">on GitHub</a>
|
|
765
977
|
|
|
766
978
|
</p>
|
|
767
979
|
<div id="M000005_source" class="dyn-source">
|
|
768
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
769
|
-
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">T</span> <span class="ruby-identifier">message</span> = <span class="ruby-
|
|
770
|
-
<span class="ruby-identifier">
|
|
980
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 221</span>
|
|
981
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">T</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
982
|
+
<span class="ruby-identifier">assert_block</span> <span class="ruby-identifier">:assert</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
983
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
984
|
+
</div>
|
|
985
|
+
</div>
|
|
986
|
+
|
|
987
|
+
</div>
|
|
988
|
+
|
|
989
|
+
<div class="method">
|
|
990
|
+
<div class="title" id="M000006">
|
|
991
|
+
|
|
992
|
+
<a name="M000006"></a><b>T!</b>(message = nil, &block)
|
|
993
|
+
|
|
994
|
+
</div>
|
|
995
|
+
|
|
996
|
+
<div class="description">
|
|
997
|
+
<p>
|
|
998
|
+
Asserts that the result of the given block is either nil or false and
|
|
999
|
+
returns that result.
|
|
1000
|
+
</p>
|
|
1001
|
+
<h4>Parameters</h4>
|
|
1002
|
+
<dl>
|
|
1003
|
+
<dt>message</dt><dd>Optional message to show in the report if this assertion fails.
|
|
771
1004
|
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
1005
|
+
</dd>
|
|
1006
|
+
</dl>
|
|
1007
|
+
<h4>Examples</h4>
|
|
1008
|
+
<pre>
|
|
1009
|
+
# no message specified:
|
|
1010
|
+
|
|
1011
|
+
T! { true } # fails
|
|
1012
|
+
T! { false } # passes
|
|
1013
|
+
T! { nil } # passes
|
|
1014
|
+
|
|
1015
|
+
# message specified:
|
|
1016
|
+
|
|
1017
|
+
T!( "computers do not doublethink" ) { 2 + 2 == 5 } # passes
|
|
1018
|
+
</pre>
|
|
778
1019
|
|
|
779
|
-
|
|
1020
|
+
</div>
|
|
1021
|
+
|
|
1022
|
+
|
|
1023
|
+
|
|
1024
|
+
|
|
1025
|
+
<div class="sourcecode">
|
|
1026
|
+
<p class="source-link">
|
|
1027
|
+
Source: <a href="javascript:toggleSource('M000006_source')" id="l_M000006_source">show</a>
|
|
1028
|
+
|
|
1029
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L247" target="_blank" class="github_url">on GitHub</a>
|
|
1030
|
+
|
|
1031
|
+
</p>
|
|
1032
|
+
<div id="M000006_source" class="dyn-source">
|
|
1033
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 247</span>
|
|
1034
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">T!</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
1035
|
+
<span class="ruby-identifier">assert_block</span> <span class="ruby-identifier">:negate</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
780
1036
|
<span class="ruby-keyword kw">end</span></pre>
|
|
781
1037
|
</div>
|
|
782
1038
|
</div>
|
|
@@ -784,14 +1040,66 @@ returns that result.
|
|
|
784
1040
|
</div>
|
|
785
1041
|
|
|
786
1042
|
<div class="method">
|
|
787
|
-
<div class="title" id="
|
|
1043
|
+
<div class="title" id="M000007">
|
|
788
1044
|
|
|
789
|
-
<a name="
|
|
1045
|
+
<a name="M000007"></a><b>T?</b>(message = nil, &block)
|
|
1046
|
+
|
|
1047
|
+
</div>
|
|
1048
|
+
|
|
1049
|
+
<div class="description">
|
|
1050
|
+
<p>
|
|
1051
|
+
Returns true if the result of the given block is neither nil nor false.
|
|
1052
|
+
Otherwise, returns false.
|
|
1053
|
+
</p>
|
|
1054
|
+
<h4>Parameters</h4>
|
|
1055
|
+
<dl>
|
|
1056
|
+
<dt>message</dt><dd>This parameter is optional and completely ignored.
|
|
1057
|
+
|
|
1058
|
+
</dd>
|
|
1059
|
+
</dl>
|
|
1060
|
+
<h4>Examples</h4>
|
|
1061
|
+
<pre>
|
|
1062
|
+
# no message specified:
|
|
1063
|
+
|
|
1064
|
+
T? { true } # => true
|
|
1065
|
+
T? { false } # => false
|
|
1066
|
+
T? { nil } # => false
|
|
1067
|
+
|
|
1068
|
+
# message specified:
|
|
1069
|
+
|
|
1070
|
+
T?( "computers do not doublethink" ) { 2 + 2 != 5 } # => true
|
|
1071
|
+
</pre>
|
|
1072
|
+
|
|
1073
|
+
</div>
|
|
1074
|
+
|
|
1075
|
+
|
|
1076
|
+
|
|
1077
|
+
|
|
1078
|
+
<div class="sourcecode">
|
|
1079
|
+
<p class="source-link">
|
|
1080
|
+
Source: <a href="javascript:toggleSource('M000007_source')" id="l_M000007_source">show</a>
|
|
1081
|
+
|
|
1082
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L272" target="_blank" class="github_url">on GitHub</a>
|
|
1083
|
+
|
|
1084
|
+
</p>
|
|
1085
|
+
<div id="M000007_source" class="dyn-source">
|
|
1086
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 272</span>
|
|
1087
|
+
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">T?</span> <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
1088
|
+
<span class="ruby-identifier">assert_block</span> <span class="ruby-identifier">:sample</span>, <span class="ruby-identifier">message</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>
|
|
1089
|
+
<span class="ruby-keyword kw">end</span></pre>
|
|
1090
|
+
</div>
|
|
1091
|
+
</div>
|
|
1092
|
+
|
|
1093
|
+
</div>
|
|
1094
|
+
|
|
1095
|
+
<div class="method">
|
|
1096
|
+
<div class="title" id="M000015">
|
|
1097
|
+
|
|
1098
|
+
<a name="M000015"></a><b>run</b>()
|
|
790
1099
|
|
|
791
1100
|
</div>
|
|
792
1101
|
|
|
793
1102
|
<div class="description">
|
|
794
|
-
|
|
795
1103
|
<p>
|
|
796
1104
|
Executes all tests defined thus far and stores the results in <a
|
|
797
1105
|
href="Dfect.html#report">report</a>.
|
|
@@ -804,13 +1112,13 @@ href="Dfect.html#report">report</a>.
|
|
|
804
1112
|
|
|
805
1113
|
<div class="sourcecode">
|
|
806
1114
|
<p class="source-link">
|
|
807
|
-
Source: <a href="javascript:toggleSource('
|
|
1115
|
+
Source: <a href="javascript:toggleSource('M000015_source')" id="l_M000015_source">show</a>
|
|
808
1116
|
|
|
809
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
1117
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L522" target="_blank" class="github_url">on GitHub</a>
|
|
810
1118
|
|
|
811
1119
|
</p>
|
|
812
|
-
<div id="
|
|
813
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
1120
|
+
<div id="M000015_source" class="dyn-source">
|
|
1121
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 522</span>
|
|
814
1122
|
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run</span>
|
|
815
1123
|
<span class="ruby-comment cmt"># clear previous results</span>
|
|
816
1124
|
<span class="ruby-ivar">@exec_stats</span>.<span class="ruby-identifier">clear</span>
|
|
@@ -831,16 +1139,15 @@ href="Dfect.html#report">report</a>.
|
|
|
831
1139
|
</div>
|
|
832
1140
|
|
|
833
1141
|
<div class="method">
|
|
834
|
-
<div class="title" id="
|
|
1142
|
+
<div class="title" id="M000016">
|
|
835
1143
|
|
|
836
|
-
<a name="
|
|
1144
|
+
<a name="M000016"></a><b>stop</b>()
|
|
837
1145
|
|
|
838
1146
|
</div>
|
|
839
1147
|
|
|
840
1148
|
<div class="description">
|
|
841
|
-
|
|
842
1149
|
<p>
|
|
843
|
-
Stops the execution of the <a href="Dfect.html#
|
|
1150
|
+
Stops the execution of the <a href="Dfect.html#M000015">run</a> method or
|
|
844
1151
|
raises an exception if that method is not currently executing.
|
|
845
1152
|
</p>
|
|
846
1153
|
|
|
@@ -851,13 +1158,13 @@ raises an exception if that method is not currently executing.
|
|
|
851
1158
|
|
|
852
1159
|
<div class="sourcecode">
|
|
853
1160
|
<p class="source-link">
|
|
854
|
-
Source: <a href="javascript:toggleSource('
|
|
1161
|
+
Source: <a href="javascript:toggleSource('M000016_source')" id="l_M000016_source">show</a>
|
|
855
1162
|
|
|
856
|
-
| <a href="http://github.com/sunaku/dfect/blob/
|
|
1163
|
+
| <a href="http://github.com/sunaku/dfect/blob/574a471b9687d6f0aac490200081f0dcd5db8a58/lib/dfect.rb#L541" target="_blank" class="github_url">on GitHub</a>
|
|
857
1164
|
|
|
858
1165
|
</p>
|
|
859
|
-
<div id="
|
|
860
|
-
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line
|
|
1166
|
+
<div id="M000016_source" class="dyn-source">
|
|
1167
|
+
<pre><span class="ruby-comment cmt"># File lib/dfect.rb, line 541</span>
|
|
861
1168
|
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stop</span>
|
|
862
1169
|
<span class="ruby-identifier">throw</span> <span class="ruby-identifier">:stop_dfect_execution</span>
|
|
863
1170
|
<span class="ruby-keyword kw">end</span></pre>
|