tf8UdZddlZddlZddlmZmZddlmZddlm Z ddl m Z m Z ddl mZddlmZmZdd lmZmZmZe d ZgZeded <eejGd d eZdS)zP Things likely to be used by writers of unit tests. Maintainer: Jonathan Lange N)CallableList) implementer) ParamSpec)deferutils)failure)itrialutil)FailTestSkipTestSynchronousTestCase_P_wait_is_runningceZdZdZdfd ZdZeZdZdZdZ dZ d Z d Z d Z d Zd ZejdZdZdZdZdZdZdZdeeefdejdejddffd ZdZdZ e!fdZ"xZ#S)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. runTestcJt|dS)a 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. N)super__init__)self methodName __class__s W/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/trial/_asynctest.pyrzTestCase.__init__1s# $$$$$cHfd}fd}|||S)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. c4d|)Nz$did not catch an error, instead got )failureException)ignorers r_cbz#TestCase.assertFailure.._cbDs&''AvAA rc|jr|jSdt|}|)Nz Expected: {!r} Got: {})checkvalueformatstrr)r outputexpectedFailuresrs r_ebz#TestCase.assertFailure.._ebIsSw}./ 4}$5<<$c'll++F333r) addCallbacks)rdeferredr'r r(s` ` r assertFailurezTestCase.assertFailure=sS       4 4 4 4 4 4$$S#...rc( ddlm  fd}tj|t jt}t}tj |r6td |}tj|Stjtj|} |||fd|S)Nrreactorctjddd}tj|} ||dS#tj$rzd_}|/| |r ||YdS |YdSwxYw)Nz (z) still running at z secsT) r TimeoutErrorr FailureerrbackAlreadyCalledErrorcrash _timedOutgetTodoexpectedaddExpectedFailureaddError) deftodorr.resultrtimeouts r onTimeoutz TestCase._run..onTimeout[s"JJZJJGJJJA""A - ! + - - - !%||~~# a(8(8#--dAt<<<<<<OOD!,,,,,, -sA A,C:CCcategoryz9{!r} is a generator function and therefore will never runcXrp|SN)activecancel)xcalls rzTestCase._run..s!DKKMM;dkkmm@qr)twisted.internetr. getTimeoutrsuppressWarningsr suppressDeprecationWarninggetattrinspectisgeneratorfunction TypeErrorr$rfail maybeDeferredrunWithWarningsSuppressed _getSuppress callLateraddBoth) rrr>r@methodexcr:rHr.r?s ``` @@@r_runz TestCase._runVs8,,,,,,//## - - - - - - - - -,* t}.@AAA  z**  &v . . #KRRC :c?? "    +T->->-@-@&    )Q77 @@@@AAArc|j|i|SrD)run)rargskwargss r__call__zTestCase.__call__stx((((rc||d|}||j|j|f|f|S)NsetUp callbackArgs errbackArgs)r[r)deferTestMethod _ebDeferSetUprignoredr>r:s r deferSetUpzTestCase.deferSetUpsM IIgv & &         rc@|jtr5||||j|jn?||||jtr|| d|SrD) r"r addSkip_getSkipReasonrbr#r9KeyboardInterruptstopdeferRunCleanupsrr r>s rrgzTestCase._ebDeferSetUps 7= " "  NN4!4!4TZ!O!O P P P P OOD' * * *w}.//  $$T6222rc||j|}||j|j|f|f||j|||j||S)Nrc)r[_testMethodNamer)_cbDeferTestMethod_ebDeferTestMethodrXrp deferTearDownrhs rrfzTestCase.deferTestMethods~ IId*F 3 3   #  #     $'000 $$f---rc|)|||nd|_|S)NT)r6addUnexpectedSuccess_passed)rrir>s rrtzTestCase._cbDeferTestMethods= <<>> %  ' 'dllnn = = = =DLrc r|}|.||r||||dS||jt r|||dS|tr,|||| dS|trD| || t||j|jdS|||dSrD)r6r7r8r"rr addFailurernr9ror rlrmrOrsr#)rr<r>r=s rruzTestCase._ebDeferTestMethods'||~~   a 0 0   % %dAt 4 4 4 4 4 WWT*H 5 5 %   dA & & & & & WW& ' ' % OOD! $ $ $ KKMMMMM WWX   % NNd))'$8L*M*MqwWW      OOD! $ $ $ $ $rch|d|}||j||S)NtearDown)r[ addErrback_ebDeferTearDownrhs rrvzTestCase.deferTearDowns1 IIj& ) ) T*F333rc||||jtr|d|_dSNF)r9r"rnroryrqs rrzTestCase._ebDeferTearDownsCg&&& 7=* + +  KKMMM rc#pKg}t|jdkrw|j\}}} ||i|Vn6#t$r)|t jYnwxYwt|jdkw|D]}|||d|_ dS)zf Run any scheduled cleanups and report errors (if any) to the result. object. rFN) len _cleanupspop Exceptionappendr r1r9ry)rrir>failuresfuncr^r_r<s rrpzTestCase.deferRunCleanupss $.!!A%%!%!3!3!5!5 D$ 3dD+F++++++ 3 3 3 1 122222 3 $.!!A%% ! !A OOD! $ $ $ DLL ! !s A0A98A9c tj||}|sd|_n>#t$r1||t jd|_YnwxYw|j D]}|||d|_ | | |jr| |dSdSr) r _JanitorpostCaseCleanupry BaseExceptionr9r r1 _observer getErrorsflushLoggedErrors_removeObserver addSuccess)rr>cleanerrors r_cleanUpzTestCase._cleanUps !M$//??AAE %$  ! ! ! OOD'/"3"3 4 4 4 DLLL !^--// ! !E OOD% ( ( ( DLL      < $   d # # # # # $ $s038A.-A.c tj||dS#t$r+||t jYdSwxYwrD)r rpostClassCleanuprr9r r1)rr>s r _classCleanUpzTestCase._classCleanUpsk 5 M$ ' ' 8 8 : : : : : 5 5 5 OOD'/"3"3 4 4 4 4 4 4 5s'+1A A cfd}|S)z Create a method which wraps the reactor method C{name}. The new method issues a deprecation warning and calls the original. cptjddddtj|i|S)Nzreactor.z8 cannot be used inside unit tests. In the future, using z7 will fail the test and may crash or hang the test run.) stacklevelrB)warningswarnrN_reactorMethods)akwnamers r_z&TestCase._makeReactorMethod.._sY MM26ttt=+     .4'-q7B77 7r)rrrs`` r_makeReactorMethodzTestCase._makeReactorMethods)  8 8 8 8 8 8rci|_dD]>}t|||j|<t||||?dS)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. )r4iterateroN)rrOsetattrr)rr.rs r_deprecateReactorzTestCase._deprecateReactorsc "0 B BD)0$)?)?D  & GT4#:#:4#@#@ A A A A B Brct|jD]\}}t|||i|_dS)z Restore the deprecated reactor methods. Undoes what L{_deprecateReactor} did. @param reactor: The Twisted reactor. N)ritemsr)rr.rrYs r_undeprecateReactorzTestCase._undeprecateReactorsI!06688 + +LD& GT6 * * * *!rcddlm}||d|_ |d|} ||||||n/#||||wxYw ||dS#||wxYw)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. rr-FN) rJr.rr5rj_waitrrr)rr>r.r:s r_runFixturesAndTestzTestCase._runFixturesAndTests -,,,,, w''' .f--A + 1  f%%%""6**** f%%%""6*****  $ $W - - - - -D $ $W - - - -s"CA;+C;,B''CCr<r^r_returnNc>tj|g|Ri|S)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. )r addCleanup)rr<r^r_rs rrzTestCase.addCleanup0s,"uww!!5d555f555rc*|SrD)rV)rs r getSuppresszTestCase.getSuppress<s  """rctj|jdtj} t |S#t t f$r*tjdttjcYSwxYw)ae 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. r?z)'timeout' attribute needs to be a number.rA) r acquireAttribute_parentsDEFAULT_TIMEOUT_DURATIONfloat ValueErrorrRrrrN)rr?s rrKzTestCase.getTimeout?s' M9d&C   1>> !I& 1 1 1 M;FX    0 0 0 0 1s68A10A1c|rtdddlmgfd}fd}tj|t jdt}fd}tj|t jdt}|d  | |r d | d S| ||_  ` n#` wxYws|j r d | d St#d | wxYw) zATake a Deferred that only ever callbacks. Block until it happens.z_wait is not reentrantrr-c:|dSdSrD)r)anyresultss rrzTestCase._wait..append_s)"s######"rc8dSdSrDr4)ignr.rs rr4zTestCase._wait..crashcs"" #"rzreactor\.crash cannot be used.*)messagerBc0dSrDrr-srrozTestCase._wait..stopns MMOOOOOrN) RuntimeErrorrJr.rrLr rMrNrrXrror]r5rn)rr:runningrr4ror.rs @@rrzTestCase._waitVs  9788 8,,,,,, $ $ $ $ $      &  M:EW          %  M:EW      t$  IIf    <G KKMMMMM= IIe   GL ! LLGL     $. "G KKMMMMM$%% %G KKMMMMs0D9D9+D?D9D D9+D99E)r)$__name__ __module__ __qualname____doc__rr+failUnlessFailurer[r`rjrgrfrtrurvrrinlineCallbacksrprrrrrrrrobjectr^r_rrrKrr __classcell__)rs@rrr!s   % % % % % %///.&+++Z)))333   %%%    !!!"$$$ 555 $ B B B " " ".... 6"f*% 6.0g 6AC 6  6 6 6 6 6 6###111. 0GGGGGGGGrr)rrPrtypingrrzope.interfacertyping_extensionsrrJrrtwisted.pythonr twisted.trialr r twisted.trial._synctestr r rrr__annotations__ ITestCaserrrrrsA !!!!!!!!&&&&&&'''''' *)))))))""""""&&&&&&&&KKKKKKKKKKYt__!$t*!!! V {{{{{"{{{{{r