minitest 5.11.3 → 5.14.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data.tar.gz.sig +0 -0
- data/History.rdoc +70 -0
- data/Manifest.txt +1 -0
- data/README.rdoc +25 -7
- data/Rakefile +1 -15
- data/lib/minitest.rb +84 -18
- data/lib/minitest/assertions.rb +139 -25
- data/lib/minitest/benchmark.rb +2 -2
- data/lib/minitest/expectations.rb +25 -6
- data/lib/minitest/spec.rb +19 -8
- data/test/minitest/metametameta.rb +23 -8
- data/test/minitest/test_minitest_assertions.rb +1567 -0
- data/test/minitest/test_minitest_mock.rb +2 -4
- data/test/minitest/test_minitest_spec.rb +195 -141
- data/test/minitest/test_minitest_test.rb +31 -1093
- metadata +28 -20
- metadata.gz.sig +0 -0
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c0b1641b87002f1e0b64cc5e81815a6bdbd22e22fa25f54f80316fe009f5ad72
|
4
|
+
data.tar.gz: d63d8373fa0888051f79d4ca405e267e97a5334ffb22aee248227e1485400af3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 76fa5340f5d7f9086b802c13440dad142be63e81d7874d4eb4ec42f60f4530038b74cac18830e2066c80572408f095b45c5639879a38790bacfd3c4a4e13730d
|
7
|
+
data.tar.gz: 80e644aeb07febab6f16d32af2e8435045e415d86d145c37afba0a6f694cba304b934a1ff146186a34b108ae3039ff610318e585af6fd087b5b8143aa1f3808a
|
checksums.yaml.gz.sig
CHANGED
Binary file
|
data.tar.gz.sig
CHANGED
Binary file
|
data/History.rdoc
CHANGED
@@ -1,3 +1,73 @@
|
|
1
|
+
=== 5.14.0 / 2020-01-11
|
2
|
+
|
3
|
+
* 2 minor enhancements:
|
4
|
+
|
5
|
+
* Block-assertions (eg assert_output) now error if raised inside the block. (casperisfine)
|
6
|
+
* Changed assert_raises to only catch Assertion since that covers Skip and friends.
|
7
|
+
|
8
|
+
* 3 bug fixes:
|
9
|
+
|
10
|
+
* Added example for value wrapper with block to Expectations module. (stomar)
|
11
|
+
* Fixed use of must/wont_be_within_delta on Expectation instance. (stomar)
|
12
|
+
* Renamed UnexpectedError#exception to #error to avoid problems with reraising. (casperisfine)
|
13
|
+
|
14
|
+
=== 5.13.0 / 2019-10-29
|
15
|
+
|
16
|
+
* 9 minor enhancements:
|
17
|
+
|
18
|
+
* Added Minitest::Guard#osx?
|
19
|
+
* Added examples to documentation for assert_raises. (lxxxvi)
|
20
|
+
* Added expectations #path_must_exist and #path_wont_exist. Not thrilled with the names.
|
21
|
+
* Added fail_after(year, month, day, msg) to allow time-bombing after a deadline.
|
22
|
+
* Added skip_until(year, month, day, msg) to allow deferring until a deadline.
|
23
|
+
* Deprecated Minitest::Guard#maglev?
|
24
|
+
* Deprecated Minitest::Guard#rubinius?
|
25
|
+
* Finally added assert_path_exists and refute_path_exists. (deivid-rodriguez)
|
26
|
+
* Refactored and pulled Assertions#things_to_diff out of #diff. (BurdetteLamar)
|
27
|
+
|
28
|
+
* 3 bug fixes:
|
29
|
+
|
30
|
+
* Fix autorun bug that affects fork exit status in tests. (dylanahsmith/jhawthorn)
|
31
|
+
* Improved documentation for _/value/expect, especially for blocks. (svoop)
|
32
|
+
* Support new Proc#to_s format. (ko1)
|
33
|
+
|
34
|
+
=== 5.12.2 / 2019-09-28
|
35
|
+
|
36
|
+
* 1 bug fix:
|
37
|
+
|
38
|
+
* After chatting w/ @y-yagi and others, decided to lower support to include ruby 2.2.
|
39
|
+
|
40
|
+
=== 5.12.1 / 2019-09-28
|
41
|
+
|
42
|
+
* 1 minor enhancement:
|
43
|
+
|
44
|
+
* Added documentation for Reporter classes. (sshaw)
|
45
|
+
|
46
|
+
* 3 bug fixes:
|
47
|
+
|
48
|
+
* Avoid using 'match?' to support older ruby versions. (y-yagi)
|
49
|
+
* Fixed broken link to reference on goodness-of-fit testing. (havenwood)
|
50
|
+
* Update requirements in readme and Rakefile/hoe spec.
|
51
|
+
|
52
|
+
=== 5.12.0 / 2019-09-22
|
53
|
+
|
54
|
+
* 8 minor enhancements:
|
55
|
+
|
56
|
+
* Added a descriptive error if assert_output or assert_raises called without a block. (okuramasafumi)
|
57
|
+
* Changed mu_pp_for_diff to make having both \n and \\n easier to debug.
|
58
|
+
* Deprecated $N for specifying number of parallel test runners. Use MT_CPU.
|
59
|
+
* Deprecated use of global expectations. To be removed from MT6.
|
60
|
+
* Extended Assertions#mu_pp to encoding validity output for strings to improve diffs.
|
61
|
+
* Extended Assertions#mu_pp to output encoding and validity if invalid to improve diffs.
|
62
|
+
* Extended Assertions#mu_pp_for_diff to make escaped newlines more obvious in diffs.
|
63
|
+
* Fail gracefully when expectation used outside of `it`.
|
64
|
+
|
65
|
+
* 3 bug fixes:
|
66
|
+
|
67
|
+
* Check `option[:filter]` klass before match. Fixes 2.6 warning. (y-yagi)
|
68
|
+
* Fixed Assertions#diff from recalculating if set to nil
|
69
|
+
* Fixed spec section of readme to not use deprecated global expectations. (CheezItMan)
|
70
|
+
|
1
71
|
=== 5.11.3 / 2018-01-26
|
2
72
|
|
3
73
|
* 1 bug fix:
|
data/Manifest.txt
CHANGED
@@ -19,6 +19,7 @@ lib/minitest/spec.rb
|
|
19
19
|
lib/minitest/test.rb
|
20
20
|
lib/minitest/unit.rb
|
21
21
|
test/minitest/metametameta.rb
|
22
|
+
test/minitest/test_minitest_assertions.rb
|
22
23
|
test/minitest/test_minitest_benchmark.rb
|
23
24
|
test/minitest/test_minitest_mock.rb
|
24
25
|
test/minitest/test_minitest_reporter.rb
|
data/README.rdoc
CHANGED
@@ -126,13 +126,13 @@ Define your tests as methods beginning with +test_+.
|
|
126
126
|
|
127
127
|
describe "when asked about cheeseburgers" do
|
128
128
|
it "must respond positively" do
|
129
|
-
@meme.i_can_has_cheezburger
|
129
|
+
_(@meme.i_can_has_cheezburger?).must_equal "OHAI!"
|
130
130
|
end
|
131
131
|
end
|
132
132
|
|
133
133
|
describe "when asked about blending possibilities" do
|
134
134
|
it "won't say no" do
|
135
|
-
@meme.will_it_blend
|
135
|
+
_(@meme.will_it_blend?).wont_match /^no/i
|
136
136
|
end
|
137
137
|
end
|
138
138
|
end
|
@@ -220,9 +220,9 @@ verification to ensure they got all the calls they were expecting."
|
|
220
220
|
end
|
221
221
|
end
|
222
222
|
|
223
|
-
|
223
|
+
==== Multi-threading and Mocks
|
224
224
|
|
225
|
-
Minitest mocks do not support multi-threading
|
225
|
+
Minitest mocks do not support multi-threading. If it works, fine, if it doesn't
|
226
226
|
you can use regular ruby patterns and facilities like local variables. Here's
|
227
227
|
an example of asserting that code inside a thread is run:
|
228
228
|
|
@@ -294,6 +294,18 @@ provided via plugins. To see them, simply run with +--help+:
|
|
294
294
|
-p, --pride Pride. Show your testing pride!
|
295
295
|
-a, --autotest Connect to autotest server.
|
296
296
|
|
297
|
+
You can set up a rake task to run all your tests by adding this to your Rakefile:
|
298
|
+
|
299
|
+
require "rake/testtask"
|
300
|
+
|
301
|
+
Rake::TestTask.new(:test) do |t|
|
302
|
+
t.libs << "test"
|
303
|
+
t.libs << "lib"
|
304
|
+
t.test_files = FileList["test/**/test_*.rb"]
|
305
|
+
end
|
306
|
+
|
307
|
+
task :default => :test
|
308
|
+
|
297
309
|
== Writing Extensions
|
298
310
|
|
299
311
|
To define a plugin, add a file named minitest/XXX_plugin.rb to your
|
@@ -379,7 +391,7 @@ The following implementation and test:
|
|
379
391
|
end
|
380
392
|
|
381
393
|
it "must respond to work" do
|
382
|
-
@worker.must_respond_to :work
|
394
|
+
_(@worker).must_respond_to :work
|
383
395
|
end
|
384
396
|
end
|
385
397
|
|
@@ -469,6 +481,8 @@ able to require minitest and run your tests.
|
|
469
481
|
|
470
482
|
== Developing Minitest:
|
471
483
|
|
484
|
+
Minitest requires {Hoe}[https://rubygems.org/gems/hoe].
|
485
|
+
|
472
486
|
=== Minitest's own tests require UTF-8 external encoding.
|
473
487
|
|
474
488
|
This is a common problem in Windows, where the default external Encoding is
|
@@ -547,6 +561,7 @@ minispec-metadata :: Metadata for describe/it blocks & CLI tag filter.
|
|
547
561
|
E.g. <tt>it "requires JS driver", js: true do</tt> &
|
548
562
|
<tt>ruby test.rb --tag js</tt> runs tests tagged :js.
|
549
563
|
minispec-rails :: Minimal support to use Spec style in Rails 5+.
|
564
|
+
mini-apivore :: for swagger based automated API testing.
|
550
565
|
minitest-around :: Around block for minitest. An alternative to
|
551
566
|
setup/teardown dance.
|
552
567
|
minitest-assert_errors :: Adds Minitest assertions to test for errors raised
|
@@ -589,6 +604,7 @@ minitest-firemock :: Makes your Minitest mocks more resilient.
|
|
589
604
|
minitest-focus :: Focus on one test at a time.
|
590
605
|
minitest-gcstats :: A minitest plugin that adds a report of the top
|
591
606
|
tests by number of objects allocated.
|
607
|
+
minitest-global_expectations:: Support minitest expectation methods for all objects
|
592
608
|
minitest-great_expectations :: Generally useful additions to minitest's
|
593
609
|
assertions and expectations.
|
594
610
|
minitest-growl :: Test notifier for minitest via growl.
|
@@ -615,6 +631,7 @@ minitest-matchers :: Adds support for RSpec-style matchers to
|
|
615
631
|
minitest-matchers_vaccine :: Adds assertions that adhere to the matcher spec,
|
616
632
|
but without any expectation infections.
|
617
633
|
minitest-metadata :: Annotate tests with metadata (key-value).
|
634
|
+
minitest-mock_expectations :: Provides method call assertions for minitest.
|
618
635
|
minitest-mongoid :: Mongoid assertion matchers for Minitest.
|
619
636
|
minitest-must_not :: Provides must_not as an alias for wont in
|
620
637
|
Minitest.
|
@@ -660,10 +677,12 @@ minitest-unordered :: Adds a new assertion to minitest for checking the
|
|
660
677
|
contents of a collection, ignoring element order.
|
661
678
|
minitest-vcr :: Automatic cassette managment with Minitest::Spec
|
662
679
|
and VCR.
|
680
|
+
minitest_log :: Adds structured logging, data explication, and verdicts.
|
663
681
|
minitest_owrapper :: Get tests results as a TestResult object.
|
664
682
|
minitest_should :: Shoulda style syntax for minitest test::unit.
|
665
683
|
minitest_tu_shim :: Bridges between test/unit and minitest.
|
666
684
|
mongoid-minitest :: Minitest matchers for Mongoid.
|
685
|
+
mutant-minitest :: Minitest integration for mutant.
|
667
686
|
pry-rescue :: A pry plugin w/ minitest support. See
|
668
687
|
pry-rescue/minitest.rb.
|
669
688
|
rspec2minitest :: Easily translate any RSpec matchers to Minitest
|
@@ -697,8 +716,7 @@ Authors... Please send me a pull request with a description of your minitest ext
|
|
697
716
|
|
698
717
|
== REQUIREMENTS:
|
699
718
|
|
700
|
-
* Ruby
|
701
|
-
* NOTE: 1.8 and 1.9 will be dropped in minitest 6+.
|
719
|
+
* Ruby 2.3+. No magic is involved. I hope.
|
702
720
|
|
703
721
|
== INSTALL:
|
704
722
|
|
data/Rakefile
CHANGED
@@ -11,21 +11,7 @@ Hoe.spec "minitest" do
|
|
11
11
|
|
12
12
|
license "MIT"
|
13
13
|
|
14
|
-
|
15
|
-
#
|
16
|
-
# self.post_install_message = <<-"EOM"
|
17
|
-
# NOTE: minitest 5 will be the last in the minitest family to support
|
18
|
-
# ruby 1.8 and 1.9 (and maybe 2.0?). If you need to keep using 1.8
|
19
|
-
# or 1.9, you need to pin your dependency to minitest with
|
20
|
-
# something like "~> 5.0".
|
21
|
-
#
|
22
|
-
# Further, minitest 6 will be dropping the following:
|
23
|
-
#
|
24
|
-
# + MiniTest (it's been Minitest for *years*)
|
25
|
-
# + MiniTest::Unit
|
26
|
-
# + MiniTest::Unit::TestCase
|
27
|
-
# + assert_send (unless you argue for it well)
|
28
|
-
# EOM
|
14
|
+
require_ruby_version "~> 2.2"
|
29
15
|
end
|
30
16
|
|
31
17
|
desc "Find missing expectations"
|
data/lib/minitest.rb
CHANGED
@@ -8,7 +8,7 @@ require "stringio"
|
|
8
8
|
# :include: README.rdoc
|
9
9
|
|
10
10
|
module Minitest
|
11
|
-
VERSION = "5.
|
11
|
+
VERSION = "5.14.0" # :nodoc:
|
12
12
|
ENCS = "".respond_to? :encoding # :nodoc:
|
13
13
|
|
14
14
|
@@installed_at_exit ||= false
|
@@ -21,7 +21,10 @@ module Minitest
|
|
21
21
|
# Parallel test executor
|
22
22
|
|
23
23
|
mc.send :attr_accessor, :parallel_executor
|
24
|
-
|
24
|
+
|
25
|
+
warn "DEPRECATED: use MT_CPU instead of N for parallel test runs" if ENV["N"]
|
26
|
+
n_threads = (ENV["MT_CPU"] || ENV["N"] || 2).to_i
|
27
|
+
self.parallel_executor = Parallel::Executor.new n_threads
|
25
28
|
|
26
29
|
##
|
27
30
|
# Filter object for backtraces.
|
@@ -55,7 +58,9 @@ module Minitest
|
|
55
58
|
|
56
59
|
exit_code = nil
|
57
60
|
|
61
|
+
pid = Process.pid
|
58
62
|
at_exit {
|
63
|
+
next if Process.pid != pid
|
59
64
|
@@after_run.reverse_each(&:call)
|
60
65
|
exit exit_code || false
|
61
66
|
}
|
@@ -301,7 +306,7 @@ module Minitest
|
|
301
306
|
|
302
307
|
def self.run reporter, options = {}
|
303
308
|
filter = options[:filter] || "/./"
|
304
|
-
filter = Regexp.new $1 if filter =~ %r%/(.*)/%
|
309
|
+
filter = Regexp.new $1 if filter.is_a?(String) && filter =~ %r%/(.*)/%
|
305
310
|
|
306
311
|
filtered_methods = self.runnable_methods.find_all { |m|
|
307
312
|
filter === m || filter === "#{self}##{m}"
|
@@ -422,7 +427,8 @@ module Minitest
|
|
422
427
|
|
423
428
|
##
|
424
429
|
# Returns a single character string to print based on the result
|
425
|
-
# of the run.
|
430
|
+
# of the run. One of <tt>"."</tt>, <tt>"F"</tt>,
|
431
|
+
# <tt>"E"</tt> or <tt>"S"</tt>.
|
426
432
|
|
427
433
|
def result_code
|
428
434
|
raise NotImplementedError, "subclass responsibility"
|
@@ -560,8 +566,10 @@ module Minitest
|
|
560
566
|
end
|
561
567
|
|
562
568
|
##
|
563
|
-
#
|
564
|
-
# result
|
569
|
+
# Output and record the result of the test. Call
|
570
|
+
# {result#result_code}[rdoc-ref:Runnable#result_code] to get the
|
571
|
+
# result character string. Stores the result of the run if the run
|
572
|
+
# did not pass.
|
565
573
|
|
566
574
|
def record result
|
567
575
|
end
|
@@ -628,18 +636,63 @@ module Minitest
|
|
628
636
|
#
|
629
637
|
# If you want to create an entirely different type of output (eg,
|
630
638
|
# CI, HTML, etc), this is the place to start.
|
639
|
+
#
|
640
|
+
# Example:
|
641
|
+
#
|
642
|
+
# class JenkinsCIReporter < StatisticsReporter
|
643
|
+
# def report
|
644
|
+
# super # Needed to calculate some statistics
|
645
|
+
#
|
646
|
+
# print "<testsuite "
|
647
|
+
# print "tests='#{count}' "
|
648
|
+
# print "failures='#{failures}' "
|
649
|
+
# # Remaining XML...
|
650
|
+
# end
|
651
|
+
# end
|
631
652
|
|
632
653
|
class StatisticsReporter < Reporter
|
633
|
-
|
654
|
+
##
|
655
|
+
# Total number of assertions.
|
656
|
+
|
634
657
|
attr_accessor :assertions
|
658
|
+
|
659
|
+
##
|
660
|
+
# Total number of test cases.
|
661
|
+
|
635
662
|
attr_accessor :count
|
663
|
+
|
664
|
+
##
|
665
|
+
# An +Array+ of test cases that failed or were skipped.
|
666
|
+
|
636
667
|
attr_accessor :results
|
668
|
+
|
669
|
+
##
|
670
|
+
# Time the test run started. If available, the monotonic clock is
|
671
|
+
# used and this is a +Float+, otherwise it's an instance of
|
672
|
+
# +Time+.
|
673
|
+
|
637
674
|
attr_accessor :start_time
|
675
|
+
|
676
|
+
##
|
677
|
+
# Test run time. If available, the monotonic clock is used and
|
678
|
+
# this is a +Float+, otherwise it's an instance of +Time+.
|
679
|
+
|
638
680
|
attr_accessor :total_time
|
681
|
+
|
682
|
+
##
|
683
|
+
# Total number of tests that failed.
|
684
|
+
|
639
685
|
attr_accessor :failures
|
686
|
+
|
687
|
+
##
|
688
|
+
# Total number of tests that erred.
|
689
|
+
|
640
690
|
attr_accessor :errors
|
691
|
+
|
692
|
+
##
|
693
|
+
# Total number of tests that where skipped.
|
694
|
+
|
641
695
|
attr_accessor :skips
|
642
|
-
# :startdoc:
|
643
696
|
|
644
697
|
def initialize io = $stdout, options = {} # :nodoc:
|
645
698
|
super
|
@@ -669,7 +722,10 @@ module Minitest
|
|
669
722
|
results << result if not result.passed? or result.skipped?
|
670
723
|
end
|
671
724
|
|
672
|
-
|
725
|
+
##
|
726
|
+
# Report on the tracked statistics.
|
727
|
+
|
728
|
+
def report
|
673
729
|
aggregate = results.group_by { |r| r.failure.class }
|
674
730
|
aggregate.default = [] # dumb. group_by should provide this
|
675
731
|
|
@@ -851,24 +907,21 @@ module Minitest
|
|
851
907
|
# Assertion wrapping an unexpected error that was raised during a run.
|
852
908
|
|
853
909
|
class UnexpectedError < Assertion
|
854
|
-
|
910
|
+
# TODO: figure out how to use `cause` instead
|
911
|
+
attr_accessor :error # :nodoc:
|
855
912
|
|
856
|
-
def initialize
|
913
|
+
def initialize error # :nodoc:
|
857
914
|
super "Unexpected exception"
|
858
|
-
self.
|
915
|
+
self.error = error
|
859
916
|
end
|
860
917
|
|
861
918
|
def backtrace # :nodoc:
|
862
|
-
self.
|
863
|
-
end
|
864
|
-
|
865
|
-
def error # :nodoc:
|
866
|
-
self.exception
|
919
|
+
self.error.backtrace
|
867
920
|
end
|
868
921
|
|
869
922
|
def message # :nodoc:
|
870
923
|
bt = Minitest.filter_backtrace(self.backtrace).join "\n "
|
871
|
-
"#{self.
|
924
|
+
"#{self.error.class}: #{self.error.message}\n #{bt}"
|
872
925
|
end
|
873
926
|
|
874
927
|
def result_label # :nodoc:
|
@@ -904,6 +957,9 @@ module Minitest
|
|
904
957
|
# Is this running on maglev?
|
905
958
|
|
906
959
|
def maglev? platform = defined?(RUBY_ENGINE) && RUBY_ENGINE
|
960
|
+
where = Minitest.filter_backtrace(caller).first
|
961
|
+
where = where.split(/:in /, 2).first # clean up noise
|
962
|
+
warn "DEPRECATED: `maglev?` called from #{where}. This will fail in Minitest 6."
|
907
963
|
"maglev" == platform
|
908
964
|
end
|
909
965
|
|
@@ -914,10 +970,20 @@ module Minitest
|
|
914
970
|
/^ruby/ =~ platform
|
915
971
|
end
|
916
972
|
|
973
|
+
##
|
974
|
+
# Is this running on macOS?
|
975
|
+
|
976
|
+
def osx? platform = RUBY_PLATFORM
|
977
|
+
/darwin/ =~ platform
|
978
|
+
end
|
979
|
+
|
917
980
|
##
|
918
981
|
# Is this running on rubinius?
|
919
982
|
|
920
983
|
def rubinius? platform = defined?(RUBY_ENGINE) && RUBY_ENGINE
|
984
|
+
where = Minitest.filter_backtrace(caller).first
|
985
|
+
where = where.split(/:in /, 2).first # clean up noise
|
986
|
+
warn "DEPRECATED: `rubinius?` called from #{where}. This will fail in Minitest 6."
|
921
987
|
"rbx" == platform
|
922
988
|
end
|
923
989
|
|
data/lib/minitest/assertions.rb
CHANGED
@@ -27,20 +27,18 @@ module Minitest
|
|
27
27
|
# figure out what diff to use.
|
28
28
|
|
29
29
|
def self.diff
|
30
|
+
return @diff if defined? @diff
|
31
|
+
|
30
32
|
@diff = if (RbConfig::CONFIG["host_os"] =~ /mswin|mingw/ &&
|
31
33
|
system("diff.exe", __FILE__, __FILE__)) then
|
32
34
|
"diff.exe -u"
|
33
|
-
elsif Minitest::Test.maglev? then
|
34
|
-
"diff -u"
|
35
35
|
elsif system("gdiff", __FILE__, __FILE__)
|
36
36
|
"gdiff -u" # solaris and kin suck
|
37
37
|
elsif system("diff", __FILE__, __FILE__)
|
38
38
|
"diff -u"
|
39
39
|
else
|
40
40
|
nil
|
41
|
-
end
|
42
|
-
|
43
|
-
@diff
|
41
|
+
end
|
44
42
|
end
|
45
43
|
|
46
44
|
##
|
@@ -55,22 +53,16 @@ module Minitest
|
|
55
53
|
# diff command or if it doesn't make sense to diff the output
|
56
54
|
# (single line, short output), then it simply returns a basic
|
57
55
|
# comparison between the two.
|
56
|
+
#
|
57
|
+
# See +things_to_diff+ for more info.
|
58
58
|
|
59
59
|
def diff exp, act
|
60
|
-
expect = mu_pp_for_diff exp
|
61
|
-
butwas = mu_pp_for_diff act
|
62
60
|
result = nil
|
63
61
|
|
64
|
-
|
65
|
-
(expect.include?("\n") ||
|
66
|
-
butwas.include?("\n") ||
|
67
|
-
expect.size > 30 ||
|
68
|
-
butwas.size > 30 ||
|
69
|
-
expect == butwas) &&
|
70
|
-
Minitest::Assertions.diff
|
62
|
+
expect, butwas = things_to_diff(exp, act)
|
71
63
|
|
72
64
|
return "Expected: #{mu_pp exp}\n Actual: #{mu_pp act}" unless
|
73
|
-
|
65
|
+
expect
|
74
66
|
|
75
67
|
Tempfile.open("expect") do |a|
|
76
68
|
a.puts expect
|
@@ -99,10 +91,40 @@ module Minitest
|
|
99
91
|
result
|
100
92
|
end
|
101
93
|
|
94
|
+
##
|
95
|
+
# Returns things to diff [expect, butwas], or [nil, nil] if nothing to diff.
|
96
|
+
#
|
97
|
+
# Criterion:
|
98
|
+
#
|
99
|
+
# 1. Strings include newlines or escaped newlines, but not both.
|
100
|
+
# 2. or: String lengths are > 30 characters.
|
101
|
+
# 3. or: Strings are equal to each other (but maybe different encodings?).
|
102
|
+
# 4. and: we found a diff executable.
|
103
|
+
|
104
|
+
def things_to_diff exp, act
|
105
|
+
expect = mu_pp_for_diff exp
|
106
|
+
butwas = mu_pp_for_diff act
|
107
|
+
|
108
|
+
e1, e2 = expect.include?("\n"), expect.include?("\\n")
|
109
|
+
b1, b2 = butwas.include?("\n"), butwas.include?("\\n")
|
110
|
+
|
111
|
+
need_to_diff =
|
112
|
+
(e1 ^ e2 ||
|
113
|
+
b1 ^ b2 ||
|
114
|
+
expect.size > 30 ||
|
115
|
+
butwas.size > 30 ||
|
116
|
+
expect == butwas) &&
|
117
|
+
Minitest::Assertions.diff
|
118
|
+
|
119
|
+
need_to_diff && [expect, butwas]
|
120
|
+
end
|
121
|
+
|
102
122
|
##
|
103
123
|
# This returns a human-readable version of +obj+. By default
|
104
|
-
# #inspect is called. You can override this to use #
|
124
|
+
# #inspect is called. You can override this to use #pretty_inspect
|
105
125
|
# if you want.
|
126
|
+
#
|
127
|
+
# See Minitest::Test.make_my_diffs_pretty!
|
106
128
|
|
107
129
|
def mu_pp obj
|
108
130
|
s = obj.inspect
|
@@ -110,8 +132,11 @@ module Minitest
|
|
110
132
|
if defined? Encoding then
|
111
133
|
s = s.encode Encoding.default_external
|
112
134
|
|
113
|
-
if String === obj && obj.encoding != Encoding.default_external
|
114
|
-
|
135
|
+
if String === obj && (obj.encoding != Encoding.default_external ||
|
136
|
+
!obj.valid_encoding?) then
|
137
|
+
enc = "# encoding: #{obj.encoding}"
|
138
|
+
val = "# valid: #{obj.valid_encoding?}"
|
139
|
+
s = "#{enc}\n#{val}\n#{s}"
|
115
140
|
end
|
116
141
|
end
|
117
142
|
|
@@ -119,13 +144,32 @@ module Minitest
|
|
119
144
|
end
|
120
145
|
|
121
146
|
##
|
122
|
-
# This returns a diff-able human-readable version of +obj+.
|
123
|
-
# differs from the regular mu_pp because it expands escaped
|
124
|
-
# newlines and makes hex-values
|
147
|
+
# This returns a diff-able more human-readable version of +obj+.
|
148
|
+
# This differs from the regular mu_pp because it expands escaped
|
149
|
+
# newlines and makes hex-values (like object_ids) generic. This
|
125
150
|
# uses mu_pp to do the first pass and then cleans it up.
|
126
151
|
|
127
152
|
def mu_pp_for_diff obj
|
128
|
-
mu_pp
|
153
|
+
str = mu_pp obj
|
154
|
+
|
155
|
+
# both '\n' & '\\n' (_after_ mu_pp (aka inspect))
|
156
|
+
single = !!str.match(/(?<!\\|^)\\n/)
|
157
|
+
double = !!str.match(/(?<=\\|^)\\n/)
|
158
|
+
|
159
|
+
process =
|
160
|
+
if single ^ double then
|
161
|
+
if single then
|
162
|
+
lambda { |s| s == "\\n" ? "\n" : s } # unescape
|
163
|
+
else
|
164
|
+
lambda { |s| s == "\\\\n" ? "\\n\n" : s } # unescape a bit, add nls
|
165
|
+
end
|
166
|
+
else
|
167
|
+
:itself # leave it alone
|
168
|
+
end
|
169
|
+
|
170
|
+
str.
|
171
|
+
gsub(/\\?\\n/, &process).
|
172
|
+
gsub(/:0x[a-fA-F0-9]{4,}/m, ":0xXXXXXX") # anonymize hex values
|
129
173
|
end
|
130
174
|
|
131
175
|
##
|
@@ -283,6 +327,9 @@ module Minitest
|
|
283
327
|
# See also: #assert_silent
|
284
328
|
|
285
329
|
def assert_output stdout = nil, stderr = nil
|
330
|
+
flunk "assert_output requires a block to capture output." unless
|
331
|
+
block_given?
|
332
|
+
|
286
333
|
out, err = capture_io do
|
287
334
|
yield
|
288
335
|
end
|
@@ -294,6 +341,18 @@ module Minitest
|
|
294
341
|
x = send out_msg, stdout, out, "In stdout" if out_msg
|
295
342
|
|
296
343
|
(!stdout || x) && (!stderr || y)
|
344
|
+
rescue Assertion
|
345
|
+
raise
|
346
|
+
rescue => e
|
347
|
+
raise UnexpectedError, e
|
348
|
+
end
|
349
|
+
|
350
|
+
##
|
351
|
+
# Fails unless +path+ exists.
|
352
|
+
|
353
|
+
def assert_path_exists path, msg = nil
|
354
|
+
msg = message(msg) { "Expected path '#{path}' to exist" }
|
355
|
+
assert File.exist?(path), msg
|
297
356
|
end
|
298
357
|
|
299
358
|
##
|
@@ -316,9 +375,26 @@ module Minitest
|
|
316
375
|
#
|
317
376
|
# +exp+ takes an optional message on the end to help explain
|
318
377
|
# failures and defaults to StandardError if no exception class is
|
319
|
-
# passed.
|
378
|
+
# passed. Eg:
|
379
|
+
#
|
380
|
+
# assert_raises(CustomError) { method_with_custom_error }
|
381
|
+
#
|
382
|
+
# With custom error message:
|
383
|
+
#
|
384
|
+
# assert_raises(CustomError, 'This should have raised CustomError') { method_with_custom_error }
|
385
|
+
#
|
386
|
+
# Using the returned object:
|
387
|
+
#
|
388
|
+
# error = assert_raises(CustomError) do
|
389
|
+
# raise CustomError, 'This is really bad'
|
390
|
+
# end
|
391
|
+
#
|
392
|
+
# assert_equal 'This is really bad', error.message
|
320
393
|
|
321
394
|
def assert_raises *exp
|
395
|
+
flunk "assert_raises requires a block to capture errors." unless
|
396
|
+
block_given?
|
397
|
+
|
322
398
|
msg = "#{exp.pop}.\n" if String === exp.last
|
323
399
|
exp << StandardError if exp.empty?
|
324
400
|
|
@@ -327,7 +403,7 @@ module Minitest
|
|
327
403
|
rescue *exp => e
|
328
404
|
pass # count assertion
|
329
405
|
return e
|
330
|
-
rescue Minitest::Skip
|
406
|
+
rescue Minitest::Assertion # incl Skip & UnexpectedError
|
331
407
|
# don't count assertion
|
332
408
|
raise
|
333
409
|
rescue SignalException, SystemExit
|
@@ -413,6 +489,10 @@ module Minitest
|
|
413
489
|
end
|
414
490
|
|
415
491
|
assert caught, message(msg) { default }
|
492
|
+
rescue Assertion
|
493
|
+
raise
|
494
|
+
rescue => e
|
495
|
+
raise UnexpectedError, e
|
416
496
|
end
|
417
497
|
|
418
498
|
##
|
@@ -485,6 +565,11 @@ module Minitest
|
|
485
565
|
captured_stderr.unlink
|
486
566
|
$stdout.reopen orig_stdout
|
487
567
|
$stderr.reopen orig_stderr
|
568
|
+
|
569
|
+
orig_stdout.close
|
570
|
+
orig_stderr.close
|
571
|
+
captured_stdout.close
|
572
|
+
captured_stderr.close
|
488
573
|
end
|
489
574
|
end
|
490
575
|
end
|
@@ -504,7 +589,16 @@ module Minitest
|
|
504
589
|
end
|
505
590
|
|
506
591
|
##
|
507
|
-
# Fails
|
592
|
+
# Fails after a given date (in the local time zone). This allows
|
593
|
+
# you to put time-bombs in your tests if you need to keep
|
594
|
+
# something around until a later date lest you forget about it.
|
595
|
+
|
596
|
+
def fail_after y,m,d,msg
|
597
|
+
flunk msg if Time.now > Time.local(y, m, d)
|
598
|
+
end
|
599
|
+
|
600
|
+
##
|
601
|
+
# Fails with +msg+.
|
508
602
|
|
509
603
|
def flunk msg = nil
|
510
604
|
msg ||= "Epic Fail!"
|
@@ -638,6 +732,14 @@ module Minitest
|
|
638
732
|
refute o1.__send__(op, o2), msg
|
639
733
|
end
|
640
734
|
|
735
|
+
##
|
736
|
+
# Fails if +path+ exists.
|
737
|
+
|
738
|
+
def refute_path_exists path, msg = nil
|
739
|
+
msg = message(msg) { "Expected path '#{path}' to not exist" }
|
740
|
+
refute File.exist?(path), msg
|
741
|
+
end
|
742
|
+
|
641
743
|
##
|
642
744
|
# For testing with predicates.
|
643
745
|
#
|
@@ -683,6 +785,18 @@ module Minitest
|
|
683
785
|
raise Minitest::Skip, msg, bt
|
684
786
|
end
|
685
787
|
|
788
|
+
##
|
789
|
+
# Skips the current run until a given date (in the local time
|
790
|
+
# zone). This allows you to put some fixes on hold until a later
|
791
|
+
# date, but still holds you accountable and prevents you from
|
792
|
+
# forgetting it.
|
793
|
+
|
794
|
+
def skip_until y,m,d,msg
|
795
|
+
skip msg if Time.now < Time.local(y, m, d)
|
796
|
+
where = caller.first.split(/:/, 3).first(2).join ":"
|
797
|
+
warn "Stale skip_until %p at %s" % [msg, where]
|
798
|
+
end
|
799
|
+
|
686
800
|
##
|
687
801
|
# Was this testcase skipped? Meant for #teardown.
|
688
802
|
|