+ Dfjc<a0t$Rt^RIHt^RIt^RIt^RIHtHt^RI H t ^RIH t ^RI H t Ht^RIHt^RIHt^R IHtHt^R IHtHtHt] !R 4t.tR ]R &] !]P:4!RR]44tR#)z4 Things likely to be used by writers of unit tests. ) annotationsN)CallableList) implementer) ParamSpec)deferutils)_T)failure)itrialutil)FailTestSkipTestSynchronousTestCase_Pz List[None]_wait_is_runningca]tRt^!tRtRV3RlltRRlt]tRtRt Rt Rt R t R t ]PR 4tR tR tRtRtRtRtRV3RlltRtRt]3RltRtV;t#)TestCasea A unit test. The atom of the unit testing universe. This class extends L{SynchronousTestCase} which extends C{unittest.TestCase} from the standard library. The main feature is the ability to return C{Deferred}s from tests and fixture methods and to have the suite wait for those C{Deferred}s to fire. Also provides new assertions such as L{assertFailure}. @ivar timeout: A real number of seconds. If set, the test will raise an error if it takes longer than C{timeout} seconds. If not set, util.DEFAULT_TIMEOUT_DURATION is used. c L<\SV`V4^RIHpW nRVnR#)ag Construct an asynchronous test case for C{methodName}. @param methodName: The name of a method on C{self}. This method should be a unit test. That is, it should be a short method that calls some of the assert* methods. If C{methodName} is unspecified, L{SynchronousTestCase.runTest} will be used as the test method. This is mostly useful for testing Trial. reactorFN)super__init__twisted.internetr_twistedPrivateScheduler_twistedPrivateNeedsTearDown)self methodNamer __class__s&& :/usr/lib/python3/dist-packages/twisted/trial/_asynctest.pyrTestCase.__init__1s) $ -)0%-2)c$V^8dQhRRRRRR/#)deferredzdefer.Deferred[_T]expectedFailuresztype[BaseException]return)formats"r __annotate__TestCase.__annotate__Is$//*/?R/ /r!c BaaV3RlpVV3RlpVPW44#)z Fail if C{deferred} does not errback with one of C{expectedFailures}. Returns the original Deferred with callbacks added. You will need to return this Deferred from your test case. c.<SPRV: 24h)z$did not catch an error, instead got )failureException)ignorers&r_cb#TestCase.assertFailure.._cbRs ''6vjA r!c<VP!S!'d VP#RPS\V44pSP V4h)z Expected: {!r} Got: {})checkvaluer(strr-)r outputr%rs& r_eb#TestCase.assertFailure.._ebWsI}}.//}}$5<<$c'l++F33r!) addCallbacks)rr$r%r/r6sf&j r assertFailureTestCase.assertFailureIs    4$$S..r!c aaaaaSP4oVVVV3Rlp\P!V\P!\ R74p\ P!V4'd1\RPV44p\P!V4#\P!\PSP4V4pSPP!SWF4oVP#V3Rl4V#)c<\P!S: RS RS R24p\P!V4pVP V4R# \P dxSP P4RSnSP4pTe-TPT4'dSPSY#4R#SPST4R#i;i)z (z) still running at z secsTN) r TimeoutErrorr FailureerrbackAlreadyCalledErrorrcrash _timedOutgetTodoexpectedaddExpectedFailureaddError)deftodofuncDescriptionresultrtimeouts& r onTimeout TestCase._run..onTimeoutgs""("_--@ OA"A - ! ++ ---335!%||~# a(8(8--dA<OOD!, -sA A C-CCCcategoryz9{!r} is a generator function and therefore will never runch<SP4;'dSP4;'gT#N)activecancel)xcalls&rTestCase._run..s$DKKM;;dkkm@@q@r!) getTimeoutrsuppressWarningsr suppressDeprecationWarninginspectisgeneratorfunction TypeErrorr(rfail maybeDeferredrunWithWarningsSuppressed _getSuppressr callLateraddBoth) rfuncrKrLrNexcrGrWrMs f&ff @@r_run TestCase._runds//# - -,** t}}.@A   & &t , ,KRRSWXC::c? "     + +T->->-@$ ,,66w M @Ar!c &VP!V/VB#rS)run)rargskwargss&*,r__call__TestCase.__call__sxx(((r!c "VPV4GRjxL VPV4GRjxL VP'dVPV4GRjxL R#R#LML6 TPT4GRjxL i;iL+ TP'dTPT4GRjxL ii;i5irS)_deferSetUpAndRun_deferRunCleanupsr_deferTearDownrrLs&&r _deferSetUpTestCase._deferSetUps 2 5,,V444,,V444000))&1111 54d,,V4442000))&1111s|B>A+A'A+B A)B B> B>B B>'A+)B +BBBB B> 'B;3B64B;;B>c \"VPVPRV4GRjxL RTn TP\YP4TPT4GRjxL TP4e"TPYP44R#RTnR#L \d7pTPYP TPT44Rp?R#Rp?i\ dBpTP T\P!T44TP4Rp?R#Rp?i\d2pTP T\P!T44Rp?R#Rp?ii;iEL \d-pTP#\P!T4T4hRp?ii;i5i)zS Execute the setUp and run part of a test. Teardown and cleanups are not executed. setUpNT)riryraddSkip_getSkipReasonKeyboardInterruptrFr r>stop BaseExceptionrgetattr_testMethodNamerCaddUnexpectedSuccess_passed_ebDeferTestMethodrrLrHs&& rrrTestCase._deferSetUpAndRuns@ ))DJJ8 8 8-1) ))223T5I5I6  ||~)++D,,.A# + 9  NN4!4!4TZZ!C D    OOD'//!"4 5 KKM   OOD'//!"4 5      # #GOOA$6 ?  sF, B'B%B'F,3E2$E/%5E2F,E2#F,%B'' E,2+C#F,# E,0E,16D-'F,- E,:E,;&E'!F,'E,,F,/E22 F)='F$$F))F,c  JVP4pVe,VPV4'dVPWV4R#VPVP\ 4'dVP W4R#VP\4'd$VPW4VP4R#VP\4'dAVPWP\WP4VP44R#VPW4R#rS)rCrDrEr2r-r addFailurer|rFr}rrzr{rrr3)rrIrLrJs&&& rrTestCase._ebDeferTestMethods||~   a 0 0  % %dt 4 WWT**H 5 5   d & WW& ' ' OOD $ KKM WWX   NN))'$8L8L*MqwwW  OOD $r!c "VPVPRV4GRjxL R#L \dIpTPT\P !T44TP 4RTnRp?R#Rp?i\d9pTPT\P !T44RTnRp?R#Rp?ii;i5i)tearDownNF) rirr|rFr r>r}rr~rs&& rrtTestCase._deferTearDowns !))DMM:v> > >  ! OOD'//!"4 5 KKM DLL ! OOD'//!"4 5 DLL !sNC -+-C- C=A;5C; CC -B<6C<CCc# aaa".p\VP4^8dJVPP4woooVPVVV3RlRSP 2V4xKcVFpVPW4RVn K R# \ d)TP \P!44Ki;i5i)zN Run any scheduled cleanups and report errors (if any) to the result. object. c<S!S/SB#rSr')rmrgrnsrrX,TestCase._deferRunCleanups..sD$1&1r!zcleanup function FN) len _cleanupspopri__name__ Exceptionappendr r>rFr)rrLfailuresrIrmrgrns&& @@@rrsTestCase._deferRunCleanupss $..!A%!%!3!3!5 D$ 3ii1' 7A OOD $ DL 3 12 3s);C(B)%C/C=CCCc \P!W4P4pV'gRVnTPP4FpTP Y4RTnK TP4TP4TP'dTPT4R#R# \d0TP T\ P!44RTnLi;i)FN) r _JanitorpostCaseCleanuprr~rFr r> _observer getErrorsflushLoggedErrors_removeObserver addSuccess)rrLcleanerrors&& r_cleanUpTestCase._cleanUps !MM$/??AE$ ^^--/E OOD ( DL0    <<<   d #  ! OOD'//"3 4 DL !s3B557C/.C/c \P!W4P4R# \d*TP T\ P !44R#i;irS)r rpostClassCleanupr~rFr r>rus&&r _classCleanUpTestCase._classCleanUps@ 5 MM$ ' 8 8 : 5 OOD'//"3 4 5s$(0AAc aaVV3RlpV#)z} Create a method which wraps the reactor method C{name}. The new method issues a deprecation warning and calls the original. c<\P!RS: RS: R2^\R7SPS,!V/VB#)zreactor.z8 cannot be used inside unit tests. In the future, using z7 will fail the test and may crash or hang the test run.) stacklevelrQ)warningswarnr]_reactorMethods)akwnamers*,r_&TestCase._makeReactorMethod.._s@ MM26t=+  ''-q7B7 7r!r')rrrsff r_makeReactorMethodTestCase._makeReactorMethods  8r!c /VnRF6p\W4VPV&\WVPV44K8 R#)z Deprecate C{iterate}, C{crash} and C{stop} on C{reactor}. That is, each method is wrapped in a function that issues a deprecation warning, then calls the original. @param reactor: The Twisted reactor. N)rAiterater})rrsetattrr)rrrs&& r_deprecateReactorTestCase._deprecateReactors@ "0D)0)?D  & G4#:#:4#@ A1r!c rVPP4Fwr#\WV4K /VnR#)zu Restore the deprecated reactor methods. Undoes what L{_deprecateReactor} did. @param reactor: The Twisted reactor. N)ritemsr)rrrmethods&& r_undeprecateReactorTestCase._undeprecateReactors1!00668LD G6 *9!r!c ^RIHpVPV4RVn\P P VPV44pVPV4VPV4VPV4VPV4R# TPT4TPT4i;i TPT4i;i)z Really run C{setUp}, the test method, and C{tearDown}. Any of these may return L{defer.Deferred}s. After they complete, do some reactor cleanup. @param result: A L{TestResult} object. rFN) rrrrBrDeferred fromCoroutinerv_waitrrr)rrLrrGs&& r_runFixturesAndTestTestCase._runFixturesAndTest)s - w' .,,T-=-=f-EFA + 1  f%""6*  $ $W - f%""6*  $ $W -s#.B=B "B=$B::B==Cc(V^8dQhRRRRRRRR/#) r#rIzCallable[_P, object]rmz_P.argsrnz _P.kwargsr&Noner')r(s"rr)r*@s, 6 6% 6.5 6AJ 6  6r!c ,<\SV`!V.VO5/VB#)a: Extend the base cleanup feature with support for cleanup functions which return Deferreds. If the function C{f} returns a Deferred, C{TestCase} will wait until the Deferred has fired before proceeding to the next function. If the function takes more than C{timeout} settings, then the test will raise an error. )r addCleanup)rrIrmrnrs&&*,rrTestCase.addCleanup@sw!!5d5f55r!c "VP4#rS)rd)rs&r getSuppressTestCase.getSuppressOs  ""r!c \P!VPR\P4p\ V4# \ \ 3d0\P!R\R7\Pu#i;i)a5 Returns the timeout value set on this test. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with a C{timeout} attribute, returns that. Returns L{util.DEFAULT_TIMEOUT_DURATION} if it cannot find anything. See L{TestCase} docstring for more details. rMz)'timeout' attribute needs to be a number.rP) r acquireAttribute_parentsDEFAULT_TIMEOUT_DURATIONfloat ValueErrorr`rrr])rrMs& rrZTestCase.getTimeoutRsj'' MM9d&C&C  1> !I& 1 MM;FX 00 0 1s ==A=<A=c aaV'd \R4h^RIHo.oV3RlpVV3Rlp\P!V\ P !R\R74pV3Rlp\P!V\ P !R\R74pVPR4VPV4S'dRoVP4R#VPV4VSn SP4S= S'gVP'dRoVP4R#\4h S= i;i RoTP4i;i) zATake a Deferred that only ever callbacks. Block until it happens.z_wait is not reentrantrc6<SeSPV4R#R#rS)r)anyresultss&rrTestCase._wait..appendrs"s##r!c4<SeSP4R#R#rSrA)ignrrs&rrATestCase._wait..crashvs" #r!zreactor\.crash cannot be used.*)messagerQc(<SP4R#rSrrsrr}TestCase._wait..stops MMOr!N) RuntimeErrorrrrr[r r\r]rrfrr}rlrBr|)rrGrunningrrAr}rrs&&& @@rrTestCase._waitis 78 8, $ &&  MM:EW   %%  MM:EW   t$  IIf <G KKM= IIe GL ! L $..."G KKM$% %-L0G KKMs6%D>D>,D7< D>D>- D>7D;;D>>E)rrrBrr)runTest)r __module__ __qualname____firstlineno____doc__rr9failUnlessFailurerirorvrrrrtrinlineCallbacksrsrrrrrrrrrZrr__static_attributes__ __classcell__)rs@rrr!s 20/2&&P)2>% ! !!*$ 5 $ B ".. 6 6#1. 0GGr!r)__conditional_annotations__r __future__rr^rtypingrrzope.interfacerrrrrtwisted.internet.deferr twisted.pythonr twisted.trialr r twisted.trial._synctestr rrrr__annotations__ ITestCaser)rs@rrsq #!& *%"&KKt_!*! V  N"NNr!