+
DfjM R t ^ RIt^ RIt^ RIt^ RIt^ RIHt ^ RIH t H
t
^ RI H t ^ RI
Ht ^ RIHtHtHtHt ^ RIHtHtHt ^ RIHt ^ R IHt ! R
R 4 t ! R R
4 t ! R R] ]P: 4 t ! R R] ]P> 4 t ! R R]4 t! ! R R]!]P: 4 t" ! R R]!]P> 4 t# ! R R]4 t$ ! R R]$]P: 4 t% ! R R ]$]P> 4 t& ! R R ]4 t' ! R R!]']P: 4 t( ! R" R#]']P> 4 t) ! R$ R%]4 t* ! R& R']*]P: 4 t+ ! R( R)]*]P> 4 t, ! R* R+]4 t- ! R, R-]-]P: 4 t. ! R. R/]-]P> 4 t/ ! R0 R1]P: 4 t0 ! R2 R34 t1 ! R4 R5]1]P: 4 t2 ! R6 R7]1]P> 4 t3 ! R8 R9]]P> 4 t4 ! R: R;4 t5 ! R< R=]5]P: 4 t6 ! R> R?]5]P: 4 t7 ! R@ RA]P: 4 t8 ! RB RC4 t9 ! RD RE]9]P: 4 t: ! RF RG]9]P> 4 t; ! RH RI4 t< ! RJ RK]<]P: 4 t= ! RL RM]<]P> 4 t> ! RN RO4 t? ! RP RQ]?]P: 4 t@ ! RR RS]?]P> 4 tA ! RT RU4 tB ! RV RW]B]P: 4 tC ! RX RY]B]P> 4 tD ! RZ R[4 tE ! R\ R]]E]P: 4 tF ! R^ R_]E]P> 4 tG ! R` Ra]P: 4 tHR# )ba
Tests for the behaviour of unit tests.
Many tests in this module follow a simple pattern. A mixin is defined which
includes test methods for a certain feature. The mixin is inherited from twice,
once by a class also inheriting from SynchronousTestCase and once from a class
inheriting from TestCase. These two subclasses are named like
I{SynchronousFooTests} and I{AsynchronousFooTests}, where I{Foo} is related to
the name of the mixin. Sometimes the mixin is defined in another module, along
with the synchronous subclass. The mixin is imported into this module to define
the asynchronous subclass.
This pattern allows the same tests to be applied to the two base test case
classes trial provides, ensuring their behavior is the same.
Most new tests should be added in this pattern. Tests for functionality which
is intentionally only provided by TestCase, not SynchronousTestCase, is excepted
of course.
N)StringIO)deferreactor)_PYPY)namedAny)reporterrunnerunittestutil) _clearSuite _ForceGarbageCollectionDecorator
_iterateTests) erroneous)SuppressionMixinc 6 a ] tR t^,t o RtR tR tR tRtV t R# )ResultsTestMixinz?
Provide useful APIs for test cases that are about test cases.
c \ P ! 4 V n V P P V4 V n \
P ! 4 V n R# )z\
Load tests from the given test case class and create a new reporter to
use for running it.
N)pyunit
TestLoaderloaderloadTestsFromTestCasesuiter
TestResultselfr s &&?/usr/lib/python3/dist-packages/twisted/trial/test/test_tests.py loadSuiteResultsTestMixin.loadSuite1 s:
'') [[66u=
++-
c < V P V P P 4 4 V P V P P . 4 V P V P P
. 4 V P V P P . 4 R# )z
test the setup
N)
assertTruer
wasSuccessful assertEqualerrorsfailuresskipsr s &r
test_setUpResultsTestMixin.test_setUp: sk
3356 --r2 //4 ,,b1r c V P V P P 4 V4 V P V P 4 V P V P P V4 R# )z*
Asserts that the test count is plausible
N)r" r countTestCasesr testsRun)r numTestss &&r assertCount ResultsTestMixin.assertCountC sK
224h?
4==! //:r )r r r N)
__name__
__module__ __qualname____firstlineno____doc__r r' r- __static_attributes____classdictcell__
__classdict__s @r r r , s .2; ;r r c H a ] tR t^Lt o RtR tR tR tR tR t R t
Rt V t R # )
SuccessMixinzT
Tests for the reporting of successful tests in L{twisted.trial.unittest.TestCase}.
c : \ P ! 4 V n R#
Setup our test case
N)r r resultr& s &r setUpSuccessMixin.setUpQ s ))+ r c R# )z)
A successful test, used by other tests.
N r& s &r test_successful SuccessMixin.test_successfulW s r c V V P VP ^4 V P VP . 4 V P VP . 4 V P VP . 4 V P VP
. 4 V P VP . 4 R# )zL
Utility function -- assert there is one success and the state is
plausible
N)r" successesr$ r# expectedFailuresunexpectedSuccessesr% r testr= s &&&r assertSuccessful SuccessMixin.assertSuccessful\ s
))1- "- + 00"5 33R8 r*r c V P R4 pVP V P 4 V P WP 4 R# )zl
Test that when a successful test is run, it is reported as a success,
and not as any other kind of result.
rB N __class__runr= rJ r rI s & r test_successfulIsReported&SuccessMixin.test_successfulIsReportedh s5
~~ /0 dKK0r c V P 4 pVP V P 4 V P WP 4 R# )zb
The test case type can be instantiated with no arguments, run, and
reported as being successful.
NrM rP s & r test_defaultIsSuccessful%SuccessMixin.test_defaultIsSuccessfulq s2
~~ dKK0r c V P R4 p\ P ! V4 pVP V P 4 V P WP 4 ?\ P ! 4 V P V! 4 R4 R# )z6
Test that no reference is kept on a successful test.
rB N) rN weakrefrefrO r= rJ gccollectassertIdentical)r rI rX s & r test_noReference SuccessMixin.test_noReferencez sa ~~ /0kk$ dKK0
SUD)r )r= N)
r/ r0 r1 r2 r3 r> rB rJ rQ rT r\ r4 r5 r6 s @r r9 r9 L s- ,
+11
*
*r r9 c ] tR t^tRtRtR# )SynchronousSuccessTestsF
Tests for the reporting of successful tests in the synchronous case.
rA Nr/ r0 r1 r2 r3 r4 rA r r r_ r_ r r_ c ] tR t^tRtRtR# )AsynchronousSuccessTestsr` rA Nra rA r r rd rd rb r rd c H a ] tR t^t o RtR tR tR tR tR t R t
Rt V t R # )
SkipMethodsMixinzR
Tests for the reporting of skipping tests in L{twisted.trial.unittest.TestCase}.
c < V P V P 4 R# r; )r Skippingr& s &r r> SkipMethodsMixin.setUp s
t}}%r c ( V P ^4 R# )z$
Assert that there are three tests.
Nr- r& s &r
test_counting SkipMethodsMixin.test_counting
r c V P V P 4 V P V P P 4 4 V P V P P
. 4 V P V P P . 4 V P \ V P P 4 ^4 V P V P P ^ 4 R# )z
Running a suite in which all methods are individually set to skip
produces a successful result with no recorded errors or failures, all
the skipped methods recorded as skips, and no methods recorded as
successes.
N
r r r r! r" r# r$ lenr% rE r& s &r test_results SkipMethodsMixin.test_results
4==!
3356 --r2 //4 T]] 0 0115 00!4r c V P V P 4 V P V P 4 V P V P P 4 4 V P
V P P . 4 V P
V P P . 4 V P
\ V P P 4 ^4 V P
V P P ^ 4 R# )z
Running a suite in which all methods are skipped by C{setUp} raising
L{SkipTest} produces a successful result with no recorded errors or
failures, all skipped methods recorded as skips, and no methods recorded
as successes.
N) r
SkippingSetUpr r r r! r" r# r$ rq r% rE r& s &r r' SkipMethodsMixin.test_setUp s
t))*
4==!
3356 --r2 //4 T]] 0 0115 00!4r c V P V P 4 RpV P P F: w r#V P VP 4 \ V4 R \
V4 4 K< R# )z
Test that reasons work
test_N)r r r% r" shortDescriptionrq str)r prefixrI reasons & r test_reasons SkipMethodsMixin.test_reasons sW
4==! MM / /LD T 2 2 4S[] CS[ Q 0r c | V P V P 4 V P V P 4 V P V P P
.4 pV P
^\ V4 4 V P
\ V^ , R, 4 V P
RV^ , R, 4 R# )zW
If a test method raises L{SkipTest} with no reason, a deprecation
warning is emitted.
categoryzSDo not raise unittest.SkipTest with no arguments! Give a reason for skipping tests!messageN) r DeprecatedReasonlessSkipr r
flushWarningstest_1r" rq DeprecationWarning)r warningss & r test_deprecatedSkipWithoutReason1SkipMethodsMixin.test_deprecatedSkipWithoutReason s
t445
4==!%%t'D'D'K'K&LM CM* +Xa[-DE
" QK "
r rA N)
r/ r0 r1 r2 r3 r> rl rr r' r~ r r4 r5 r6 s @r rf rf s. & 5
5 R
r rf c J ] tR t^tRt]! R4 t]! R4 t]! R4 tRt R# )SynchronousSkipMethodTestsz|
Tests for the reporting of skipping tests in the synchronous case.
See: L{twisted.trial.test.test_tests.SkipMethodsMixin}
z/twisted.trial.test.skipping.SynchronousSkippingz4twisted.trial.test.skipping.SynchronousSkippingSetUpz?twisted.trial.test.skipping.SynchronousDeprecatedReasonlessSkiprA N
r/ r0 r1 r2 r3 r rh rv r r4 rA r r r r s- IJH STM 'I r r c J ] tR t^tRt]! R4 t]! R4 t]! R4 tRt R# )AsynchronousSkipMethodTestsz}
Tests for the reporting of skipping tests in the asynchronous case.
See: L{twisted.trial.test.test_tests.SkipMethodsMixin}
z0twisted.trial.test.skipping.AsynchronousSkippingz5twisted.trial.test.skipping.AsynchronousSkippingSetUpz@twisted.trial.test.skipping.AsynchronousDeprecatedReasonlessSkiprA Nr rA r r r r s- JKH TUM 'J r r c B a ] tR t^t o RtR tR tR tR tR t Rt
V t R# ) SkipClassesMixinzI
Test the class skipping features of L{twisted.trial.unittest.TestCase}.
c ^ V P V P 4 RV P n R# )r< FN)r SkippedClass _setUpRanr& s &r r> SkipClassesMixin.setUp s$
t(()&+#r c ( V P ^4 R# )z@
Skipped test methods still contribute to the total test count.
Nrk r& s &r rl SkipClassesMixin.test_counting rn r c V P V P 4 V P V P P 4 R# )z@
The C{setUp} method is not called if the class is set to skip.
N)r r assertFalser r r& s &r
test_setUpRan SkipClassesMixin.test_setUpRan
s.
4==! **445r c V P V P 4 V P V P P 4 4 V P V P P
. 4 V P V P P . 4 V P \ V P P 4 ^4 V P V P P ^ 4 R# )z
Skipped test methods don't cause C{wasSuccessful} to return C{False},
nor do they contribute to the C{errors} or C{failures} of the reporter,
or to the count of successes. They do, however, add elements to the
reporter's C{skips} list.
Nrp r& s &r rr SkipClassesMixin.test_results rt r c V P V P 4 . ROpV P P UUu. uF w r#VNK pppV P W4 R# u uppi )zm
Test methods which raise L{unittest.SkipTest} or have their C{skip}
attribute set to something are skipped.
N)classskip2r r )r r r% r" )r expectedReasonsrI r} reasonsGivens & r r~ SkipClassesMixin.test_reasons sO
4==!>37==3F3FG3F<43F G 7 Hs
A rA N) r/ r0 r1 r2 r3 r> rl r rr r~ r4 r5 r6 s @r r r s( , 6 5 8 8r r c * ] tR tRtRt]! R4 tRtR# )SynchronousSkipClassTestsi+ zs
Test the class skipping features in the synchronous case.
See: L{twisted.trial.test.test_tests.SkipClassesMixin}
z3twisted.trial.test.skipping.SynchronousSkippedClassrA Nr/ r0 r1 r2 r3 r r r4 rA r r r r + s QRLr r c * ] tR tRtRt]! R4 tRtR# )AsynchronousSkipClassTestsi5 zt
Test the class skipping features in the asynchronous case.
See: L{twisted.trial.test.test_tests.SkipClassesMixin}
z4twisted.trial.test.skipping.AsynchronousSkippedClassrA Nr rA r r r r 5 s RSLr r c N a ] tR tRt o RtR tR tR tR tR t R t
R t R
t V t
R # ) TodoMixini? zj
Tests for the individual test method I{expected failure} features of
L{twisted.trial.unittest.TestCase}.
c < V P V P 4 R# r; )r Todor& s &r r> TodoMixin.setUpE s
tyy!r c ( V P ^4 R# )z)
Ensure that we've got three test cases.
Nrk r& s &r rl TodoMixin.test_countingK rn r c z V P V P 4 V P V P P 4 4 V P V P P
. 4 V P V P P . 4 V P V P P . 4 V P \ V P P 4 ^4 V P \ V P P 4 ^4 V P V P P ^ 4 R# )a
Running a suite in which all methods are individually marked as expected
to fail produces a successful result with no recorded errors, failures,
or skips, all methods which fail and were expected to fail recorded as
C{expectedFailures}, and all methods which pass but which were expected
to fail recorded as C{unexpectedSuccesses}. Additionally, no tests are
recorded as successes.
N r r r r! r" r# r$ r% rq rF rG rE r& s &r rr TodoMixin.test_resultsQ
4==!
3356 --r2 //4 ,,b1 T]] ; ; >?C 00!4r c V P V P 4 RR.pV P P UUUu. uF w r#qDP NK ppppV P W4 R# u upppi )5
Ensure that expected failures are handled properly.
todo1todo2Nr r rF r} r" r r terr s & r test_expectedFailures TodoMixin.test_expectedFailuresc sX
4==!"G,04
0N0NO0NWQ10N O 7 P A(c V P V P 4 R.pV P P UUu. uF w r#VP NK pppV P W4 R# u uppi ).
Ensure that unexpected successes are caught.
todo3Nr r rG r} r" r r r r r s & r test_unexpectedSuccesses"TodoMixin.test_unexpectedSuccessesl sU
4==!")-1]]-N-NO-NTQ-N O 7 Ps A%c V P V P 4 V P V P 4 V P V P P 4 4 V P
\ V P P 4 ^4 V P
V P P . 4 V P
V P P . 4 V P
\ V P P 4 ^ 4 V P
\ V P P 4 ^ 4 V P
V P P ^ 4 R# )zd
C{setUp} is excluded from the failure expectation defined by a C{todo}
attribute on a test method.
N)r SetUpTodor r r r! r" rq r# r$ r% rF rG rE r& s &r test_expectedSetUpFailure#TodoMixin.test_expectedSetUpFailureu s
t~~&
4==! 4467 T]] 1 12A6 //4 ,,b1 T]] ; ; >?C 00!4r c V P V P 4 V P V P 4 V P V P P 4 4 V P
\ V P P 4 ^4 V P
V P P . 4 V P
V P P . 4 V P
\ V P P 4 ^ 4 V P
\ V P P 4 ^4 V P
V P P ^ 4 R# )zg
C{tearDown} is excluded from the failure expectation defined by a C{todo}
attribute on a test method.
N)r TearDownTodor r r r! r" rq r# r$ r% rF rG rE r& s &r test_expectedTearDownFailure&TodoMixin.test_expectedTearDownFailure s
t(()
4==! 4467 T]] 1 12A6 //4 ,,b1 T]] ; ; >?C 00!4r rA N)r/ r0 r1 r2 r3 r> rl rr r r r r r4 r5 r6 s @r r r ? s2
" 5$88
5 5 5r r c J ] tR tRtRt]! R4 t]! R4 t]! R4 tRt R# )SynchronousTodoTestsi zl
Test the class skipping features in the synchronous case.
See: L{twisted.trial.test.test_tests.TodoMixin}
z+twisted.trial.test.skipping.SynchronousTodoz0twisted.trial.test.skipping.SynchronousSetUpTodoz3twisted.trial.test.skipping.SynchronousTearDownTodorA N
r/ r0 r1 r2 r3 r r r r r4 rA r r r r s* A BDKLI QRLr r c J ] tR tRtRt]! R4 t]! R4 t]! R4 tRt R# )AsynchronousTodoTestsi zm
Test the class skipping features in the asynchronous case.
See: L{twisted.trial.test.test_tests.TodoMixin}
z,twisted.trial.test.skipping.AsynchronousTodoz1twisted.trial.test.skipping.AsynchronousSetUpTodoz4twisted.trial.test.skipping.AsynchronousTearDownTodorA Nr rA r r r r s* B CDLMI RSLr r c B a ] tR tRt o RtR tR tR tR tR t Rt
V t R # )
ClassTodoMixini z^
Tests for the class-wide I{expected failure} features of
L{twisted.trial.unittest.TestCase}.
c < V P V P 4 R# r; )r TodoClassr& s &r r> ClassTodoMixin.setUp s
t~~&r c ( V P ^4 R# )z(
Ensure that we've got four test cases.
Nrk r& s &r rl ClassTodoMixin.test_counting rn r c z V P V P 4 V P V P P 4 4 V P V P P
. 4 V P V P P . 4 V P V P P . 4 V P \ V P P 4 ^4 V P \ V P P 4 ^4 V P V P P ^ 4 R# )av
Running a suite in which an entire class is marked as expected to fail
produces a successful result with no recorded errors, failures, or
skips, all methods which fail and were expected to fail recorded as
C{expectedFailures}, and all methods which pass but which were expected
to fail recorded as C{unexpectedSuccesses}. Additionally, no tests are
recorded as successes.
Nr r& s &r rr ClassTodoMixin.test_results r r c V P V P 4 RR.pV P P UUUu. uF w r#qDP NK ppppV P W4 R# u upppi )r methodr Nr r s & r r $ClassTodoMixin.test_expectedFailures sX
4==!#W-04
0N0NO0NWQ10N O 7 Pr c V P V P 4 RR.pV P P UUu. uF w r#VP NK pppV P W4 R# u uppi )r r r Nr r s & r r 'ClassTodoMixin.test_unexpectedSuccesses sX
4==!#W--1]]-N-NO-NTQ-N O 7 Ps A&rA N r/ r0 r1 r2 r3 r> rl rr r r r4 r5 r6 s @r r r s(
' 5$88 8r r c * ] tR tRtRt]! R4 tRtR# )SynchronousClassTodoTestsi z
Tests for the class-wide I{expected failure} features in the synchronous case.
See: L{twisted.trial.test.test_tests.ClassTodoMixin}
z0twisted.trial.test.skipping.SynchronousTodoClassrA Nr/ r0 r1 r2 r3 r r r4 rA r r r r s KLIr r c * ] tR tRtRt]! R4 tRtR# )AsynchronousClassTodoTestsi z
Tests for the class-wide I{expected failure} features in the asynchronous case.
See: L{twisted.trial.test.test_tests.ClassTodoMixin}
z1twisted.trial.test.skipping.AsynchronousTodoClassrA Nr rA r r r r s LMIr r c B a ] tR tRt o RtR tR tR tR tR t Rt
V t R # )
StrictTodoMixini z
Tests for the I{expected failure} features of
L{twisted.trial.unittest.TestCase} in which the exact failure which is
expected is indicated.
c < V P V P 4 R# r; )r
StrictTodor& s &r r> StrictTodoMixin.setUp s
t'r c ( V P ^4 R# )z#
Assert there are seven test cases
Nrk r& s &r rl StrictTodoMixin.test_counting rn r c V P V P 4 V P V P P 4 4 V P \ V P P 4 ^4 V P \ V P P 4 ^4 V P \ V P P 4 ^4 V P \ V P P 4 ^4 V P V P P ^ 4 V P V P P . 4 R# )z
A test method which is marked as expected to fail with a particular
exception is only counted as an expected failure if it does fail with
that exception, not if it fails with some other exception.
N) r r r r! r" rq r# r$ rF rG rE r% r& s &r rr StrictTodoMixin.test_results
s
4==! 4467 T]] 1 12A6 T]] 3 34a8 T]] ; ; >?C 00!4 ,,b1r c V P V P 4 . ROpV P P UUUu. uF w r#qDP NK ppppV P W4 R# u upppi )r N)r r todo5r )r r r r r
reasonsGottens & r r %StrictTodoMixin.test_expectedFailures sS
4==!515 1O1OP1OgaA1O
P 8 Qr c V P V P 4 \ .R3.pV P P UUu. uF w r#VP VP
3NK pppV P
W4 R# u uppi )r todo7N)r r RuntimeErrorrG r# r} r" )r r r r r s & r r (StrictTodoMixin.test_unexpectedSuccesses% sn
4==! )NG45-1]]-N-N
-NTQQXXqxx -N
8
s #A8rA Nr r6 s @r r r s( (
2 9 9 9r r c * ] tR tRtRt]! R4 tRtR# )SynchronousStrictTodoTestsi1 z
Tests for the expected failure case when the exact failure that is expected
is indicated in the synchronous case
See: L{twisted.trial.test.test_tests.StrictTodoMixin}
z1twisted.trial.test.skipping.SynchronousStrictTodorA Nr/ r0 r1 r2 r3 r r r4 rA r r r r 1 s MNJr r c * ] tR tRtRt]! R4 tRtR# )AsynchronousStrictTodoTestsi< z
Tests for the expected failure case when the exact failure that is expected
is indicated in the asynchronous case
See: L{twisted.trial.test.test_tests.StrictTodoMixin}
z2twisted.trial.test.skipping.AsynchronousStrictTodorA Nr rA r r r r < s NOJr r c 6 a ] tR tRt o RtR tR tR tRtV t R# )ReactorCleanupTestsiG zW
Tests for cleanup and reporting of reactor event sources left behind by test
methods.
c \ P ! \ 4 4 V n \ P
! 4 V n R# r; )r Reporterr r= r r r r& s &r r> ReactorCleanupTests.setUpM s( ''
3 '') r c V P P R4 pVP V P 4 V P V P P 4 4 V P
V P P ^4 V P P ^ , ^, pV P VP \ P 4 4 R# )zU
Trial reports a L{util.DirtyReactorAggregateError} if a test leaves
sockets behind.
z@twisted.trial.test.erroneous.SocketOpenTest.test_socketsLeftOpenN)
r
loadByNamerO r= r r! r" rE r# r checkr
DirtyReactorAggregateErrorr r failures & r test_leftoverSockets(ReactorCleanupTests.test_leftoverSocketsT s
&& N
$++ 2245
..2++$$Q'*
d&E&EFGr c \ P ! R4 pVP V P 4 V P V P P 4 4 V P P ^ , ^, pV P V P P ^ 4 V P VP \ P 4 4 R# )zr
Trial reports a L{util.DirtyReactorAggregateError} and fails the test
if a test leaves a L{DelayedCall} hanging.
test_leftoverPendingCallsN)
r r rO r= r r! r# r" rE r r r
r r s & r r -ReactorCleanupTests.test_leftoverPendingCallse s
--.IJ
$++ 2245++$$Q'* ..2
d&E&EFGr )r r= N)
r/ r0 r1 r2 r3 r> r r r4 r5 r6 s @r r r G s!
*H"
H
Hr r c < a ] tR tRt o RtR tR tR tR tRt V t
R# ) FixtureMixinir z:
Tests for fixture helper methods (e.g. setUp, tearDown).
c n \ P ! 4 V n \ P ! 4 V n R# r; )r r r r r r& s &r r> FixtureMixin.setUpw s$ !))+
'') r c V P P V P 4 pVP V P 4 V P \
V P P 4 ^ 8 4 V P V P P ^ , ^, P \ P 4 V P ^ V P P 4 R# )z?
When setUp fails, the error is recorded in the result object.
N)r r TestFailureInSetUprO r r rq r# assertIsInstancevaluer FoolishErrorr" rE r s & r test_brokenSetUp FixtureMixin.test_brokenSetUp~ s 11$2I2IJ
$-- DMM 0 01A56 dmm 2 21 5a 8 > > @V@VW DMM 3 34r c V P P V P 4 pVP V P 4 V P P
pV P
\ V4 ^ 8 4 V P V^ , ^, P \ P 4 V P ^ V P P 4 R# )zB
When tearDown fails, the error is recorded in the result object.
N)r r TestFailureInTearDownrO r r# r rq r r r r r" rE )r r r# s & r test_brokenTearDown FixtureMixin.test_brokenTearDown s 11$2L2LM
$-- %% F a( fQil 0 0)2H2HI DMM 3 34r c 8 V P P V P 4 p\ V4 ^ , pV P VP
4 VP
V P 4 V P P pV P \ V4 ^ 8 4 V P V^ , ^, P \ P 4 V P ^ V P P 4 V P VP
4 R# )z@
L{SynchronousTestCase.tearDown} runs when a test method fails.
N)r r TestFailureButTearDownRunslistr tornDownrO r r# r rq r r r r r" rE )r r caser# s & r test_tearDownRunsOnTestFailure+FixtureMixin.test_tearDownRunsOnTestFailure s 11$2Q2QRE{1~ '
$-- %% F a( fQil 0 0)2H2HI DMM 3 34
&r )r r N) r/ r0 r1 r2 r3 r> r r r! r4 r5 r6 s @r r r r s# *5 5' 'r r c J ] tR tRtRt]! R4 t]! R4 t]! R4 tRt R# )SynchronousFixtureTestsi zu
Tests for broken fixture helper methods in the synchronous case
See: L{twisted.trial.test.test_tests.FixtureMixin}
z:twisted.trial.test.erroneous.SynchronousTestFailureInSetUpz=twisted.trial.test.erroneous.SynchronousTestFailureInTearDownzBtwisted.trial.test.erroneous.SynchronousTestFailureButTearDownRunsrA N
r/ r0 r1 r2 r3 r r r r r4 rA r r r$ r$ s7 "D %G "*L" r r$ c J ] tR tRtRt]! R4 t]! R4 t]! R4 tRt R# )AsynchronousFixtureTestsi zv
Tests for broken fixture helper methods in the asynchronous case
See: L{twisted.trial.test.test_tests.FixtureMixin}
z;twisted.trial.test.erroneous.AsynchronousTestFailureInSetUpz>twisted.trial.test.erroneous.AsynchronousTestFailureInTearDownzCtwisted.trial.test.erroneous.AsynchronousTestFailureButTearDownRunsrA Nr% rA r r r' r' s7 "E %H "*M" r r' c Z ] tR tRtRt]! R4 t]! R4 t]! R4 t]! R4 t Rt
R# ) AsynchronousSuppressionTestsi z
Tests for the warning suppression features of
L{twisted.trial.unittest.TestCase}
See L{twisted.trial.test.test_suppression.SuppressionMixin}
z?twisted.trial.test.suppression.AsynchronousTestSetUpSuppressionzBtwisted.trial.test.suppression.AsynchronousTestTearDownSuppressionz:twisted.trial.test.suppression.AsynchronousTestSuppressionz;twisted.trial.test.suppression.AsynchronousTestSuppression2rA N) r/ r0 r1 r2 r3 r TestSetUpSuppressionTestTearDownSuppressionTestSuppressionTestSuppression2r4 rA r r r) r) sF $I 'L DO Er r) c f a ] tR tRt o Rt ! R R]P 4 tR tR t R t
R t R t V t
R
# ) GCMixini z
I provide a few mock tests that log setUp, tearDown, test execution and
garbage collection. I'm used to test whether gc.collect gets called.
c 6 a ] tR tRt o RtR tR tR tRtV t R# )GCMixin.BasicTesti z
Mock test to run.
c ( V P R4 R# )z
Mock setUp
r> N_logr& s &r r> GCMixin.BasicTest.setUp s
IIg r c ( V P R4 R# )z
Mock test case
rI Nr3 r& s &r test_fooGCMixin.BasicTest.test_foo s
IIf r c ( V P R4 R# )z
Mock tear tearDown
tearDownNr3 r& s &r r: GCMixin.BasicTest.tearDown s
IIj !r rA N)
r/ r0 r1 r2 r3 r> r7 r: r4 r5 r6 s @r BasicTestr1 s " "r r< c < V P P V4 R# )z
Log function
N)_collectCalledappend)r msgs &&r r4 GCMixin._log s
""3'r c ( V P R4 R# )zFake gc.collectrZ Nr3 r& s &r rZ GCMixin.collect s ) r c . V n V P V P n \ P V n V P \ n R# r; )r> r4 r< rY rZ _oldCollectr& s &r r>
GCMixin.setUp s3 ! "ii ::\\
r c 0 V P \ n R# z
Tear down the test
N)rE rY rZ r& s &r r: GCMixin.tearDown s %%
r )r> rE N)r/ r0 r1 r2 r3 r SynchronousTestCaser< r4 rZ r> r: r4 r5 r6 s @r r/ r/ s5
"H00 ".( "& &r r/ c * a ] tR tRt o RtR tRtV tR# ) GarbageCollectionDefaultTestsi 8
By default, tests should not force garbage collection.
c V P R4 p\ P ! 4 pVP V4 V P V P
. RO4 R# )rM r7 N)r> rI r: )r< r r rO r" r> rH s & r test_collectNotDefault4GarbageCollectionDefaultTests.test_collectNotDefault sC ~~j)$$& ,,.KLr rA N)r/ r0 r1 r2 r3 rO r4 r5 r6 s @r rL rL s M Mr rL c * a ] tR tRt o RtR tRtV tR# )GarbageCollectionTestsi% z%
Test that, when force GC, it works.
c \ P R4 p\ V4 p\ P ! 4 pVP V4 V P
V P . RO4 R# )z7
test gc.collect is called before and after each test.
r7 N)rZ r> rI r: rZ )rR r< r r r rO r" r> rH s & r test_collectCalled)GarbageCollectionTests.test_collectCalled* sR &//
;/5$$& !T
r rA N)r/ r0 r1 r2 r3 rT r4 r5 r6 s @r rR rR % s
r rR c h a ] tR tRt o RtR tR t]P ! ] R4 R 4 t
R t Rt V t
R # )
UnhandledDeferredTestsi7 zP
Test what happens when we have an unhandled deferred left around after
a test.
c z ^ RI Hp \ P ! 4 \ VP R4 4 V n R# )r< )weirdtest_unhandledDeferredN)twisted.trial.testrY rY disabler TestBleedingtest1)r rY s & r r> UnhandledDeferredTests.setUp= s- -
5 7 8
r c \ P ! 4 pV P V4 V P \ VP
4 ^R4 R# )zW
Forcing garbage collection should cause unhandled Deferreds to be
reported as errors.
z(Unhandled deferred passed without noticeN)r r r^ r" rq r# )r r= s & r test_isReported&UnhandledDeferredTests.test_isReportedI s=
$$&
6
#M
r z GC works differently on PyPy.c " \ P ! 4 pV P V4 V P 4 \ \
P 4 pV P V^ R4 V P 4 pV P \ V4 ^ R4 R# )z
Forcing garbage collection in the test should mean that there are
no unreachable cycles immediately after the test completes.
z unreachable cycle still existedz Errors logged after gc.collectN)r r r^ flushLoggedErrorsrq rY garbager" )r r= nxs & r test_doesntBleed'UnhandledDeferredTests.test_doesntBleedT sq $$&
6
O A @A " " $ Q$DEr c z \ P ! 4 \ P ! 4 V P 4 R# rH )rY rZ enablerd r& s &r r: UnhandledDeferredTests.tearDowne s"
r )r^ N)r/ r0 r1 r2 r3 r> ra r skipIfr rh r: r4 r5 r6 s @r rW rW 7 s@
]]59:F ;F ! !r rW c ` a a ] tR tRt oRtV 3R ltR tR tR tR t R t
R t R
t R t
VtV ;t# ) AddCleanupMixinin z)
Test the addCleanup method of TestCase.
c < \ SV ` 4 \ P ! 4 V n V P 4 V n R# r; )superr> r r r=
AddCleanuprI )r rN s &r r> AddCleanupMixin.setUps s,
))+ OO% r c J V P P V P n V P P V P P R4 V P P V P 4 V P RR.V P P 4 R# )zA
Callables added with C{addCleanup} are run even if setUp fails.
foor> N) rI brokenSetUpr>
addCleanupr? rO r= r" logr& s &r !test_addCleanupCalledIfSetUpFails1AddCleanupMixin.test_addCleanupCalledIfSetUpFails{ sh ))// TYY - -u5
dkk" '5)499==9r c J V P P V P n V P P V P P R4 V P P V P 4 V P RR.V P P 4 R# )z
Callables added with C{addCleanup} are run even if setUp raises
L{SkipTest}. This allows test authors to reliably provide clean up
code using C{addCleanup}.
ru r> N) rI
skippingSetUpr> rw r? rO r= r" rx r& s &r !test_addCleanupCalledIfSetUpSkips1AddCleanupMixin.test_addCleanupCalledIfSetUpSkips sh ))11 TYY - -u5
dkk" '5)499==9r c ` V P P V P P R4 V P P V P P R4 V P P V P 4 V P . ROV P P 4 R# )zf
Callables added with C{addCleanup} should be called before C{tearDown}
in reverse order of addition.
ru barNr> runTestr ru r: rI rw r? rO r= r" rx r& s &r #test_addCleanupCalledInReverseOrder3AddCleanupMixin.test_addCleanupCalledInReverseOrder sm
TYY - -u5 TYY - -u5
dkk" G Wr c
V P P V P P R4 V P P V P 4 V P V P P
4 4 V P ^\ V P P 4 4 V P P w w rV P WP 4 V P VP 4 R4 R# )z
Errors raised in cleanup functions should be treated like errors in
C{tearDown}. They should be added as errors and fail the test. Skips,
todos and failures are all treated as errors.
ru N) rI rw failrO r= r r! r" rq r# getErrorMessager rI errors & r test_errorInCleanupIsCaptured-AddCleanupMixin.test_errorInCleanupIsCaptured s
TYY^^U3
dkk" 2245 C 2 2 34 ++,, $ yy) ..0%8r c h V P P V P P R4 V P P V P P R4 V P P V P
4 V P
. ROV P P 4 V P
^\ V P
P 4 4 V P
P w w rV P
WP 4 V P
VP 4 R4 R# )zY
If a cleanup raises an error then that does not stop the other
cleanups from being run.
ru r N)r> r ru r: ) rI rw r? r rO r= r" rx rq r# r r s & r &test_cleanupsContinueRunningAfterError6AddCleanupMixin.test_cleanupsContinueRunningAfterError s
TYY - -u5 TYY^^U3
dkk" @$))--P C 2 2 34 ++,, $ yy) ..0%8r c V P P V P P R4 V P P V P P R4 V P P V P 4 V P . ROV P P 4 V P ^\ V P P 4 4 V P P w w rw r4V P WP 4 V P W0P 4 V P VP 4 R4 V P VP 4 R4 R# )zU
If more than one cleanup fails, then the test should fail with more
than one error.
ru r N)r> r r: )
rI rw r rO r= r" rx rq r# r )r r^ error1test2error2s & r test_multipleErrorsReported+AddCleanupMixin.test_multipleErrorsReported s
TYY^^U3 TYY^^U3
dkk" 9499==I C 2 2 34-1[[-?-?* %/5 * * //159 //159r c aa . oV P P VV3R l4 RoV P P V P 4 RoV P P V P 4 V P SR.4 R# )z1
A function registered as a cleanup is run once.
c & < S P S4 # )N)r? )cleanupsstages r 6AddCleanupMixin.test_cleanupRunsOnce.. s X__U%;r firstsecondN)rI rw rO r= r" )r r r s &@@r test_cleanupRunsOnce$AddCleanupMixin.test_cleanupRunsOnce sc ;<
dkk"
dkk" G9-r )r= rI )r/ r0 r1 r2 r3 r> ry r} r r r r r r4 r5
__classcell__)rN r7 s @@r ro ro n s8 &: :X 9 9 :
.
.r ro c * ] tR tRtRt]! R4 tRtR# )SynchronousAddCleanupTestsi zw
Test the addCleanup method of TestCase in the synchronous case
See: L{twisted.trial.test.test_tests.AddCleanupMixin}
z1twisted.trial.test.skipping.SynchronousAddCleanuprA N)r/ r0 r1 r2 r3 r rr r4 rA r r r r s MNJr r c : a ] tR tRt o Rt]! R4 tR tRtV t R# )AsynchronousAddCleanupTestsi zx
Test the addCleanup method of TestCase in the asynchronous case
See: L{twisted.trial.test.test_tests.AddCleanupMixin}
z2twisted.trial.test.skipping.AsynchronousAddCleanupc F a V 3R lpS P P S P P R4 S P P VR4 S P P S P 4 S P . ROS P P 4 R# )z
If an added callable returns a L{Deferred}, then the test should wait
until that L{Deferred} has fired before running the next cleanup
method.
c < \ P ! 4 p\ P ! ^ VP V 4 VP SP P 4 # ) )r Deferredr callLatercallback addCallbackrI r? )r dr s & r cleanupMAsynchronousAddCleanupTests.test_addCleanupWaitsForDeferreds..cleanup s> A aW 5==!1!12 2r ru r Nr r )r r s f r test_addCleanupWaitsForDeferreds#?@ ))%1G1GH
%%
!7!7!= >
? @
}7r c V P 4 p\ P ! V\ P 4 p\ P ! V\ P 4 pV P V\ P ! V4 4 R# )zq
Calling L{decorate} on a test suite with already-decorated tests
decorates all of the tests in the suite again.
Nr )r rI r redecoratedTests & r test_decorateDecoratedSuite.TestDecoratorMixin.test_decorateDecoratedSuite sZ
}} ))$0F0FG
"++M8;Q;QR ox/E/Em/TUr c V P 4 p\ P ! V.4 p\ P ! V\ P
4 pV P
V\ P ! \ P
! V4 .4 4 R# )zq
Tests can be in non-standard suites. L{decorate} preserves the
non-standard suites when it decorates the tests.
N)r r DestructiveTestSuiter r r r )r rI r decorateds & r test_decoratePreservesSuite.TestDecoratorMixin.test_decoratePreservesSuite se
}}++TF3 %%eX-C-CD v22H4J4J44P3QR
r rA N)r/ r0 r1 r2 r3 r r r r r r r r r r r r4 r5 r6 s @r r r 1 sI 5 B : :"K
)( 8 V
r r c 2 ] tR tRtRt]P tRtR# ) SynchronousTestDecoratorTestsi zz
Tests for our test decoration features in the synchronous case.
See L{twisted.trial.test.test_tests.TestDecoratorMixin}
rA Nr rA r r r r ++Hr r c 2 ] tR tRtRt]P tRtR# ) AsynchronousTestDecoratorTestsi z{
Tests for our test decoration features in the asynchronous case.
See L{twisted.trial.test.test_tests.TestDecoratorMixin}
rA Nr rA r r r r Hr r c H a ] tR tRt o RtR tR tR tR tR t R t
R t V t R
# ) MonkeyPatchMixini z>
Tests for the patch() helper method in L{unittest.TestCase}.
c n RV n RV n V P V n V P 4 V n R# )r< originalpatchedN)
originalValue patchedValue
objectToPatchr rI r& s &r r> MonkeyPatchMixin.setUp s/ ( % ! / /MMO r c V P P V RV P 4 V P V P V P 4 R# )zQ
Calling C{patch()} on a test monkey patches the specified object and
attribute.
r N)rI patchr r" r r& s &r
test_patchMonkeyPatchMixin.test_patch s:
ot/@/@A ++T->->?r c V P P V RV P 4 V P P \ P
! 4 4 V P
V P V P 4 R# )z_
Any monkey patches introduced by a test using C{patch()} are reverted
after the test has run.
r N) rI r r rO r r r" r r r& s &r test_patchRestoredAfterRun+MonkeyPatchMixin.test_patchRestoredAfterRun sS
ot/@/@A
h'')* ++T-?-?@r c V P P V RV P 4 pVP 4 V P V P
V P 4 R# )z
C{patch()} return a L{monkey.MonkeyPatcher} object that can be used to
restore the original values before the end of the test.
r N)rI r r restorer" r r r r s & r test_revertDuringTest&MonkeyPatchMixin.test_revertDuringTest sE
ot7H7HI
++T-?-?@r c V P P V RV P 4 pVP 4 VP 4 V P V P
V P 4 R# )zY
The returned L{monkey.MonkeyPatcher} object can re-apply the patch
during the test run.
r N)rI r r r r" r r s & r test_revertAndRepatch&MonkeyPatchMixin.test_revertAndRepatch sN
ot7H7HI
++T->->?r c V P P V RV P 4 V P V P V P 4 V P P V RR4 V P V P R4 V P P \ P ! 4 4 V P V P V P 4 R# )zG
Successive patches are applied and reverted just like a single patch.
r z second valueN) rI r r r" r rO r r r r& s &r test_successivePatches'MonkeyPatchMixin.test_successivePatches s
ot/@/@A ++T->->? o~> ++^<
h'')* ++T-?-?@r )r r r rI N)
r/ r0 r1 r2 r3 r> r r r r r# r4 r5 r6 s @r r r s3 $@AA@ A Ar r c 2 ] tR tRtRt]P tRtR# )SynchronousMonkeyPatchTestsi zu
Tests for the patch() helper method in the synchronous case.
See L{twisted.trial.test.test_tests.MonkeyPatchMixin}
rA Nr rA r r r& r& r r r& c 2 ] tR tRtRt]P tRtR# ) AsynchronousMonkeyPatchTestsi( zv
Tests for the patch() helper method in the asynchronous case.
See L{twisted.trial.test.test_tests.MonkeyPatchMixin}
rA Nr rA r r r( r( ( r r r( c < a ] tR tRt o RtR tR tR tR tRt V t
R# ) IterateTestsMixini2 zQ
L{_iterateTests} returns a list of all test cases in a test suite or test
case.
c p V P 4 pV P V.\ \ V4 4 4 R# )zR
L{_iterateTests} on a single test case returns a list containing that
test case.
N)r r" r r
rP s & r test_iterateTestCase&IterateTestsMixin.test_iterateTestCase8 s+
}} $mD&9!:;r c V P 4 p\ P ! V.4 pV P V.\ \ V4 4 4 R# )zm
L{_iterateTests} on a test suite that contains a single test case
returns a list containing that test case.
Nr r r r" r r
r rI r s & r test_iterateSingletonTestSuite0IterateTestsMixin.test_iterateSingletonTestSuite@ s=
}} $( $mE&:!;.GeneratorTestCasei{ z'
A fake TestCase for testing purposes.
c 3 8 " V P R4 Rx R# 5izD
A method which is also a generator function, for testing
purposes.
z this should never be reachedNr r& s &r test_generatorcTrialGeneratorFunctionTests.test_errorOnGeneratorFunction..GeneratorTestCase.test_generator
89 rA Nr/ r0 r1 r2 r3 rE r4 r5 r6 s @r GeneratorTestCaserA {
r rJ rE z GeneratorTestCase.test_generatorz+GeneratorTestCase testMethod=test_generator4is a generator function and therefore will never runN) r r r r rO r" rq r$ r# assertInr args)r rJ testCaser= s & r test_errorOnGeneratorFunction9TrialGeneratorFunctionTests.test_errorOnGeneratorFunctionu s 1 1 %%56$$& V V__-q1 V]]+Q/
.
a0@0C0I0I0N0Nq0Q
9 MM! Q % % * *1 -
B MM! Q % % * *1 -
r c ! R R\ P 4 pV! R4 p\ P ! 4 pVP V4 V P \
VP 4 ^ 4 V P \
VP 4 ^4 V P RVP ^ , ^, P P ^ , 4 V P RVP ^ , ^, P P ^ , 4 V P RVP ^ , ^, P P ^ , 4 R# )z
In a SynchronousTestCase, a test method which is a generator function
is reported as an error, as such a method will never run assertions.
c * a ] tR tRt o RtR tRtV tR# )rTrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunction..GeneratorSynchronousTestCasei z2
A fake SynchronousTestCase for testing purposes.
c 3 8 " V P R4 Rx R# 5irC rD r& s &r rE ځTrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunction..GeneratorSynchronousTestCase.test_generator rG rH rA NrI r6 s @r GeneratorSynchronousTestCaserT rK r rW rE z+GeneratorSynchronousTestCase.test_generatorz6GeneratorSynchronousTestCase testMethod=test_generatorrL N) r rJ r r rO r" rq r$ r# rM r rN )r rW rO r= s & r 0test_synchronousTestCaseErrorOnGeneratorFunctionLTrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunction s 8+G+G 00@A$$& V V__-q1 V]]+Q/
9 MM! Q % % * *1 -
D MM! Q % % * *1 -
B MM! Q % % * *1 -
r rA N) r/ r0 r1 r2 r3 rP rX r4 r5 r6 s @r r> r> p s "
H#
#
r r> )Ir3 rY r r r rW ior twisted.internetr r twisted.python.compatr twisted.python.reflectr
twisted.trialr r r
twisted.trial._asyncrunnerr r r
r[ r #twisted.trial.test.test_suppressionr r r9 rJ r_ r rd rf r r r r r r r r r r r r r r r r r$ r' r) r/ rL rR rW ro r r r r r r r r r r& r( r* r: r< r> rA r r ra sl *
+ ' + : :
) @ ; ;@8* 8*vlH,H,H |X->-> F
' F
R !183O3O "2H4E4E 08' 08fS 0(2N2N ST!183D3D TU5 U5p S9h&B&B S TIx'8'8 T48% 48nM0L0L MN 1B1B N49& 49nO (2N2N OP/83D3D P(H(66 (HV0' 0'flH,H,H $|X->-> $#3X5F5F ,4& 4&n MGX-I-I M
Wh&B&B
$4!X 9 9 4!nd. d.NO (2N2N OX/83D3D X6 4 4B,$68T8T ,!%79J9J !X
X
v,$68T8T ,!%79J9J !;A ;A|,"2H4P4P ,!#3X5F5F !%C %CP,#4h6R6R ,!$5x7H7H !L
(">"> L
r