← Back to branch summary

~testing-cabal/ubuntu/oneiric/subunit/daily-build-packaging

« back to all changes in this revision

Viewing changes to README

  • Committer: Jelmer Vernooij
  • Date: 2011-05-02 20:55:32 UTC
  • mfrom: (135.1.6 upstream)
  • Revision ID: jelmer@samba.org-20110502205532-butnpa8myx2s2mwi
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
142
142
when outside a DETAILS region unexpected lines which are not interpreted by
143
143
the parser - they should be forwarded unaltered.
144
144
 
145
 
test|testing|test:|testing: test label
146
 
success|success:|successful|successful: test label
147
 
success|success:|successful|successful: test label DETAILS
148
 
failure: test label
149
 
failure: test label DETAILS
150
 
error: test label
151
 
error: test label DETAILS
152
 
skip[:] test label
153
 
skip[:] test label DETAILS
154
 
xfail[:] test label
155
 
xfail[:] test label DETAILS
 
145
test|testing|test:|testing: test LABEL
 
146
success|success:|successful|successful: test LABEL
 
147
success|success:|successful|successful: test LABEL DETAILS
 
148
failure: test LABEL
 
149
failure: test LABEL DETAILS
 
150
error: test LABEL
 
151
error: test LABEL DETAILS
 
152
skip[:] test LABEL
 
153
skip[:] test LABEL DETAILS
 
154
xfail[:] test LABEL
 
155
xfail[:] test LABEL DETAILS
 
156
uxsuccess[:] test LABEL
 
157
uxsuccess[:] test LABEL DETAILS
156
158
progress: [+|-]X
157
159
progress: push
158
160
progress: pop
159
161
tags: [-]TAG ...
160
162
time: YYYY-MM-DD HH:MM:SSZ
161
163
 
 
164
LABEL: UTF8*
162
165
DETAILS ::= BRACKETED | MULTIPART
163
166
BRACKETED ::= '[' CR UTF8-lines ']' CR
164
167
MULTIPART ::= '[ multipart' CR PART* ']' CR
200
203
The time directive acts as a clock event - it sets the time for all future
201
204
events. The value should be a valid ISO8601 time.
202
205
 
203
 
The skip result is used to indicate a test that was found by the runner but not
204
 
fully executed due to some policy or dependency issue. This is represented in
205
 
python using the addSkip interface that testtools
206
 
(https://edge.launchpad.net/testtools) defines. When communicating with a non
207
 
skip aware test result, the test is reported as an error.
208
 
The xfail result is used to indicate a test that was expected to fail failing
209
 
in the expected manner. As this is a normal condition for such tests it is
210
 
represented as a successful test in Python.
211
 
In future, skip and xfail results will be represented semantically in Python,
212
 
but some discussion is underway on the right way to do this.
 
206
The skip, xfail and uxsuccess outcomes are not supported by all testing
 
207
environments. In Python the testttools (https://launchpad.net/testtools)
 
208
library is used to translate these automatically if an older Python version
 
209
that does not support them is in use. See the testtools documentation for the
 
210
translation policy.
 
211
 
 
212
skip is used to indicate a test was discovered but not executed. xfail is used
 
213
to indicate a test that errored in some expected fashion (also know as "TODO"
 
214
tests in some frameworks). uxsuccess is used to indicate and unexpected success
 
215
where a test though to be failing actually passes. It is complementary to
 
216
xfail.