Class: Test::Unit::TestResult

Inherits:
Object
  • Object
show all
Includes:
NullResultContainerInitializer, TestResultErrorSupport, TestResultFailureSupport, TestResultNotificationSupport, TestResultOmissionSupport, TestResultPendingSupport, Util::Observable
Defined in:
lib/test/unit/testresult.rb

Overview

Collects Test::Unit::Failure and Test::Unit::Error so that they can be displayed to the user. To this end, observers can be added to it, allowing the dynamic updating of, say, a UI.

Constant Summary collapse

FINISHED = 
name + "::FINISHED"
CHANGED = 
name + "::CHANGED"
PASS_ASSERTION = 
name + "::PASS_ASSERTION"
FAULT = 
name + "::FAULT"

Constants included from Util::Observable

Util::Observable::NOTHING

Instance Attribute Summary collapse

Attributes included from TestResultNotificationSupport

#notifications

Attributes included from TestResultOmissionSupport

#omissions

Attributes included from TestResultPendingSupport

#pendings

Attributes included from TestResultErrorSupport

#errors

Attributes included from TestResultFailureSupport

#failures

Instance Method Summary collapse

Methods included from TestResultNotificationSupport

#add_notification, #notification_count

Methods included from TestResultOmissionSupport

#add_omission, #omission_count

Methods included from TestResultPendingSupport

#add_pending, #pending_count

Methods included from TestResultErrorSupport

#add_error, #error_count, #error_occurred?

Methods included from TestResultFailureSupport

#add_failure, #failure_count, #failure_occurred?

Methods included from Util::Observable

#add_listener, #notify_listeners, #remove_listener

Constructor Details

#initialize ⇒ TestResult

Constructs a new, empty TestResult.



44
45
46
47
48
49
50
51
 
# File 'lib/test/unit/testresult.rb', line 44

def initialize
  @run_count, @pass_count, @assertion_count = 0, 0, 0
  @summary_generators = []
  @problem_checkers = []
  @faults = []
  @stop_tag = nil
  initialize_containers
end

Instance Attribute Details

#assertion_count ⇒ Object (readonly)

Returns the value of attribute assertion_count.



39
40
41
 
# File 'lib/test/unit/testresult.rb', line 39

def assertion_count
  @assertion_count
end

#faults ⇒ Object (readonly)

Returns the value of attribute faults.



39
40
41
 
# File 'lib/test/unit/testresult.rb', line 39

def faults
  @faults
end

#pass_count ⇒ Object (readonly)

Returns the value of attribute pass_count.



39
40
41
 
# File 'lib/test/unit/testresult.rb', line 39

def pass_count
  @pass_count
end

#run_count ⇒ Object (readonly)

Returns the value of attribute run_count.



39
40
41
 
# File 'lib/test/unit/testresult.rb', line 39

def run_count
  @run_count
end

#stop_tag ⇒ Object

Returns the value of attribute stop_tag.



41
42
43
 
# File 'lib/test/unit/testresult.rb', line 41

def stop_tag
  @stop_tag
end

Instance Method Details

#add_assertion ⇒ Object

Records an individual assertion.



65
66
67
68
69
 
# File 'lib/test/unit/testresult.rb', line 65

def add_assertion
  @assertion_count += 1
  notify_listeners(PASS_ASSERTION, self)
  notify_changed
end

#add_pass ⇒ Object 



60
61
62
 
# File 'lib/test/unit/testresult.rb', line 60

def add_pass
  @pass_count += 1
end

#add_run(result = self) ⇒ Object

Records a test run.



54
55
56
57
58
 
# File 'lib/test/unit/testresult.rb', line 54

def add_run(result=self)
  @run_count += 1
  notify_listeners(FINISHED, result)
  notify_changed
end

#pass_percentage ⇒ Object 



112
113
114
115
116
117
118
119
 
# File 'lib/test/unit/testresult.rb', line 112

def pass_percentage
  n_tests = @run_count - omission_count
  if n_tests.zero?
    0
  else
    100.0 * (@pass_count / n_tests.to_f)
  end
end

#passed? ⇒ Boolean

Returns whether or not this TestResult represents successful completion.

Returns:

  • (Boolean) 


108
109
110
 
# File 'lib/test/unit/testresult.rb', line 108

def passed?
  @problem_checkers.all? {|checker| not __send__(checker)}
end

#status ⇒ Object

Returnes a string that shows result status.



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/test/unit/testresult.rb', line 80

def status
  if passed?
    if pending_count > 0
      "pending"
    elsif omission_count > 0
      "omission"
    elsif notification_count > 0
      "notification"
    else
      "pass"
    end
  elsif error_count > 0
    "error"
  elsif failure_count > 0
    "failure"
  end
end

#stop ⇒ Object 



98
99
100
 
# File 'lib/test/unit/testresult.rb', line 98

def stop
  throw @stop_tag
end

#summary ⇒ Object

Returns a string contain the recorded runs, assertions, failures and errors in this TestResult.



73
74
75
76
77
 
# File 'lib/test/unit/testresult.rb', line 73

def summary
  ["#{run_count} tests",
   "#{assertion_count} assertions",
   *@summary_generators.collect {|generator| __send__(generator)}].join(", ")
end

#to_s ⇒ Object 



102
103
104
 
# File 'lib/test/unit/testresult.rb', line 102

def to_s
  summary
end