Mc@sdZddddddddd d d d d dddddddgZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z mZmZmZddlmZddlmZddlmZmZddlmZddlmZddlmZmZddlm Z e!dZ"d Z#d!Z$d"Z%d#Z&e'd$Z(d%Z)d&Z*defd'YZ+d(Z,defd)YZ-defd*YZ.d e/fd+YZ0de0fd,YZ1d efd-YZ2d.Z3d/Z4d e/fd0YZ5de5fd1YZ6d e/fd2YZ7de/fd3YZ8d e/fd4YZ9dS(5sK A miscellany of code used to run Trial tests. Maintainer: Jonathan Lange t suiteVisitt TestSuitetDestructiveTestSuitet DocTestCaset DocTestSuitet DryRunVisitort ErrorHoldert LoggedSuitetPyUnitTestCaset TestHoldert TestLoadert TrialRunnert TrialSuitetfilenameToModulet isPackagetisPackageDirectoryt isTestCasetnametsamefilet NOT_IN_TESTiN(treflecttlogtfailuretmodulestfilepath(tset(tdefer(tutiltunittest(t ITestCase(tUncleanWarningsReporterWrapper(RR(t implementsRcCsEt|tjstStjjtjj|jd}|dkS(s>Given an object return True if the object looks like a packageit__init__( t isinstancettypest ModuleTypetFalsetostpathtsplitexttbasenamet__file__(tmoduleR(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR+s%cCsTxMttjdD]5}d|}tjjtjj||r|SqWtS(sIs the directory at path 'dirname' a Python package directory? Returns the name of the __init__ file (it may have a weird extension) if dirname is a package directory. Otherwise, returns FalseiR (tziptimpt get_suffixesR%R&texiststjoinR$(tdirnametexttinitFile((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR3s  !cCs"tjj|tjj|kS(s A hacky implementation of C{os.path.samefile}. Used by L{filenameToModule} when the platform doesn't provide C{os.path.samefile}. Do not use this. (R%R&tabspath(t filename1t filename2((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR>scCstjj|s(td|fnytjtj|}Wnttfk rdt|SXtjj |j dd}t tjdt }tjj |r||| rtj|j=t|}n|S(sV Given a filename, do whatever possible to return a module object matching that file. If the file in question is a module in Python path, properly import and return that module. Otherwise, load the source manually. @param fn: A filename. @return: A module object. @raise ValueError: If C{fn} does not exist. s%r doesn't existis.pyR(R%R&R.t ValueErrorRtnamedAnytfilenameToModuleNametAttributeErrort_importFromFileR'R)tgetattrRtisfiletsysRt__name__(tfntrettretFiletsame((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR Fs  " cCst|}|s;tjjtjj|dd}n|tjkrUtj|St|d}ztj |||}Wd|j X|S(Niitr( t_resolveDirectoryR%R&R'tsplitR=RtopenR,t load_sourcetclose(R?t moduleNametfdR*((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR:cs )  cCsVtjj|rRt|}|r<tjj||}qRtd|fn|S(Ns%r is not a package directory(R%R&tisdirRR/R6(R?R2((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRDqs  cCsgt|j|jt|kr`x<t|jD](}t|j|t|kr1|Sq1Wn|jS(s Find the attribute name on the method's class which refers to the method. For some methods, notably decorators which have not had __name__ set correctly: getattr(method.im_class, method.__name__) != method (R;tim_classR>tobjecttdir(tmethodtalias((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt_getMethodNameInClass{s ! cBseZdZdZRS(sQ A test suite which remove the tests once run, to minimize memory usage. cCs=x6|jr8|jrPn|jjd}||qW|S(sn Almost the same as L{TestSuite.run}, but with C{self._tests} being empty at the end. i(t_testst shouldStoptpop(tselftresultttest((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytruns   (R>t __module__t__doc__RX(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRss cBseZdZdZRS(s[ Any errors logged in this suite will be reported to the L{TestResult} object. cCsntj}|jtt|j||jx*|jD]}|jt t |q@W|j dS(s Run the suite, storing all errors in C{result}. If an error is logged while no tests are running, then it will be added as an error to C{result}. @param result: A L{TestResult} object. N( Rt _logObservert_addtsuperRRXt_removet getErrorstaddErrorR Rt flushErrors(RURVtobserverterror((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRXs   (R>RYRZRX(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRscBseZdZdZRS(s DEPRECATED in Twisted 8.0. Behaves like doctest.DocTestSuite, but decorates individual TestCases so they support visit and so that id() behaviour is meaningful and consistent between Python versions. cCs`tjddtddtj|tj|}x$|jD]}|jt |q?WdS(Ns*DocTestSuite is deprecated in Twisted 8.0.tcategoryt stackleveli( twarningstwarntDeprecationWarningRR tdoctestRRRtaddTestR(RUt testModuletsuiteRW((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s    (R>RYRZR (((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRscBsDeZdZdZdZdZdZdZdZRS(s DEPRECATED in Twisted 8.0. This class decorates the pyunit.TestCase class, mainly to work around the differences between unittest in Python 2.3, 2.4, and 2.5. These differences are:: - The way doctest unittests describe themselves - Where the implementation of TestCase.run is (used to be in __call__) - Where the test method name is kept (mangled-private or non-mangled private variable) It also implements visit, which we like. cCs,tjddt||_|j|_dS(NsDeprecated in Twisted 8.0.Rd(RfRgRht_testtid(RURW((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s  cCsV|jj}t|jdd}|dkr<|jj}n|jd|jd|S(Nt_TestCase__testMethodNamet.(Rmt __class__R;tNonet_testMethodNameRYR>(RUtclsttmn((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRns   cCsd|jfS(NsPyUnitTestCase<%r>(Rn(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt__repr__scCs |j|S(N(Rm(RUtresults((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt__call__scCs$tjddt||jdS(s Call the given visitor with the original, standard library, test case that C{self} wraps. See L{unittest.TestCase.visit}. Deprecated in Twisted 8.0. s'Test visitors deprecated in Twisted 8.0RdN(RfRgRhRm(RUtvisitor((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytvisits cCst|j|S(N(R;Rm(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt __getattr__s( R>RYRZR RnRvRxRzR{(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRs    cBseZdZdZRS(s$ DEPRECATED in Twisted 8.0. cCs |jjS(s In Python 2.4, doctests have correct id() behaviour. In Python 2.3, id() returns 'runit'. Here we override id() so that at least it will always contain the fully qualified Python name of the doctest. (RmtshortDescription(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRn s(R>RYRZRn(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRscBs,eZdZddZdZdZRS(s Suite to wrap around every single test in a C{trial} run. Used internally by Trial to set up things necessary for Trial tests to work, regardless of what context they are run in. cCs)t|}tt|j|gdS(N(RR]R R (RUttestsRl((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s cs_ddlm}tj|jddfd|jdtjdjdS(Ni(treactortaftertshutdowncs jdS(N(tcallbackRr((td(s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt%stmktemp( ttwisted.internetR~RtDeferredtaddSystemEventTriggertfireSystemEventRtTestCaset_wait(RUR~((Rs8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt_bail!s    cCs&ztj||Wd|jXdS(N(RRXR(RURV((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRX-s((R>RYRZR RRX(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s  cCsOt|rtj|}n-y|j}Wntk rJ|j}nX|S(s @param thing: an object from modules (instance of PythonModule, PythonAttribute), a TestCase subclass, or an instance of a TestCase. (RRtqualRnR9R(tthingttheName((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR4s   cCs-yt|tjSWntk r(tSXdS(s Returns C{True} if C{obj} is a class that contains test cases, C{False} otherwise. Used to find all the tests in a module. N(t issubclasstpyunitRt TypeErrorR$(tobj((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRGs cBsTeZdZeedZdZdZdZ dZ dZ dZ RS(s Placeholder for a L{TestCase} inside a reporter. As far as a L{TestResult} is concerned, this looks exactly like a unit test. cCs ||_dS(sM @param description: A string to be displayed L{TestResult}. N(t description(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR ]scCs |j|S(N(RX(RURV((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRxdscCs|jS(N(R(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRnhscCsdS(Ni((RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytcountTestCaseslscCs+|j||j||j|dS(s This test is just a placeholder. Run the test successfully. @param result: The C{TestResult} to store the results in. @type result: L{twisted.trial.itrial.ITestResult}. N(t startTestt addSuccesststopTest(RURV((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRXps  cCs|jS(N(R(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR||sN( R>RYRZRRRrtfailureExceptionR RxRnRRXR|(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR Ss      cBs2eZdZdZdZdZdZRS(s Used to insert arbitrary errors into a test suite run. Provides enough methods to look like a C{TestCase}, however, when it is run, it simply adds an error to the C{TestResult}. The most common use-case is for when a module fails to import. cCs#tt|j|||_dS(s) @param description: A string used by C{TestResult}s to identify this error. Generally, this is the name of a module that failed to import. @param error: The error to be added to the result. Can be an exc_info tuple or a L{twisted.python.failure.Failure}. N(R]RR Rc(RURRc((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR scCsd|j|jfS(Ns%(RRc(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRvs cCs:|j||j|tj|j|j|dS(s Run the test, reporting the error. @param result: The C{TestResult} to store the results in. @type result: L{twisted.trial.itrial.ITestResult}. N(RR`RtexcInfoOrFailureToExcInfoRcR(RURV((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRXs cCs||dS(s1 See L{unittest.TestCase.visit}. N((RURy((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRzs(R>RYRZR RvRXRz(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRs   cBseZdZdZdZdZdZdZdZdZ e Z dZ e Z d Z d Zd Zed Zd ZedZedZeZedZdZRS(s4 I find tests inside function, modules, files -- whatever -- then return them wrapped inside a Test (either a L{TestSuite} or a L{TestCase}). @ivar methodPrefix: A string prefix. C{TestLoader} will assume that all the methods in a class that begin with C{methodPrefix} are test cases. @ivar modulePrefix: A string prefix. Every module in a package that begins with C{modulePrefix} is considered a module full of tests. @ivar forceGarbageCollection: A flag applied to each C{TestCase} loaded. See L{unittest.TestCase} for more information. @ivar sorter: A key function used to sort C{TestCase}s, test classes, modules and packages. @ivar suiteFactory: A callable which is passed a list of tests (which themselves may be suites of tests). Must return a test suite. RWttest_cCst|_t|_g|_dS(N(Rt suiteFactoryRtsortert _importErrors(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s  cCst|d|jS(st Sort the given things using L{sorter}. @param xs: A list of test cases, class or modules. tkey(tsortedR(RUtxs((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytsortscCsOg}x9tj|D](\}}t|r|j|qqW|j|S(s-Given a module, return all Trial test classes(tinspectt getmembersRtappendR(RUR*tclassesRtval((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytfindTestClassess  cCs)tjj|rt|Stj|S(sB Return a Python object given a string describing it. @param name: a string which may be either a filename or a fully-qualified Python name. @return: If C{name} is a filename, return the module. If C{name} is a fully-qualified Python name, return the object it refers to. (R%R&R.R RR7(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt findByNames  cCst|tjs(td|fnt|drA|jSt|drZ|jS|j}x-|j|D]}|j |j |qvWt|ds|S|j}x'|j D]}|j |j |qW|j||gS(s Return a test suite with all the tests from a module. Included are TestCase subclasses and doctests listed in the module's __doctests__ module. If that's not good for you, put a function named either C{testSuite} or C{test_suite} in your module that returns a TestSuite, and I'll use the results of that instead. If C{testSuite} and C{test_suite} are both present, then I'll use C{testSuite}. s%r is not a modulet testSuitet test_suitet __doctests__( R!R"R#RthasattrRRRRRjt loadClassRt loadDoctests(RUR*Rlt testClasstdocSuiteRi((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt loadModules    cCst|tpt|tjs7td|fnt|sYtd|fn|j|}|jg|D]}|j ||j |^qu}|j |S(sq Given a class which contains test cases, return a sorted list of C{TestCase} instances. s%r is not a classs%r is not a test case( R!ttypeR"t ClassTypeRRR6tgetTestCaseNamesRt _makeCaset methodPrefixR(RUtklasstnamesRR}((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s!  ,cCstj||jS(s Given a class that contains C{TestCase}s, return a list of names of methods that probably contain tests. (RtprefixedMethodNamesR(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRscCsAt|tjs(td|fn|j|jt|S(s~ Given a method of a C{TestCase} that represents a test, return a C{TestCase} instance for that test. s%r not a method(R!R"t MethodTypeRRRLRQ(RURO((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt loadMethodscCs ||S(N((RURt methodName((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR(sc Cst|s"td|fntj|j}|rI|j}n |j}g}x@|D]8}|jjddj |j rb|j |qbqbW|j }xe|j |D]T}y|j} Wnt|jtj} nX|j| } |j| qW|S(s Load tests from a module object representing a package, and return a TestSuite containing those tests. Tests are only loaded from modules whose name begins with 'test_' (or whatever C{modulePrefix} is set to). @param package: a types.ModuleType object (or reasonable facsimilie obtained by importing) which may contain tests. @param recurse: A boolean. If True, inspect modules within packages within the given package (and so on), otherwise, only inspect modules in the package itself. @raise: TypeError if 'package' is not a package. @return: a TestSuite created with my suiteFactory, containing all the tests. s%r is not a packageRpi(RRRt getModuleR>t walkModulest iterModulesRREt startswitht modulePrefixRRRtloadRRtFailureRRj( RUtpackagetrecursetpkgobjt discoveryt discoveredtdiscoRltmodinfoR*t thingToAdd((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt loadPackage+s&   " cCst|tr?ytj|}Wq?t|tjSXntj|s_t j ddSi}t j dkrd}||d|j||jfq |j|fq Wgt|D]}|d^q_S(s  Gather unique suite objects from loaded things. This will guarantee uniqueness of inherited methods on TestCases which would otherwise hash to same value and collapse to one test unexpectedly if using simpler means: e.g. set(). i(R!R"RRRLR(RURtentriesRtentry((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRs  (R>RYRZRRR RRRRtloadTestsFromModuleRtloadTestsFromTestCaseRRRR$RRRRtloadTestsFromNameRR(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s*         *    cBs eZdZdZdZRS(sa A visitor that makes a reporter think that every test visited has run successfully. cCs ||_dS(s: @param reporter: A C{TestResult} object. N(treporter(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR scCs4|jj||jj||jj|dS(sQ Convince the reporter that this test has been run successfully. N(RRRR(RUttestCase((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytmarkSuccessfuls(R>RYRZR R(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRs c BseZdZdZdZdZdZdZeZ dZ dde j edeeded Zd Zd Zd Zd ZdZRS(s= A specialised runner that the trial front end uses. tdebugsdry-runcCstj}yddl}Wn tk r>dGHtjnXxjdD]b}tjj|rFyt |d}Wnt k rtjqX|j j |j qFqFW|S(Nisreadline module not availables.pdbrctpdbrcRC(s.pdbrcR(tpdbtPdbtreadlinet ImportErrorR=t exc_clearR%R&R.tfiletIOErrortrcLinesRt readlines(RUtdbgRR&trcFile((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt _getDebuggers    cCsT|jtj}tj|j}tj|\}|_tj |j |S(N( t_tearDownLogFileR%tgetcwdRtFilePathtworkingDirectoryRt_unusedTestDirectoryt _testDirLocktchdirR&(RUt currentDirtbasettestdir((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt _setUpTestdirs   cCstj||jjdS(N(R%RRtunlock(RUtoldDir((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt_tearDownTestdirs cCs@|j|j|j|j|j}|jr<t|}n|S(N(treporterFactorytstreamttbformattrterrorst_logtuncleanWarningsR(RUR((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt _makeResults  stest.logtdefaultc Cs||_||_||_||_||_||_||_d|_| pQd|_ d|_ d|_ | |_ |rt j|jd|_ndS(Nt _trial_temps profile.data(RtlogfiletmodeRRRRRrt_resultRt_logFileObservert_logFileObjectt_forceGarbageCollectionRtprofiledRX( RURR R RtprofilettracebackFormattrealTimeErrorsRRtforceGarbageCollection((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s           cCsZ|jdk r.tj|jjd|_n|jdk rV|jjd|_ndS(N(RRrRtremoveObservertemitRRH(RU((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRs   cCsl|j|jdkr%tj}nt|jd}||_tj||_tj |jj ddS(Nt-tai( RR R=tstdoutRRRtFileLogObserverRtstartLoggingWithObserverR(RUtlogFile((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt _setUpLogFile's   cCs@tj|t}|jr3tj|tj}n|j|S(sC Run the test or suite and return a result object. (RtdecorateRRt _ForceGarbageCollectionDecoratort_runWithoutDecoration(RURW((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRX2s  cs|jt|gtj}|j|jkr}xtjD]-}j|j|j |qIWn|j|j kr|j fd}nfd}|j }z|j |Wd|j|j|Xtj}tdd}|dkrtjdtjjdtddjjjjd j||jd jn jS( sR Private helper that runs the given test but doesn't decorate it. csjjS(N(truncallRX((RltdebuggerRV(s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRPscs jS(N(RX((RlRV(s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyRRsNtdonesR%s should implement done() but doesn't. Falling back to printErrors() and friends.RdReisRan %d tests in %.3fss (RR ttimeR tDRY_RUNRt _iterateTestsRRRtDEBUGRRRRRR;RrRfRgRRRqRht printErrorstwritelnt separatorttestsRuntwritet printSummaryR$(RURWt startTimetsingleRXRtendTimeR$((R#RVRls8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR!=sB                 cCsd}x{tr|d7}|jjd|f|dkrN|j|}n|j|}|jdkrpPn|js Pq q W|S(s8 Repeatedly run C{test} until it fails. iis Test Pass %d (tTrueRR-RXR!R,t wasSuccessful(RURWtcountRV((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pytrunUntilFailurens    N(R>RYRZR(R&RRRRRRRrR=RR$R RRRXR!R5(((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyR s,      1(:RZt__all__RR%R"RfR=RR,RiR%ttwisted.pythonRRRRRttwisted.python.compatRRRt twisted.trialRRttwisted.trial.itrialRttwisted.trial.reporterRttwisted.trial.unittestRRtzope.interfaceRt __import__RRRRR RrR:RDRQRRRRRMRRR RRR RR RR (((s8/usr/lib/python2.7/dist-packages/twisted/trial/runner.pyt sP     H(      7  .-