/usr/lib/python3/dist-packages/twisted/trial/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/trial/__pycache__/runner.cpython-310.pyc (26924B)
o
b| @ s d Z g dZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZmZmZmZ ddlmZmZ dd lmZmZ dd
l m Z dd l m Z dd l m!Z!m"Z" dd
l#m$Z$ e%dZ&dd Z'dd Z(dd Z)dd Z*dd Z+dd Z,dd Z-G d d d e$Z.d Z/G d d! d!e$Z0G d"d# d#e$Z1d$d% Z2d&d' Z3e
e G d(d) d)Z4G d*d+ d+e4Z5G d,d- d-Z6d.d/ Z7G d0d1 d1Z8dS )2zK
A miscellany of code used to run Trial tests.
Maintainer: Jonathan Lange
) TestSuiteDestructiveTestSuite ErrorHolder LoggedSuite
TestHolder
TestLoader TrialRunner
TrialSuitefilenameToModule isPackageisPackageDirectory
isTestCasenamesamefile NOT_IN_TEST N)SourceFileLoader) implementer)defer)failurefilepathlogmodulesreflect)unittestutil) _ForceGarbageCollectionDecorator
_iterateTests) _logObserver) ITestCase) UncleanWarningsReporterWrapper _ExitWrapper)r r c C s2 t | tjsdS tjtj| jd }|dkS )z>Given an object return True if the object looks like a packageFr __init__)
isinstancetypes
ModuleTypeospathsplitextbasename__file__)moduler( r+ 6/usr/lib/python3/dist-packages/twisted/trial/runner.pyr
8 s r
c C s> dd }| D ]}d| }t jt j| |r | S qdS )z
Is 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 False
c S s
t j S N) importlib machinery all_suffixesr+ r+ r+ r, _getSuffixesG
z(isPackageDirectory.
._getSuffixesr! F)r% r& existsjoin)dirnamer1 extinitFiler+ r+ r, r @ s
r c C s t j| t j|kS )z
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& abspath) filename1 filename2r+ r+ r, r Q s r c C s | }dt j kr
dk r n ntj| s tjt | } tj| s+t|dt
| }zt |}W n tt fyH t
| |d Y S w t|dddu rWt
| |dS tj|jd d }ttjd t}tj| r|| |st j|j= t
| |d}|S )
aV
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.
) )r;
z doesn't exist)
moduleNamer) Nr z.pyr )sys version_infor% r& isabsr4 getcwdr3
ValueErrorr filenameToModuleNamenamedAnyAttributeError_importFromFilegetattrr' r) r isfiler __name__)fnoldFnr> retretFilesamer+ r+ r, r Y s& &
r c C s| t | } |stjtj| d d }|tjv r tj| S tj || }|s+t
| tj |}|j
| |tj|< |S )Nr )_resolveDirectoryr% r& r' splitr? r r. r spec_from_file_location SyntaxErrormodule_from_specloader exec_module)rK r> specr* r+ r+ r, rG s
rG c C s< t j| r t| }|rt j| |} | S t| d| S )Nz is not a package directory)r% r& isdirr r4 rC )rK r7 r+ r+ r, rQ s rQ c C sH t | j| jt | kr!t| jD ]}t | j|t | kr | S q| jS )z
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
)rH im_classrJ objectdir)methodaliasr+ r+ r, _getMethodNameInClass s r_ c @ s e Zd ZdZdd ZdS )r zQ
A test suite which remove the tests once run, to minimize memory usage.
c C s0 | j r|jr |S | j d}|| | j s|S )zn
Almost the same as L{TestSuite.run}, but with C{self._tests} being
empty at the end.
r )_tests
shouldStoppop)selfresulttestr+ r+ r, run s zDestructiveTestSuite.runN)rJ
__module__ __qualname____doc__rf r+ r+ r+ r, r s r z
c s e Zd ZdZ fddZ ZS )r z[
Any errors logged in this suite will be reported to the L{TestResult}
object.
c sJ t }| t | | | D ]
}|tt| q| dS )z
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)
r _addsuperrf _remove getErrorsaddErrorr r flushErrors)rc rd observererror __class__r+ r, rf s zLoggedSuite.run)rJ rg rh ri rf
__classcell__r+ r+ rr r, r s r c s2 e Zd ZdZd
fdd Zdd Zdd Z ZS ) r z
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.
r+ Fc sF |rg }|D ]
}t |t}|| q|}t|}t |g d S r- )r decorater appendr rk r! )rc testsforceGarbageCollectionnewTestsre suiterr r+ r, r! s zTrialSuite.__init__c sH ddl m} t |dd fdd |d td d S )Nr )reactoraftershutdownc s
d S r- )callbackr+ dr+ r,
z"TrialSuite._bail..mktemp) twisted.internetr{ r DeferredaddSystemEventTriggerfireSystemEventr TestCase_wait)rc r{ r+ r r, _bail s
zTrialSuite._bailc C s& z
t | | W | d S | w r- )r rf r rc rd r+ r+ r, rf s zTrialSuite.run)r+ F)rJ rg rh ri r! r rf rt r+ r+ rr r, r s
r c C s@ t | r t| }|S z| }W |S ty | j}Y |S w )z
@param thing: an object from modules (instance of PythonModule,
PythonAttribute), a TestCase subclass, or an instance of a TestCase.
)r r qualidrF r
)thingtheNamer+ r+ r, r
s
r
c C s$ zt | tjW S ty Y dS w )z
@return: C{True} if C{obj} is a class that contains test cases, C{False}
otherwise. Used to find all the tests in a module.
F)
issubclasspyunitr TypeError)objr+ r+ r, r s
r c @ sD e Zd ZdZdZdd Zdd Zdd Zd d
Zd d Z d
d Z
dS )r z
Placeholder for a L{TestCase} inside a reporter. As far as a L{TestResult}
is concerned, this looks exactly like a unit test.
Nc C s
|| _ dS )zM
@param description: A string to be displayed L{TestResult}.
N description)rc r r+ r+ r, r! , s
zTestHolder.__init__c C s
| |S r- rf r r+ r+ r, __call__2 r2 zTestHolder.__call__c C | j S r- r rc r+ r+ r, r 5 z
TestHolder.idc C s dS )Nr r+ r r+ r+ r, countTestCases8 s zTestHolder.countTestCasesc C s" | | || || dS )z
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.IReporter}.
N) startTest
addSuccessstopTestr r+ r+ r, rf ; s
zTestHolder.runc C r r- r r r+ r+ r, shortDescriptionF r zTestHolder.shortDescription) rJ rg rh ri failureExceptionr! r r r rf r r+ r+ r+ r, r # s r c s6 e Zd ZdZ fddZdefddZdd Z ZS ) r a
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.
c s t | t|| _dS )a+
@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)rk r! r excInfoOrFailureToExcInforq )rc r rq rr r+ r, r! R s zErrorHolder.__init__returnc C s d | j| jd S )Nz) )formatr rq r r+ r+ r, __repr__] s zErrorHolder.__repr__c C s& | | || | j || dS )z
Run the test, reporting the error.
@param result: The C{TestResult} to store the results in.
@type result: L{twisted.trial.itrial.IReporter}.
N)r rn rq r r r+ r+ r, rf c s
zErrorHolder.run) rJ rg rh ri r! strr rf rt r+ r+ rr r, r J s
r c @ s e Zd ZdZdZdZdd Zdd Zdd Zd&d d Z d
d Z
e
Z dd Z e Z
dd Zdd Zdd Zd&ddZdd Zd'd d Zd&d d ZeZd&d d!Zd"d# Zd&d$d%ZdS )(r a4
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.
re test_c C s t | _t| _g | _d S r- )r suiteFactoryr
sorter
_importErrorsr r+ r+ r, r! s
zTestLoader.__init__c C s t || jdS )zt
Sort the given things using L{sorter}.
@param xs: A list of test cases, class or modules.
)key)sortedr )rc xsr+ r+ r, sort s zTestLoader.sortc C s4 g }t |D ]
\}}t|r|| q| |S )z-Given a module, return all Trial test classes)inspect
getmembersr rv r )rc r* classesr
valr+ r+ r, findTestClasses s
zTestLoader.findTestClassesFc C sb t j|v r!t|}zt| W n ty | j||d Y S w |}d } }}t|D ]B\}}z
t|}|}W n4 tyo t
d } | j durU| j } | j dusM| j j
j}
|
tjkr` |dkrmtd| dY q-w |du rt|}|dtd|jd d }z|D ]
} |t|| }}qW n ty t| dw | j||||d S )
a
Find and load tests, given C{name}.
@param _name: The qualified name of the thing to load.
@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.
@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.
recurseN z The module z does not exist..r )parentqualNamer )r% sepr rD
__import__ ImportErrorloadFile_qualNameWalker namedModuler? exc_infotb_nexttb_framef_code co_filenamer) ModuleNotFoundrE rR lenrJ rH rF loadAnything) rc _namer r
r r remaining
searchName
remainingNametbfilenameWhereHappenedpartr+ r+ r,
findByName sN
" zTestLoader.findByNamec C s t |tjs
t|dt|dr| S t|dr | S | }| |D ]
}| |
| q(t|ds:|S | }|j D ]
}| | | qA| ||gS )a
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}.
z is not a module testSuite
test_suite __doctests__)
r" r# r$ r hasattrr r r r addTest loadClassr loadDoctests)rc r* rz testClassdocSuitedocTestr+ r+ r,
loadModule s
zTestLoader.loadModulec s\ t ts t dt st d } fdd|D }|S )z
Given a class which contains test cases, return a list of L{TestCase}s.
@param klass: The class to load tests from.
z is not a classz is not a test casec s g | ] } j| qS r+ ) _makeCase methodPrefix).0r
klassrc r+ r,
s z(TestLoader.loadClass..)r" typer r rC getTestCaseNamesr r )rc r namesrw r+ r r, r s
zTestLoader.loadClassc C s t || jS )z
Given a class that contains C{TestCase}s, return a list of names of
methods that probably contain tests.
)r prefixedMethodNamesr )rc r r+ r+ r, r % s zTestLoader.getTestCaseNamesc C s t d)NzCan't happen on Py3)NotImplementedError)rc r] r+ r+ r,
loadMethod, zTestLoader.loadMethodc C s ||S r- r+ )rc r
methodNamer+ r+ r, r / r zTestLoader._makeCasec C s t |s t|dt|j}|r| }n| }g }|D ]}|jdd | j
r3| | q | }|
|D ]$}z| } W n tyV t|jt }
Y nw | | }
||
q=|S )a
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 facsimile
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 C{package} is not a package.
@return: a TestSuite created with my suiteFactory, containing all the
tests.
z is not a packager rP )r
r r getModulerJ walkModules iterModulesr
rR
startswith modulePrefixrv r r load
BaseExceptionr r Failurer r ) rc packager pkgobj discovery
discovereddiscorz modinfor*
thingToAddr+ r+ r, loadPackage2 s*
zTestLoader.loadPackagec C sx t |tr zt|}W n ty t|t Y S w t |s)t
d dS i }dd }||d< t j
|fi |S )z
Return a suite of tests for all the doctests defined in C{module}.
@param module: A module object or a module name.
z&trial only supports doctesting modulesNc S s t | d| j| _| j | _dS )z
Save C{test.globs} and replace it with a copy so that if
necessary, the original will be available for the next test
run.
_savedGlobalsN)rH globsr copy)re r+ r+ r, saveGlobalsm s z,TestLoader.loadDoctests..saveGlobalssetUp)r" r r rE r r r r r ismodulewarningswarndoctest DocTestSuite)rc r* extraArgsr r+ r+ r, r \ s
zTestLoader.loadDoctestsNc C s t |tjrt|r| j||dS | |S t |tr&t|tj r&|
|S t |tj rLt |trLt|tj rL|d }||}t ||j
j|ksJJ |S t |trS|S td| )a
Load absolutely anything (as long as that anything is a module,
package, class, or method (with associated parent class and qualname).
@param obj: The object to load.
@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.
@param parent: If C{obj} is a method, this is the parent class of the
method. C{qualName} is also required.
@param qualName: If C{obj} is a method, this a list containing is the
qualified name of the method. C{parent} is also required.
@return: A C{TestCase} or C{TestSuite}.
r rP z"don't know how to make test from: )r" r# r$ r
r loadTestsFromModuler r r r loadTestsFromTestCase FunctionTyperH _testMethodName__func__r r )rc r r r r r
instr+ r+ r, r y s&
zTestLoader.loadAnythingc C sB z | | j||dgW S ty | t|t g Y S w )a*
Load some tests by name.
@param name: The qualified name for the test to load.
@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.
r )r r r r r r )rc r
r r+ r+ r,
loadByName s
zTestLoader.loadByNamec
C sj g }g }|D ]!}z | | j||d W q ty' | t|t Y qw || | | |S )a+
Load some tests by a list of names.
@param names: A L{list} of qualified names.
@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.
r ) rv r r r r r extendr _uniqueTests)rc r r thingserrorsr
r+ r+ r, loadByNames s
zTestLoader.loadByNamesc c sF t }|D ]}|j}|D ]}t||vr |V |t| q
qdS )a
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().
N)setr` r add)rc r seen testthing
testthingsr r+ r+ r, r
s zTestLoader._uniqueTestsc C sF t |}zt|| }| j||dW S ty" t| dw )a1
Load a file, and then the tests in that file.
@param fileName: The file name to load.
@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.
r z is not a Python file.)r rD r load_moduler OSErrorrC )rc fileNamer r
r* r+ r+ r, r s
zTestLoader.loadFileF)FNN)rJ rg rh ri r r r! r r r r r r r r r r r r r r loadTestsFromNamer r
r r+ r+ r+ r, r o s.
V
*
0
r c c sR | g fV | d}tdt|D ]}d|d| || d fV qdS )a3
Given a Python qualified name, this function yields a 2-tuple of the most
specific qualified name first, followed by the next-most-specific qualified
name, and so on, paired with the remainder of the qualified name.
@param qualName: A Python qualified name.
@type qualName: L{str}
r r N)rR ranger r4 )r qualPartsindexr+ r+ r, r s
&r c @ s e Zd ZdZdZdZdd Zdd ZeZ dd Z
d
d e j d d
d d d
d d
d f ddZ
dd Zdd Zdd ZdddZdd Zd
S )r z=
A specialised runner that the trial front end uses.
debugzdry-runc C s< | t }t| j}t|\}| _t |j
|S r- ) _tearDownLogFiler% rB r FilePathworkingDirectoryr _unusedTestDirectory _testDirLockchdirr& )rc
currentDirbasetestdirr+ r+ r,
_setUpTestdir s zTrialRunner._setUpTestdirc C s t | | j d S r- )r% r$ r# unlock)rc oldDirr+ r+ r, _tearDownTestdir s
z TrialRunner._tearDownTestdirc C s8 | | j| j| j| j}| jrt|}| jrt|}|S r- ) reporterFactorystreamtbformatrterrors_log
_exitFirstr uncleanWarningsr )rc reporterr+ r+ r, _makeResult s zTrialRunner._makeResultNztest.logFdefaultc
C st || _ || _|| _|| _|| _|| _|| _d | _| pd| _d | _ d | _
|
| _ | | _ | | _
|r8t| jd| _d S d S )N _trial_tempz profile.data)r, logfilemoder- r. r/ r2 _resultr! _logFileObserver_logFileObject_forceGarbageCollectiondebuggerr1 r profiledrf )
rc r, r8 r7 r- profiletracebackFormatrealTimeErrorsr2 r! rx r= exitFirstr+ r+ r, r! # s"
zTrialRunner.__init__c C s@ | j d urt| j j d | _ | jd ur | j d | _d S d S r- )r: r removeObserveremitr; closer r+ r+ r, r C s
z TrialRunner._tearDownLogFilec C sL | | jdkr
tj}nt| jd}|| _t|| _t | jj
d d S )N-ar ) r r7 r? stdoutopenr; r FileLogObserverr: startLoggingWithObserverrD )rc logFiler+ r+ r,
_setUpLogFileK s
zTrialRunner._setUpLogFilec C s t |t}| || jS )zC
Run the test or suite and return a result object.
)r ru r _runWithoutDecorationr< )rc re r+ r+ r, rf U s zTrialRunner.runc sF t|g|t }jjkr+tD ]} | | | qn7jj kr: fdd}n fdd}
}z | W
| n
| w t }t dd}|du rtjdt j tdd j d j|| d
S S ) zR
Private helper that runs the given test but doesn't decorate it.
c s j j S r- )r= runcallrf r+ rd rc rz r+ r, r m s z3TrialRunner._runWithoutDecoration..c s
S r- r r+ )rd rz r+ r, r o r doneNzR%s should implement done() but doesn't. Falling back to printErrors() and friends.r; )category
stacklevelzRan %d tests in %.3fs
) r4 r timer8 DRY_RUNr r r r DEBUGr( rM r r+ rH r r r r rs DeprecationWarning printErrorswriteln separatortestsRunwrite printSummaryrQ ) rc re rx startTimesinglerf r* endTimerQ r+ rP r, rN \ sP
z!TrialRunner._runWithoutDecorationc C s^ d} |d7 }| j d|f |dkr| |}n| |}|jdkr' |S | s. |S q)z8
Repeatedly run C{test} until it fails.
r Tr z
Test Pass %d
)r- r] rf rN r\
wasSuccessful)rc re countrd r+ r+ r, runUntilFailure s
zTrialRunner.runUntilFailurer )rJ rg rh ri rW rV r( r+ r r0 r4 r? rH r! r rM rf rN rd r+ r+ r+ r, r s2
1r )9ri __all__r r. r r% r? rU r# r importlib.machineryr zope.interfacer r r twisted.pythonr r r r r
twisted.trialr r twisted.trial._asyncrunnerr r twisted.trial._synctestr twisted.trial.itrialr twisted.trial.reporterr r twisted.trial.unittestr r r r
r r r rG rQ r_ r r r r r
r r r r r r r+ r+ r+ r, sV 1
$ &%