Class: Test::Unit::TestSuite
- Inherits:
-
Object
- Object
- Test::Unit::TestSuite
- Defined in:
- lib/test/unit/testsuite.rb
Overview
A collection of tests which can be #run.
Note: It is easy to confuse a TestSuite instance with something that has a static suite method; I know because I have trouble keeping them straight. Think of something that has a suite method as simply providing a way to get a meaningful TestSuite instance.
Constant Summary collapse
- STARTED =
name + "::STARTED"
- STARTED_OBJECT =
name + "::STARTED::OBJECT"
- FINISHED =
name + "::FINISHED"
- FINISHED_OBJECT =
name + "::FINISHED::OBJECT"
Instance Attribute Summary collapse
-
#elapsed_time ⇒ Object
readonly
Returns the value of attribute elapsed_time.
-
#name ⇒ Object
readonly
Returns the value of attribute name.
-
#priority ⇒ Object
Test suite that has higher priority is ran prior to test suites that have lower priority.
-
#start_time ⇒ Object
readonly
Returns the value of attribute start_time.
-
#test_case ⇒ Object
readonly
Returns the value of attribute test_case.
-
#tests ⇒ Object
readonly
Returns the value of attribute tests.
Instance Method Summary collapse
-
#<<(test) ⇒ Object
Adds the test to the suite.
-
#==(other) ⇒ Object
It’s handy to be able to compare TestSuite instances.
- #delete(test) ⇒ Object
- #delete_tests(tests) ⇒ Object
- #empty? ⇒ Boolean
-
#initialize(name = "Unnamed TestSuite", test_case = nil) ⇒ TestSuite
constructor
Creates a new TestSuite with the given name.
- #parallel_safe? ⇒ Boolean
- #passed? ⇒ Boolean
-
#run(result, runner_class: nil, &progress_block) ⇒ Object
Runs the tests and/or suites contained in this TestSuite.
-
#size ⇒ Object
Returns the rolled up number of tests in this suite; i.e.
-
#to_s ⇒ Object
Overridden to return the name given the suite at creation.
Constructor Details
#initialize(name = "Unnamed TestSuite", test_case = nil) ⇒ TestSuite
Creates a new TestSuite with the given name.
34 35 36 37 38 39 40 41 |
# File 'lib/test/unit/testsuite.rb', line 34 def initialize(name="Unnamed TestSuite", test_case=nil) @name = name @tests = [] @test_case = test_case @priority = 0 @start_time = nil @elapsed_time = nil end |
Instance Attribute Details
#elapsed_time ⇒ Object (readonly)
Returns the value of attribute elapsed_time.
22 23 24 |
# File 'lib/test/unit/testsuite.rb', line 22 def elapsed_time @elapsed_time end |
#name ⇒ Object (readonly)
Returns the value of attribute name.
22 23 24 |
# File 'lib/test/unit/testsuite.rb', line 22 def name @name end |
#priority ⇒ Object
Test suite that has higher priority is ran prior to test suites that have lower priority.
26 27 28 |
# File 'lib/test/unit/testsuite.rb', line 26 def priority @priority end |
#start_time ⇒ Object (readonly)
Returns the value of attribute start_time.
22 23 24 |
# File 'lib/test/unit/testsuite.rb', line 22 def start_time @start_time end |
#test_case ⇒ Object (readonly)
Returns the value of attribute test_case.
22 23 24 |
# File 'lib/test/unit/testsuite.rb', line 22 def test_case @test_case end |
#tests ⇒ Object (readonly)
Returns the value of attribute tests.
22 23 24 |
# File 'lib/test/unit/testsuite.rb', line 22 def tests @tests end |
Instance Method Details
#<<(test) ⇒ Object
Adds the test to the suite.
64 65 66 67 |
# File 'lib/test/unit/testsuite.rb', line 64 def <<(test) @tests << test self end |
#==(other) ⇒ Object
It’s handy to be able to compare TestSuite instances.
97 98 99 100 101 |
# File 'lib/test/unit/testsuite.rb', line 97 def ==(other) return false unless(other.kind_of?(self.class)) return false unless(@name == other.name) @tests == other.tests end |
#delete(test) ⇒ Object
69 70 71 |
# File 'lib/test/unit/testsuite.rb', line 69 def delete(test) @tests.delete(test) end |
#delete_tests(tests) ⇒ Object
73 74 75 |
# File 'lib/test/unit/testsuite.rb', line 73 def delete_tests(tests) @tests -= tests end |
#empty? ⇒ Boolean
86 87 88 |
# File 'lib/test/unit/testsuite.rb', line 86 def empty? size.zero? end |
#parallel_safe? ⇒ Boolean
43 44 45 46 |
# File 'lib/test/unit/testsuite.rb', line 43 def parallel_safe? return true if @test_case.nil? @test_case.parallel_safe? end |
#passed? ⇒ Boolean
103 104 105 |
# File 'lib/test/unit/testsuite.rb', line 103 def passed? @tests.all?(&:passed?) end |
#run(result, runner_class: nil, &progress_block) ⇒ Object
Runs the tests and/or suites contained in this TestSuite.
50 51 52 53 54 55 56 57 58 59 60 61 |
# File 'lib/test/unit/testsuite.rb', line 50 def run(result, runner_class: nil, &progress_block) runner_class ||= TestSuiteRunner runner_class.new(self).run(result) do |event, *args| case event when STARTED @start_time = Time.now when FINISHED @elapsed_time = Time.now - @start_time end yield(event, *args) end end |
#size ⇒ Object
Returns the rolled up number of tests in this suite; i.e. if the suite contains other suites, it counts the tests within those suites, not the suites themselves.
80 81 82 83 84 |
# File 'lib/test/unit/testsuite.rb', line 80 def size total_size = 0 @tests.each { |test| total_size += test.size } total_size end |
#to_s ⇒ Object
Overridden to return the name given the suite at creation.
92 93 94 |
# File 'lib/test/unit/testsuite.rb', line 92 def to_s @name end |