1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
|
#!/usr/bin/env python
# Copyright (C) 2010 Google Inc. All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are
# met:
#
# * Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# * Redistributions in binary form must reproduce the above
# copyright notice, this list of conditions and the following disclaimer
# in the documentation and/or other materials provided with the
# distribution.
# * Neither the name of Google Inc. nor the names of its
# contributors may be used to endorse or promote products derived from
# this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
"""Classes for failures that occur during tests."""
import test_expectations
import cPickle
# FIXME: This is backwards. Each TestFailure subclass should know what
# test_expectation type it corresponds too. Then this method just
# collects them all from the failure list and returns the worst one.
def determine_result_type(failure_list):
"""Takes a set of test_failures and returns which result type best fits
the list of failures. "Best fits" means we use the worst type of failure.
Returns:
one of the test_expectations result types - PASS, TEXT, CRASH, etc."""
if not failure_list or len(failure_list) == 0:
return test_expectations.PASS
failure_types = [type(f) for f in failure_list]
if FailureCrash in failure_types:
return test_expectations.CRASH
elif FailureTimeout in failure_types:
return test_expectations.TIMEOUT
elif (FailureMissingResult in failure_types or
FailureMissingImage in failure_types or
FailureMissingImageHash in failure_types or
FailureMissingAudio in failure_types):
return test_expectations.MISSING
else:
is_text_failure = FailureTextMismatch in failure_types
is_image_failure = (FailureImageHashIncorrect in failure_types or
FailureImageHashMismatch in failure_types)
is_reftest_failure = (FailureReftestMismatch in failure_types or
FailureReftestMismatchDidNotOccur in failure_types)
is_audio_failure = (FailureAudioMismatch in failure_types)
if is_text_failure and is_image_failure:
return test_expectations.IMAGE_PLUS_TEXT
elif is_text_failure:
return test_expectations.TEXT
elif is_image_failure or is_reftest_failure:
return test_expectations.IMAGE
elif is_audio_failure:
return test_expectations.AUDIO
else:
raise ValueError("unclassifiable set of failures: "
+ str(failure_types))
class TestFailure(object):
"""Abstract base class that defines the failure interface."""
@staticmethod
def loads(s):
"""Creates a TestFailure object from the specified string."""
return cPickle.loads(s)
@staticmethod
def message():
"""Returns a string describing the failure in more detail."""
raise NotImplementedError
def __eq__(self, other):
return self.__class__.__name__ == other.__class__.__name__
def __ne__(self, other):
return self.__class__.__name__ != other.__class__.__name__
def __hash__(self):
return hash(self.__class__.__name__)
def dumps(self):
"""Returns the string/JSON representation of a TestFailure."""
return cPickle.dumps(self)
def should_kill_dump_render_tree(self):
"""Returns True if we should kill DumpRenderTree before the next
test."""
return False
class FailureTimeout(TestFailure):
"""Test timed out. We also want to restart DumpRenderTree if this
happens."""
def __init__(self, is_reftest=False):
self.is_reftest = is_reftest
@staticmethod
def message():
return "Test timed out"
def should_kill_dump_render_tree(self):
return True
class FailureCrash(TestFailure):
"""DumpRenderTree crashed."""
def __init__(self, is_reftest=False):
self.is_reftest = is_reftest
@staticmethod
def message():
return "DumpRenderTree crashed"
def should_kill_dump_render_tree(self):
return True
class FailureMissingResult(TestFailure):
"""Expected result was missing."""
@staticmethod
def message():
return "No expected results found"
class FailureTextMismatch(TestFailure):
"""Text diff output failed."""
@staticmethod
def message():
return "Text diff mismatch"
class FailureMissingImageHash(TestFailure):
"""Actual result hash was missing."""
# Chrome doesn't know to display a .checksum file as text, so don't bother
# putting in a link to the actual result.
@staticmethod
def message():
return "No expected image hash found"
class FailureMissingImage(TestFailure):
"""Actual result image was missing."""
@staticmethod
def message():
return "No expected image found"
class FailureImageHashMismatch(TestFailure):
"""Image hashes didn't match."""
@staticmethod
def message():
# We call this a simple image mismatch to avoid confusion, since
# we link to the PNGs rather than the checksums.
return "Image mismatch"
class FailureImageHashIncorrect(TestFailure):
"""Actual result hash is incorrect."""
# Chrome doesn't know to display a .checksum file as text, so don't bother
# putting in a link to the actual result.
@staticmethod
def message():
return "Images match, expected image hash incorrect. "
class FailureReftestMismatch(TestFailure):
"""The result didn't match the reference rendering."""
@staticmethod
def message():
return "Mismatch with reference"
class FailureReftestMismatchDidNotOccur(TestFailure):
"""Unexpected match between the result and the reference rendering."""
@staticmethod
def message():
return "Mismatch with the reference did not occur"
class FailureMissingAudio(TestFailure):
"""Actual result image was missing."""
@staticmethod
def message():
return "No expected audio found"
class FailureAudioMismatch(TestFailure):
"""Audio files didn't match."""
@staticmethod
def message():
return "Audio mismatch"
# Convenient collection of all failure classes for anything that might
# need to enumerate over them all.
ALL_FAILURE_CLASSES = (FailureTimeout, FailureCrash, FailureMissingResult,
FailureTextMismatch, FailureMissingImageHash,
FailureMissingImage, FailureImageHashMismatch,
FailureImageHashIncorrect, FailureReftestMismatch,
FailureReftestMismatchDidNotOccur)
|
