Class: Test::Unit::TestSuite
- Inherits:
-
Object
- Object
- Test::Unit::TestSuite
- Defined in:
- lib/test/unit/testsuite.rb,
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.
-
#passed? ⇒ Boolean
-
#run(result, &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.
26 27 28 29 30 31 32 33 34 35 |
# File 'lib/test/unit/testsuite.rb', line 26 def initialize(name="Unnamed TestSuite", test_case=nil) @name = name @tests = [] @test_case = test_case @n_tests = 0 @priority = 0 @start_time = nil @elapsed_time = nil @passed = true end |
Instance Attribute Details
#elapsed_time ⇒ Object (readonly)
Returns the value of attribute elapsed_time
14 15 16 |
# File 'lib/test/unit/testsuite.rb', line 14 def elapsed_time @elapsed_time end |
#name ⇒ Object (readonly)
Returns the value of attribute name
14 15 16 |
# File 'lib/test/unit/testsuite.rb', line 14 def name @name end |
#priority ⇒ Object
Test suite that has higher priority is ran prior to test suites that have lower priority.
18 19 20 |
# File 'lib/test/unit/testsuite.rb', line 18 def priority @priority end |
#start_time ⇒ Object (readonly)
Returns the value of attribute start_time
14 15 16 |
# File 'lib/test/unit/testsuite.rb', line 14 def start_time @start_time end |
#test_case ⇒ Object (readonly)
Returns the value of attribute test_case
14 15 16 |
# File 'lib/test/unit/testsuite.rb', line 14 def test_case @test_case end |
#tests ⇒ Object (readonly)
Returns the value of attribute tests
14 15 16 |
# File 'lib/test/unit/testsuite.rb', line 14 def tests @tests end |
Instance Method Details
#<<(test) ⇒ Object
Adds the test to the suite.
60 61 62 63 |
# File 'lib/test/unit/testsuite.rb', line 60 def <<(test) @tests << test self end |
#==(other) ⇒ Object
It’s handy to be able to compare TestSuite instances.
93 94 95 96 97 |
# File 'lib/test/unit/testsuite.rb', line 93 def ==(other) return false unless(other.kind_of?(self.class)) return false unless(@name == other.name) @tests == other.tests end |
#delete(test) ⇒ Object
65 66 67 |
# File 'lib/test/unit/testsuite.rb', line 65 def delete(test) @tests.delete(test) end |
#delete_tests(tests) ⇒ Object
69 70 71 |
# File 'lib/test/unit/testsuite.rb', line 69 def delete_tests(tests) @tests -= tests end |
#empty? ⇒ Boolean
82 83 84 |
# File 'lib/test/unit/testsuite.rb', line 82 def empty? size.zero? end |
#passed? ⇒ Boolean
99 100 101 |
# File 'lib/test/unit/testsuite.rb', line 99 def passed? @passed end |
#run(result, &progress_block) ⇒ Object
Runs the tests and/or suites contained in this TestSuite.
39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
# File 'lib/test/unit/testsuite.rb', line 39 def run(result, &progress_block) @start_time = Time.now yield(STARTED, name) yield(STARTED_OBJECT, self) run_startup(result) while test = @tests.shift @n_tests += test.size run_test(test, result, &progress_block) @passed = false unless test.passed? end ensure begin run_shutdown(result) ensure @elapsed_time = Time.now - @start_time yield(FINISHED, name) yield(FINISHED_OBJECT, self) 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.
76 77 78 79 80 |
# File 'lib/test/unit/testsuite.rb', line 76 def size total_size = @n_tests @tests.each { |test| total_size += test.size } total_size end |
#to_s ⇒ Object
Overridden to return the name given the suite at creation.
88 89 90 |
# File 'lib/test/unit/testsuite.rb', line 88 def to_s @name end |