Server : Apache/2.4.52 (Ubuntu) System : Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64 User : www-data ( 33) PHP Version : 8.1.2-1ubuntu2.21 Disable Function : NONE Directory : /lib/python3/dist-packages/twisted/trial/__pycache__/ |
o
�b�| � @ s� d Z g d�ZddlZddlZddlZddlZddlZddlZddlZddl 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%d�Z&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+e4�Z5G d,d-� d-�Z6d.d/� Z7G d0d1� d1�Z8dS )2zK
A miscellany of code used to run Trial tests.
Maintainer: Jonathan Lange
)� TestSuite�DestructiveTestSuite� ErrorHolder� LoggedSuite�
TestHolder�
TestLoader� TrialRunner�
TrialSuite�filenameToModule� isPackage�isPackageDirectory�
isTestCase�name�samefile� NOT_IN_TEST� N)�SourceFileLoader)� implementer)�defer)�failure�filepath�log�modules�reflect)�unittest�util)� _ForceGarbageCollectionDecorator�
_iterateTests)� _logObserver)� ITestCase)� UncleanWarningsReporterWrapper� _ExitWrapper)r r c C s2 t | tj�sdS tj�tj�| j��d }|dkS )z>Given an object return True if the object looks like a packageFr �__init__)�
isinstance�types�
ModuleType�os�path�splitext�basename�__file__)�moduler( � r+ �6/usr/lib/python3/dist-packages/twisted/trial/runner.pyr
8 s r
c C s> dd� }|� D ]}d| }t j�t 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.<locals>._getSuffixesr! F)r% r& �exists�join)�dirnamer1 �ext�initFiler+ 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 tj�t�� | �} tj�| �s+t|�d���t �
| �}zt � |�}W n tt fyH t
| |d� Y S w t|dd�du rWt
| |d�S tj�|j�d 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 �filenameToModuleName�namedAny�AttributeError�_importFromFile�getattrr' r) r �isfiler �__name__)�fn�oldFnr> �ret�retFile�samer+ r+ r, r Y s& &
�
r c C s| t | �} |stj�tj�| �d �d }|tjv r tj| S tj� || �}|s+t
| ��tj� |�}|j �
|� |tj|< |S )N���r )�_resolveDirectoryr% r& r' �splitr? r r. r �spec_from_file_location� SyntaxError�module_from_spec�loader� 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| j�D ]}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 �object�dir)�method�aliasr+ 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�
shouldStop�pop)�self�result�testr+ r+ r, �run� s ��zDestructiveTestSuite.runN)rJ �
__module__� __qualname__�__doc__rf r+ r+ r+ r, r � s r z
<not in test>c s e Zd ZdZ� fdd�Z� 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 �_add�superrf �_remove� getErrors�addErrorr r � flushErrors)rc rd �observer�error�� __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 �tests�forceGarbageCollection�newTestsre �suiterr r+ r, r! � s zTrialSuite.__init__c sH ddl m} t�� � |�dd� fdd�� |�d� t�d��� � d S )Nr )�reactor�after�shutdownc s
� � d �S r- )�callbackr+ ��dr+ r, �<lambda>� �
z"TrialSuite._bail.<locals>.<lambda>�mktemp) �twisted.internetr{ r �Deferred�addSystemEventTrigger�fireSystemEventr �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 �qual�idrF r
)�thing�theNamer+ r+ r, r
s
�
��r
c C s$ zt | tj�W 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)�
issubclass�pyunitr� � 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�
addSuccess�stopTestr� 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� fdd�Zdefdd�Zdd� 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)<ErrorHolder description={!r} error={!r}>� )�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&dd�Zdd� 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 || jd�S )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`� |dkrmt�d|� d���Y q-w |du r�t�|�}|�d�td�|j��d d� }z|D ]
} |t|| �}}q�W n ty� t|� d���w | 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� )�parent�qualNamer� )r% �sepr rD �
__import__� ImportError�loadFile�_qualNameWalker� namedModuler? �exc_info�tb_next�tb_frame�f_code� co_filenamer) �ModuleNotFoundrE rR �lenrJ rH rF � loadAnything) rc �_namer� r
r� r� � remaining�
searchName�
remainingName�tb�filenameWhereHappened�partr+ r+ r, �
findByName� sN
�
�
��
"� ��zTestLoader.findByNamec C s� t |tj�s
t|�d���t|d�r|�� S t|d�r |�� S | �� }| �|�D ]
}|� | �
|�� q(t|d�s:|S | �� }|j D ]
}|� | � |�� qA| �||g�S )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 � testClass�docSuite�docTestr+ r+ r, �
loadModule� s
zTestLoader.loadModulec s\ t � t�s t� �d���t� �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, �
<listcomp> s z(TestLoader.loadClass.<locals>.<listcomp>)r" �typer� r rC �getTestCaseNamesr� r� )rc r� �namesrw r+ r� r, r� s
�
zTestLoader.loadClassc C s t �|| j�S )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|�d���t�|j�}|r|�� }n|�� }g }|D ]}|j�d�d � | 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�
discovered�discorz �modinfor* �
thingToAddr+ r+ r, � loadPackage2 s*
� �
zTestLoader.loadPackagec C sx t |t�r 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.<locals>.saveGlobals�setUp)r" r� r rE r� r r r� r� �ismodule�warnings�warn�doctest� DocTestSuite)rc r* � extraArgsr� r+ r+ r, r� \ s
�
zTestLoader.loadDoctestsNc C s� t |tj�rt|�r| j||d�S | �|�S t |t�r&t|tj �r&| �
|�S t |tj �rLt |t�rLt|tj �rL|d }||�}t ||j
�j|ksJJ �|S t |t�rS|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||d�g�W 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� �things�errorsr
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||d�W S ty" t|� d���w )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.loadFile�F)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� � qualParts�indexr+ 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 dd�Z
dd� Zdd� Zdd� Zddd�Zdd� 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 �FilePath�workingDirectoryr �_unusedTestDirectory� _testDirLock�chdirr& )rc �
currentDir�base�testdirr+ 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- ) �reporterFactory�stream�tbformat�rterrors�_log�
_exitFirstr �uncleanWarningsr )rc �reporterr+ r+ r, � _makeResult s �zTrialRunner._makeResultNztest.logF�defaultc
C st || _ || _|| _|| _|| _|| _|| _d | _| pd| _d | _ d | _
|
| _ | | _ | | _
|r8t�| jd�| _d S d S )N� _trial_tempz profile.data)r, �logfile�moder- r. r/ r2 �_resultr! �_logFileObserver�_logFileObject�_forceGarbageCollection�debuggerr1 r �profiledrf )
rc r, r8 r7 r- �profile�tracebackFormat�realTimeErrorsr2 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 �removeObserver�emitr; �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? �stdout�openr; r �FileLogObserverr: �startLoggingWithObserverrD )rc �logFiler+ r+ r, �
_setUpLogFileK s
zTrialRunner._setUpLogFilec C s t �|t�}| �|| j�S )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�� }�j�jkr+t��D ]}� �|� � �|� � �|� qn7�j�j kr:� ��fdd�}n� �fdd�}��
� }z�� � |� W �� � ��
|� n
�� � ��
|� w t�� }t� dd�}|du r�tjdt�� 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.<locals>.<lambda>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� printErrors�writeln� separator�testsRun�write� printSummaryrQ ) rc re rx � startTime�singlerf 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, �<module> sV 1
$ &%