File: //proc/self/root/lib/python3/dist-packages/twisted/trial/test/__pycache__/test_tests.cpython-38.pyc
U
W[n� � @ s� d Z ddlmZmZ ddlZddlZddlZddlZddl m
Z
m Z ddl m
Z
ddlmZmZ ddlmZmZmZ ddlmZ dd lmZ dd
lmZ dd lmZmZm Z G d d
� d
e �Z G dd� de �Z G dd� de ej �Z!G dd� de ej"�Z#G dd� de �Z$G dd� de$ej �Z%G dd� de$ej"�Z&G dd� de �Z'G d d � d e'ej �Z(G d d � d e'ej"�Z)G d d!� d!e �Z*G d"d#� d#e*ej �Z+G d$d%� d%e*ej"�Z,G d&d'� d'e �Z-G d(d)� d)e-ej �Z.G d*d+� d+e-ej"�Z/G d,d-� d-e �Z0G d.d/� d/e0ej �Z1G d0d1� d1e0ej"�Z2G d2d3� d3ej �Z3G d4d5� d5e �Z4G d6d7� d7e4ej �Z5G d8d9� d9e4ej"�Z6G d:d;� d;eej"�Z7G d<d=� d=e �Z8G d>d?� d?e8ej �Z9G d@dA� dAe8ej �Z:G dBdC� dCej �Z;G dDdE� dEe �Z<G dFdG� dGe<ej �Z=G dHdI� dIe<ej"�Z>G dJdK� dKe �Z?G dLdM� dMe?ej �Z@G dNdO� dOe?ej"�ZAG dPdQ� dQe �ZBG dRdS� dSeBej �ZCG dTdU� dUeBej"�ZDG dVdW� dWe �ZEG dXdY� dYeEej �ZFG dZd[� d[eEej"�ZGG d\d]� d]e �ZHG d^d_� d_eHej �ZIG d`da� daeHej"�ZJG dbdc� dcej �ZKdS )da�
Tests for the behaviour of unit tests.
Many tests in this module follow a simple pattern. A mixin is defined which
includes test methods for a certain feature. The mixin is inherited from twice,
once by a class also inheriting from SynchronousTestCase and once from a class
inheriting from TestCase. These two subclasses are named like
I{SynchronousFooTests} and I{AsynchronousFooTests}, where I{Foo} is related to
the name of the mixin. Sometimes the mixin is defined in another module, along
with the synchronous subclass. The mixin is imported into this module to define
the asynchronous subclass.
This pattern allows the same tests to be applied to the two base test case
classes trial provides, ensuring their behavior is the same.
Most new tests should be added in this pattern. Tests for functionality which
is intentionally only provided by TestCase, not SynchronousTestCase, is excepted
of course.
� )�division�absolute_importN)�NativeStringIO�_PY3)�namedAny)�defer�reactor)�unittest�reporter�util)�runner)� erroneous)�SuppressionMixin)� _clearSuite� _ForceGarbageCollectionDecorator�
_iterateTestsc @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �ResultsTestMixinzG
Provide useful APIs for test cases that are about test cases.
c C s& t �� | _| j�|�| _t�� | _dS )zt
Load tests from the given test case class and create a new reporter to
use for running it.
N)�pyunit�
TestLoader�loader�loadTestsFromTestCase�suiter
�
TestResult��selfr � r �?/usr/lib/python3/dist-packages/twisted/trial/test/test_tests.py� loadSuite0 s
zResultsTestMixin.loadSuitec C sD | � | j�� � | �| jjg � | �| jjg � | �| jjg � dS )z
test the setup
N)�
assertTruer
�
wasSuccessful� assertEqual�errors�failures�skips�r r r r �
test_setUp9 s zResultsTestMixin.test_setUpc C s2 | � | j�� |� | �| j� | � | jj|� dS )z:
Asserts that the test count is plausible
N)r r �countTestCasesr
ZtestsRun)r ZnumTestsr r r � assertCountB s z ResultsTestMixin.assertCountN)�__name__�
__module__� __qualname__�__doc__r r% r' r r r r r , s r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )� SuccessMixinz\
Tests for the reporting of successful tests in L{twisted.trial.unittest.TestCase}.
c C s t �� | _dS ��%
Setup our test case
N)r
r �resultr$ r r r �setUpO s zSuccessMixin.setUpc C s dS )z9
A successful test, used by other tests.
Nr r$ r r r �test_successfulU s z SuccessMixin.test_successfulc C sX | � |jd� | � |jg � | � |jg � | � |jg � | � |jg � | � |jg � dS )zd
Utility function -- assert there is one success and the state is
plausible
� N)r � successesr" r! �expectedFailures�unexpectedSuccessesr# �r �testr/ r r r �assertSuccessfulZ s z SuccessMixin.assertSuccessfulc C s( | � d�}|�| j� | �|| j� dS )z�
Test that when a successful test is run, it is reported as a success,
and not as any other kind of result.
r1 N�� __class__�runr/ r8 �r r7 r r r �test_successfulIsReportedf s
z&SuccessMixin.test_successfulIsReportedc C s& | � � }|�| j� | �|| j� dS )zz
The test case type can be instantiated with no arguments, run, and
reported as being successful.
Nr9 r< r r r �test_defaultIsSuccessfulo s z%SuccessMixin.test_defaultIsSuccessfulc C sJ | � d�}t�|�}|�| j� | �|| j� ~t�� | �|� d� dS )zF
Test that no reference is kept on a successful test.
r1 N) r: �weakref�refr; r/ r8 �gc�collect�assertIdentical)r r7 r@ r r r �test_noReferencex s
z SuccessMixin.test_noReferenceN)
r( r) r* r+ r0 r1 r8 r= r> rD r r r r r, K s r, c @ s e Zd ZdZdS )�SynchronousSuccessTests�N
Tests for the reporting of successful tests in the synchronous case.
N�r( r) r* r+ r r r r rE � s rE c @ s e Zd ZdZdS )�AsynchronousSuccessTestsrF NrG r r r r rH � s rH c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�SkipMethodsMixinzZ
Tests for the reporting of skipping tests in L{twisted.trial.unittest.TestCase}.
c C s | � | j� dS r- )r �Skippingr$ r r r r0 � s zSkipMethodsMixin.setUpc C s | � d� dS )z4
Assert that there are three tests.
� N�r' r$ r r r �
test_counting� s z SkipMethodsMixin.test_countingc C sd | � | j� | �| j�� � | �| jjg � | �| jjg � | �t| jj�d� | �| jj d� dS )z�
Running a suite in which all methods are individually set to skip
produces a successful result with no recorded errors or failures, all
the skipped methods recorded as skips, and no methods recorded as
successes.
rK r N�
r r
r r r r! r" �lenr# r3 r$ r r r � test_results� s z SkipMethodsMixin.test_resultsc C sp | � | j� | �| j� | �| j�� � | �| jjg � | �| jjg � | �t | jj
�d� | �| jj d� dS )a
Running a suite in which all methods are skipped by C{setUp} raising
L{SkipTest} produces a successful result with no recorded errors or
failures, all skipped methods recorded as skips, and no methods recorded
as successes.
� r N) r �
SkippingSetUpr r
r r r r! r" rO r# r3 r$ r r r r% � s zSkipMethodsMixin.test_setUpc C sF | � | j� d}| jjD ](\}}| �|�� t|�d� t|�� qdS )z(
Test that reasons work
Ztest_N)r r
r# r ZshortDescriptionrO �str)r �prefixr7 �reasonr r r � test_reasons� s �z SkipMethodsMixin.test_reasonsc C sd | � | j� | �| j� | �| jjg�}| �dt|�� | �t|d d � | �d|d d � dS )zo
If a test method raises L{SkipTest} with no reason, a deprecation
warning is emitted.
r2 r �categoryzSDo not raise unittest.SkipTest with no arguments! Give a reason for skipping tests!�messageN) r �DeprecatedReasonlessSkipr r
Z
flushWarningsZtest_1r rO �DeprecationWarning)r �warningsr r r � test_deprecatedSkipWithoutReason� s �
�z1SkipMethodsMixin.test_deprecatedSkipWithoutReasonN)
r( r) r* r+ r0 rM rP r% rV r\ r r r r rI � s rI c @ s( e Zd ZdZed�Zed�Zed�ZdS )�SynchronousSkipMethodTestsz�
Tests for the reporting of skipping tests in the synchronous case.
See: L{twisted.trial.test.test_tests.SkipMethodsMixin}
z/twisted.trial.test.skipping.SynchronousSkippingz4twisted.trial.test.skipping.SynchronousSkippingSetUpz?twisted.trial.test.skipping.SynchronousDeprecatedReasonlessSkipN�r( r) r* r+ r rJ rR rY r r r r r] � s ��r] c @ s( e Zd ZdZed�Zed�Zed�ZdS )�AsynchronousSkipMethodTestsz�
Tests for the reporting of skipping tests in the asynchronous case.
See: L{twisted.trial.test.test_tests.SkipMethodsMixin}
z0twisted.trial.test.skipping.AsynchronousSkippingz5twisted.trial.test.skipping.AsynchronousSkippingSetUpz@twisted.trial.test.skipping.AsynchronousDeprecatedReasonlessSkipNr^ r r r r r_ � s ��r_ c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�SkipClassesMixinzQ
Test the class skipping features of L{twisted.trial.unittest.TestCase}.
c C s | � | j� d| j_dS )r. FN)r � SkippedClass� _setUpRanr$ r r r r0 � s zSkipClassesMixin.setUpc C s | � d� dS )zP
Skipped test methods still contribute to the total test count.
� NrL r$ r r r rM � s z SkipClassesMixin.test_countingc C s | � | j� | �| jj� dS )zP
The C{setUp} method is not called if the class is set to skip.
N)r r
� assertFalsera rb r$ r r r �
test_setUpRan s z SkipClassesMixin.test_setUpRanc C sd | � | j� | �| j�� � | �| jjg � | �| jjg � | �t| jj�d� | �| jj d� dS )a
Skipped test methods don't cause C{wasSuccessful} to return C{False},
nor do they contribute to the C{errors} or C{failures} of the reporter,
or to the count of successes. They do, however, add elements to the
reporter's C{skips} list.
rc r NrN r$ r r r rP s z SkipClassesMixin.test_resultsc C s: | � | j� ddddg}dd� | jjD �}| �||� dS )z�
Test methods which raise L{unittest.SkipTest} or have their C{skip}
attribute set to something are skipped.
�classZskip2c S s g | ] \}}|�qS r r )�.0r7 rU r r r �
<listcomp>" s z1SkipClassesMixin.test_reasons.<locals>.<listcomp>N)r r
r# r �r �expectedReasonsZ reasonsGivenr r r rV s z SkipClassesMixin.test_reasonsN) r( r) r* r+ r0 rM re rP rV r r r r r` � s r` c @ s e Zd ZdZed�ZdS )�SynchronousSkipClassTestsz
Test the class skipping features in the synchronous case.
See: L{twisted.trial.test.test_tests.SkipClassesMixin}
z3twisted.trial.test.skipping.SynchronousSkippedClassN�r( r) r* r+ r ra r r r r rk ' s �rk c @ s e Zd ZdZed�ZdS )�AsynchronousSkipClassTestsz�
Test the class skipping features in the asynchronous case.
See: L{twisted.trial.test.test_tests.SkipClassesMixin}
z4twisted.trial.test.skipping.AsynchronousSkippedClassNrl r r r r rm 2 s �rm c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dS )� TodoMixinzv
Tests for the individual test method I{expected failure} features of
L{twisted.trial.unittest.TestCase}.
c C s | � | j� dS r- )r �Todor$ r r r r0 B s zTodoMixin.setUpc C s | � d� dS )z9
Ensure that we've got three test cases.
rK NrL r$ r r r rM H s zTodoMixin.test_countingc C s� | � | j� | �| j�� � | �| jjg � | �| jjg � | �| jjg � | �t| jj �d� | �t| jj
�d� | �| jj d� dS )a�
Running a suite in which all methods are individually marked as expected
to fail produces a successful result with no recorded errors, failures,
or skips, all methods which fail and were expected to fail recorded as
C{expectedFailures}, and all methods which pass but which were expected
to fail recorded as C{unexpectedSuccesses}. Additionally, no tests are
recorded as successes.
rQ r2 r N� r r
r r r r! r" r# rO r4 r5 r3 r$ r r r rP N s zTodoMixin.test_resultsc C s6 | � | j� ddg}dd� | jjD �}| �||� dS )�E
Ensure that expected failures are handled properly.
�todo1�todo2c S s g | ]\}}}|j �qS r �rU �rg �t�e�rr r r rh f s �z3TodoMixin.test_expectedFailures.<locals>.<listcomp>N�r r
r4 r ri r r r �test_expectedFailures` s �z TodoMixin.test_expectedFailuresc C s4 | � | j� dg}dd� | jjD �}| �||� dS )�>
Ensure that unexpected successes are caught.
Ztodo3c S s g | ]\}}|j �qS r rt �rg rv rx r r r rh p s �z6TodoMixin.test_unexpectedSuccesses.<locals>.<listcomp>N�r r
r5 r ri r r r �test_unexpectedSuccessesj s �z"TodoMixin.test_unexpectedSuccessesc C s� | � | j� | �| j� | �| j�� � | �t| jj�d� | �| jj g � | �| jj
g � | �t| jj �d� | �t| jj �d� | �| jj
d� dS )z|
C{setUp} is excluded from the failure expectation defined by a C{todo}
attribute on a test method.
r2 r N)r � SetUpTodor r
rd r r rO r! r" r# r4 r5 r3 r$ r r r �test_expectedSetUpFailuret s z#TodoMixin.test_expectedSetUpFailurec C s� | � | j� | �| j� | �| j�� � | �t| jj�d� | �| jj g � | �| jj
g � | �t| jj �d� | �t| jj �d� | �| jj
d� dS )z
C{tearDown} is excluded from the failure expectation defined by a C{todo}
attribute on a test method.
r2 r N)r � TearDownTodor r
rd r r rO r! r" r# r4 r5 r3 r$ r r r � test_expectedTearDownFailure� s z&TodoMixin.test_expectedTearDownFailureN) r( r) r* r+ r0 rM rP rz r~ r� r� r r r r rn = s
rn c @ s( e Zd ZdZed�Zed�Zed�ZdS )�SynchronousTodoTestszx
Test the class skipping features in the synchronous case.
See: L{twisted.trial.test.test_tests.TodoMixin}
z+twisted.trial.test.skipping.SynchronousTodoz0twisted.trial.test.skipping.SynchronousSetUpTodoz3twisted.trial.test.skipping.SynchronousTearDownTodoN�r( r) r* r+ r ro r r� r r r r r� � s �r� c @ s( e Zd ZdZed�Zed�Zed�ZdS )�AsynchronousTodoTestszy
Test the class skipping features in the asynchronous case.
See: L{twisted.trial.test.test_tests.TodoMixin}
z,twisted.trial.test.skipping.AsynchronousTodoz1twisted.trial.test.skipping.AsynchronousSetUpTodoz4twisted.trial.test.skipping.AsynchronousTearDownTodoNr� r r r r r� � s �r� c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�ClassTodoMixinzj
Tests for the class-wide I{expected failure} features of
L{twisted.trial.unittest.TestCase}.
c C s | � | j� dS r- )r � TodoClassr$ r r r r0 � s zClassTodoMixin.setUpc C s | � d� dS )z8
Ensure that we've got four test cases.
rc NrL r$ r r r rM � s z ClassTodoMixin.test_countingc C s� | � | j� | �| j�� � | �| jjg � | �| jjg � | �| jjg � | �t| jj �d� | �t| jj
�d� | �| jj d� dS )a�
Running a suite in which an entire class is marked as expected to fail
produces a successful result with no recorded errors, failures, or
skips, all methods which fail and were expected to fail recorded as
C{expectedFailures}, and all methods which pass but which were expected
to fail recorded as C{unexpectedSuccesses}. Additionally, no tests are
recorded as successes.
rQ r Nrp r$ r r r rP � s zClassTodoMixin.test_resultsc C s6 | � | j� ddg}dd� | jjD �}| �||� dS )rq �methodrf c S s g | ]\}}}|j �qS r rt ru r r r rh � s �z8ClassTodoMixin.test_expectedFailures.<locals>.<listcomp>Nry ri r r r rz � s �z$ClassTodoMixin.test_expectedFailuresc C s6 | � | j� ddg}dd� | jjD �}| �||� dS )r{ r� rf c S s g | ]\}}|j �qS r rt r| r r r rh � s �z;ClassTodoMixin.test_unexpectedSuccesses.<locals>.<listcomp>Nr} ri r r r r~ � s �z'ClassTodoMixin.test_unexpectedSuccessesN� r( r) r* r+ r0 rM rP rz r~ r r r r r� � s
r� c @ s e Zd ZdZed�ZdS )�SynchronousClassTodoTestsz�
Tests for the class-wide I{expected failure} features in the synchronous case.
See: L{twisted.trial.test.test_tests.ClassTodoMixin}
z0twisted.trial.test.skipping.SynchronousTodoClassN�r( r) r* r+ r r� r r r r r� � s r� c @ s e Zd ZdZed�ZdS )�AsynchronousClassTodoTestsz�
Tests for the class-wide I{expected failure} features in the asynchronous case.
See: L{twisted.trial.test.test_tests.ClassTodoMixin}
z1twisted.trial.test.skipping.AsynchronousTodoClassNr� r r r r r� � s r� c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�StrictTodoMixinz�
Tests for the I{expected failure} features of
L{twisted.trial.unittest.TestCase} in which the exact failure which is
expected is indicated.
c C s | � | j� dS r- )r �
StrictTodor$ r r r r0 s zStrictTodoMixin.setUpc C s | � d� dS )z3
Assert there are seven test cases
� NrL r$ r r r rM
s z StrictTodoMixin.test_countingc C s� | � | j� | �| j�� � | �t| jj�d� | �t| jj�d� | �t| jj�d� | �t| jj �d� | �| jj
d� | �| jj g � dS )z�
A test method which is marked as expected to fail with a particular
exception is only counted as an expected failure if it does fail with
that exception, not if it fails with some other exception.
rQ r2 rK r N) r r
rd r r rO r! r" r4 r5 r3 r# r$ r r r rP s z StrictTodoMixin.test_resultsc C s8 | � | j� dddg}dd� | jjD �}| �||� dS )rq rr rs Ztodo5c S s g | ]\}}}|j �qS r rt ru r r r rh % s �z9StrictTodoMixin.test_expectedFailures.<locals>.<listcomp>Nry �r rj Z
reasonsGottenr r r rz s
�z%StrictTodoMixin.test_expectedFailuresc C s: | � | j� tgdfg}dd� | jjD �}| �||� dS )r{ Ztodo7c S s g | ]\}}|j |jf�qS r )r! rU r| r r r rh / s �z<StrictTodoMixin.test_unexpectedSuccesses.<locals>.<listcomp>N)r r
� RuntimeErrorr5 r r� r r r r~ ) s �z(StrictTodoMixin.test_unexpectedSuccessesNr� r r r r r� � s
r� c @ s e Zd ZdZed�ZdS )�SynchronousStrictTodoTestsz�
Tests for the expected failure case when the exact failure that is expected
is indicated in the synchronous case
See: L{twisted.trial.test.test_tests.StrictTodoMixin}
z1twisted.trial.test.skipping.SynchronousStrictTodoN�r( r) r* r+ r r� r r r r r� 5 s r� c @ s e Zd ZdZed�ZdS )�AsynchronousStrictTodoTestsz�
Tests for the expected failure case when the exact failure that is expected
is indicated in the asynchronous case
See: L{twisted.trial.test.test_tests.StrictTodoMixin}
z2twisted.trial.test.skipping.AsynchronousStrictTodoNr� r r r r r� @ s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �ReactorCleanupTestszc
Tests for cleanup and reporting of reactor event sources left behind by test
methods.
c C s t �t� �| _t�� | _dS r- )r
�Reporterr r/ r r r r$ r r r r0 Q s zReactorCleanupTests.setUpc C s^ | j �d�}|�| j� | �| j�� � | �| jjd� | jjd d }| � |�
t j �� dS )zm
Trial reports a L{util.DirtyReactorAggregateError} if a test leaves
sockets behind.
z@twisted.trial.test.erroneous.SocketOpenTest.test_socketsLeftOpenr2 r N)
r Z
loadByNamer; r/ rd r r r3 r! r �checkr �DirtyReactorAggregateError�r r Zfailurer r r �test_leftoverSocketsY s � z(ReactorCleanupTests.test_leftoverSocketsc C s\ t �d�}|�| j� | �| j�� � | jjd d }| �| jjd� | � |�
t j �� dS )z�
Trial reports a L{util.DirtyReactorAggregateError} and fails the test
if a test leaves a L{DelayedCall} hanging.
�test_leftoverPendingCallsr r2 N)
r
r� r; r/ rd r r! r r3 r r� r r� r� r r r r� j s
z-ReactorCleanupTests.test_leftoverPendingCallsN)r( r) r* r+ r0 r� r� r r r r r� K s r� c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) � FixtureMixinzB
Tests for fixture helper methods (e.g. setUp, tearDown).
c C s t �� | _ t�� | _dS r- )r
r� r r r r$ r r r r0 | s
zFixtureMixin.setUpc C s` | j �| j�}|�| j� | �t| jj�dk� | �| jjd d j t
j � | � d| jj
� dS )zO
When setUp fails, the error is recorded in the result object.
r r2 N)r r �TestFailureInSetUpr; r
r rO r! �assertIsInstance�valuer
� FoolishErrorr r3 r r r r �test_brokenSetUp� s �z FixtureMixin.test_brokenSetUpc C s` | j �| j�}|�| j� | jj}| �t|�dk� | �|d d j t
j � | � d| jj
� dS )zR
When tearDown fails, the error is recorded in the result object.
r r2 N)r r �TestFailureInTearDownr; r
r! r rO r� r� r
r� r r3 )r r r! r r r �test_brokenTearDown� s z FixtureMixin.test_brokenTearDownc C s� | j �| j�}t|�d }| �|j� |�| j� | jj}| � t
|�dk� | � |d d j t
j� | �d| jj� | � |j� dS )zP
L{SynchronousTestCase.tearDown} runs when a test method fails.
r r2 N)r r �TestFailureButTearDownRuns�listrd ZtornDownr; r
r! r rO r� r� r
r� r r3 )r r Zcaser! r r r � test_tearDownRunsOnTestFailure� s � z+FixtureMixin.test_tearDownRunsOnTestFailureN)r( r) r* r+ r0 r� r� r� r r r r r� x s
r� c @ s( e Zd ZdZed�Zed�Zed�ZdS )�SynchronousFixtureTestsz�
Tests for broken fixture helper methods in the synchronous case
See: L{twisted.trial.test.test_tests.FixtureMixin}
z:twisted.trial.test.erroneous.SynchronousTestFailureInSetUpz=twisted.trial.test.erroneous.SynchronousTestFailureInTearDownzBtwisted.trial.test.erroneous.SynchronousTestFailureButTearDownRunsN�r( r) r* r+ r r� r� r� r r r r r� � s ���r� c @ s( e Zd ZdZed�Zed�Zed�ZdS )�AsynchronousFixtureTestsz�
Tests for broken fixture helper methods in the asynchronous case
See: L{twisted.trial.test.test_tests.FixtureMixin}
z;twisted.trial.test.erroneous.AsynchronousTestFailureInSetUpz>twisted.trial.test.erroneous.AsynchronousTestFailureInTearDownzCtwisted.trial.test.erroneous.AsynchronousTestFailureButTearDownRunsNr� r r r r r� � s ���r� c @ s0 e Zd ZdZed�Zed�Zed�Zed�ZdS )� AsynchronousSuppressionTestsz�
Tests for the warning suppression features of
L{twisted.trial.unittest.TestCase}
See L{twisted.trial.test.test_suppression.SuppressionMixin}
z?twisted.trial.test.suppression.AsynchronousTestSetUpSuppressionzBtwisted.trial.test.suppression.AsynchronousTestTearDownSuppressionz:twisted.trial.test.suppression.AsynchronousTestSuppressionz;twisted.trial.test.suppression.AsynchronousTestSuppression2N) r( r) r* r+ r ZTestSetUpSuppressionZTestTearDownSuppressionZTestSuppressionZTestSuppression2r r r r r� � s ����r� c @ sB e Zd ZdZG dd� dej�Zdd� Zdd� Zdd � Z d
d � Z
d S )
�GCMixinz�
I provide a few mock tests that log setUp, tearDown, test execution and
garbage collection. I'm used to test whether gc.collect gets called.
c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) zGCMixin.BasicTestz#
Mock test to run.
c C s | � d� dS )z$
Mock setUp
r0 N��_logr$ r r r r0 � s zGCMixin.BasicTest.setUpc C s | � d� dS )z(
Mock test case
r7 Nr� r$ r r r �test_foo� s zGCMixin.BasicTest.test_fooc C s | � d� dS )z,
Mock tear tearDown
�tearDownNr� r$ r r r r� � s zGCMixin.BasicTest.tearDownN)r( r) r* r+ r0 r� r� r r r r � BasicTest� s r� c C s | j �|� dS )z
Log function
N)�_collectCalled�append)r �msgr r r r� � s z GCMixin._logc C s | � d� dS )zFake gc.collectrB Nr� r$ r r r rB � s zGCMixin.collectc C s$ g | _ | j| j_tj| _| jt_dS r- )r� r� r� rA rB � _oldCollectr$ r r r r0 s
z
GCMixin.setUpc C s | j t_dS �z$
Tear down the test
N)r� rA rB r$ r r r r� s zGCMixin.tearDownN) r( r) r* r+ r �SynchronousTestCaser� r� rB r0 r� r r r r r� � s r� c @ s e Zd ZdZdd� ZdS )� GarbageCollectionDefaultTestsz@
By default, tests should not force garbage collection.
c C s4 | � d�}t�� }|�|� | �| jdddg� dS )zH
By default, tests should not force garbage collection.
r� r0 r7 r� N)r� r
r r; r r� r6 r r r �test_collectNotDefault s
z4GarbageCollectionDefaultTests.test_collectNotDefaultN)r( r) r* r+ r� r r r r r� s r� c @ s e Zd ZdZdd� ZdS )�GarbageCollectionTestsz-
Test that, when force GC, it works.
c C s@ t �d�}t|�}t�� }|�|� | �| jdddddg� dS )zG
test gc.collect is called before and after each test.
r� rB r0 r7 r� N)r� r� r r
r r; r r� r6 r r r �test_collectCalled' s
�z)GarbageCollectionTests.test_collectCalledN)r( r) r* r+ r� r r r r r� # s r� c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �UnhandledDeferredTestsz\
Test what happens when we have an unhandled deferred left around after
a test.
c C s( ddl m} t�� t|�d��| _dS )r. r )�weirdZtest_unhandledDeferredN)�twisted.trial.testr� rA �disabler Z TestBleeding�test1)r r� r r r r0 : s
�z UnhandledDeferredTests.setUpc C s* t �� }| �|� | �t|j�dd� dS )zo
Forcing garbage collection should cause unhandled Deferreds to be
reported as errors.
r2 z(Unhandled deferred passed without noticeN)r
r r� r rO r! )r r/ r r r �test_isReportedD s
�z&UnhandledDeferredTests.test_isReportedc C s^ t �� }| �|� | �� tr*ttj�}nt�� }| � |dd� | �� }| � t|�dd� dS )z�
Forcing garbage collection in the test should mean that there are
no unreachable cycles immediately after the test completes.
r z unreachable cycle still existedz Errors logged after gc.collectN)
r
r r� �flushLoggedErrorsr rO rA ZgarbagerB r )r r/ �n�xr r r �test_doesntBleedN s
z'UnhandledDeferredTests.test_doesntBleedc C s t �� t �� | �� dS r� )rA rB �enabler� r$ r r r r� a s z UnhandledDeferredTests.tearDownN)r( r) r* r+ r0 r� r� r� r r r r r� 4 s
r� c sP e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
� Z S )�AddCleanupMixinz1
Test the addCleanup method of TestCase.
c s& t t| ��� t�� | _| �� | _dS r- )�superr� r0 r
r r/ �
AddCleanupr7 r$ �r: r r r0 n s
zAddCleanupMixin.setUpc C sD | j j| j _| j �| j jd� | j �| j� | �ddg| j j� dS )zQ
Callables added with C{addCleanup} are run even if setUp fails.
�foor0 N) r7 Z brokenSetUpr0 �
addCleanupr� r; r/ r �logr$ r r r �!test_addCleanupCalledIfSetUpFailsv s z1AddCleanupMixin.test_addCleanupCalledIfSetUpFailsc C sD | j j| j _| j �| j jd� | j �| j� | �ddg| j j� dS )z�
Callables added with C{addCleanup} are run even if setUp raises
L{SkipTest}. This allows test authors to reliably provide clean up
code using C{addCleanup}.
r� r0 N) r7 Z
skippingSetUpr0 r� r� r; r/ r r� r$ r r r �!test_addCleanupCalledIfSetUpSkips s z1AddCleanupMixin.test_addCleanupCalledIfSetUpSkipsc C sP | j �| j jd� | j �| j jd� | j �| j� | �dddddg| j j� dS )z~
Callables added with C{addCleanup} should be called before C{tearDown}
in reverse order of addition.
r� �barr0 �runTestr� N�r7 r� r� r; r/ r r� r$ r r r �#test_addCleanupCalledInReverseOrder� s �z3AddCleanupMixin.test_addCleanupCalledInReverseOrderc C st | j �| j jd� | j �| j� | �| j�� � | �dt| jj �� | jj \\}}| �|| j � | �|�
� d� dS )z�
Errors raised in cleanup functions should be treated like errors in
C{tearDown}. They should be added as errors and fail the test. Skips,
todos and failures are all treated as errors.
r� r2 N) r7 r� �failr; r/ rd r r rO r! �getErrorMessage�r r7 �errorr r r � test_errorInCleanupIsCaptured� s z-AddCleanupMixin.test_errorInCleanupIsCapturedc C s� | j �| j jd� | j �| j jd� | j �| j� | �ddddg| j j� | �dt| jj �� | jj \\}}| �|| j � | �|�
� d� dS )zq
If a cleanup raises an error then that does not stop the other
cleanups from being run.
r� r� r0 r� r� r2 N) r7 r� r� r� r; r/ r r� rO r! r� r� r r r �&test_cleanupsContinueRunningAfterError� s �z6AddCleanupMixin.test_cleanupsContinueRunningAfterErrorc C s� | j �| j jd� | j �| j jd� | j �| j� | �dddg| j j� | �dt| jj�� | jj\\}}\}}| �|| j � | �|| j � | �|� � d� | �|� � d� dS )zm
If more than one cleanup fails, then the test should fail with more
than one error.
r� r� r0 r� r� rQ N)
r7 r� r� r; r/ r r� rO r! r� )r r� Zerror1Ztest2Zerror2r r r �test_multipleErrorsReported� s �z+AddCleanupMixin.test_multipleErrorsReported) r( r) r* r+ r0 r� r� r� r� r� r� �
__classcell__r r r� r r� j s r� c @ s e Zd ZdZed�ZdS )�SynchronousAddCleanupTestsz�
Test the addCleanup method of TestCase in the synchronous case
See: L{twisted.trial.test.test_tests.AddCleanupMixin}
z1twisted.trial.test.skipping.SynchronousAddCleanupN)r( r) r* r+ r r� r r r r r� � s r� c @ s e Zd ZdZed�Zdd� ZdS )�AsynchronousAddCleanupTestsz�
Test the addCleanup method of TestCase in the asynchronous case
See: L{twisted.trial.test.test_tests.AddCleanupMixin}
z2twisted.trial.test.skipping.AsynchronousAddCleanupc sX � fdd�}� j �� j jd� � j �|d� � j �� j� � �dddddg� j j� dS ) z�
If an added callable returns a L{Deferred}, then the test should wait
until that L{Deferred} has fired before running the next cleanup
method.
c s& t �� }t�d|j| � |�� jj�S )Nr )r ZDeferredr Z callLater�callbackZ addCallbackr7 r� )rX �dr$ r r �cleanup� s zMAsynchronousAddCleanupTests.test_addCleanupWaitsForDeferreds.<locals>.cleanupr� r� r0 r� r� Nr� )r r� r r$ r � test_addCleanupWaitsForDeferreds� s �z<AsynchronousAddCleanupTests.test_addCleanupWaitsForDeferredsN)r( r) r* r+ r r� r� r r r r r� � s r� c @ s e Zd ZdZdd� Zdd� ZdS )�SuiteClearingMixinzM
Tests for our extension that allows us to clear out a L{TestSuite}.
c C sB t �� }|�| �� � | �d|�� � t|� | �d|�� � dS )z_
Calling L{_clearSuite} on a populated L{TestSuite} removes
all tests.
r2 r N)r � TestSuite�addTest�TestCaser r& r r r r r �test_clearSuite� s
z"SuiteClearingMixin.test_clearSuitec C sJ t d�}|�� }|�| �� � | �d|�� � t|� | �d|�� � dS )z�
Calling L{_clearSuite} on a populated standard library
L{TestSuite} removes all tests.
This test is important since C{_clearSuite} operates by mutating
internal variables.
r r2 r N)�
__import__r� r� r� r r& r )r r r r r r �test_clearPyunitSuite� s z(SuiteClearingMixin.test_clearPyunitSuiteN)r( r) r* r+ r� r� r r r r r� � s
r� c @ s e Zd ZdZejZdS )� SynchronousSuiteClearingTestsz�
Tests for our extension that allows us to clear out a L{TestSuite} in the
synchronous case.
See L{twisted.trial.test.test_tests.SuiteClearingMixin}
N�r( r) r* r+ r r� r� r r r r r� s r� c @ s e Zd ZdZejZdS )� AsynchronousSuiteClearingTestsz�
Tests for our extension that allows us to clear out a L{TestSuite} in the
asynchronous case.
See L{twisted.trial.test.test_tests.SuiteClearingMixin}
N�r( r) r* r+ r r� r r r r r� s r� c @ sh e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS )�TestDecoratorMixinz1
Tests for our test decoration features.
c C s^ | � |j|jd� t|dd�}t|dd�}| �||� || krJdkrZn n | �||� dS )zB
Assert that the given decorated tests are equal.
�Different classZ
_originalTestN)r r: �getattrrC )r �observed�expectedZobservedOriginalZexpectedOriginalr r r �assertTestsEqual# s � z#TestDecoratorMixin.assertTestsEqualc C sr | � |j|jd� | � t|j�t|j�d� t|j|j�D ]2\}}t|dd�dk r`| �||� q:| �||� q:dS )zS
Assert that the given test suites with decorated tests are equal.
r� zDifferent number of tests.�_testsN)r r: rO r� �zipr� �assertSuitesEqualr� )r r� r� Z observedTestZ expectedTestr r r r� / s ��� z$TestDecoratorMixin.assertSuitesEqualc C s@ | � � }t�|�}ddlm} |� }|�|� | �|j|� dS )z�
For decorated tests, C{run} uses a result adapter that preserves the
test decoration for calls to C{addError}, C{startTest} and the like.
See L{reporter._AdaptedReporter}.
r ��LoggingReporterN)r� r �
TestDecorator� twisted.trial.test.test_reporterr� r; r� r7 �r r7 �
decoratedTestr� r/ r r r � test_usesAdaptedReporterWithRun> s
z2TestDecoratorMixin.test_usesAdaptedReporterWithRunc C s> | � � }t�|�}ddlm} |� }||� | �|j|� dS )z�
For decorated tests, C{__call__} uses a result adapter that preserves
the test decoration for calls to C{addError}, C{startTest} and the
like.
See L{reporter._AdaptedReporter}.
r r� N)r� r r� r� r� r� r7 r� r r r � test_usesAdaptedReporterWithCallM s
z3TestDecoratorMixin.test_usesAdaptedReporterWithCallc C s, | � � }t�|tj�}| �t�|�|� dS )z�
Calling L{decorate} on a single test case returns the test case
decorated with the provided decorator.
N�r� r �decorater� r� )r r7 r� r r r �test_decorateSingleTest] s z*TestDecoratorMixin.test_decorateSingleTestc C s@ | � � }t�|g�}t�|tj�}| �|t�t�|�g�� dS )z�
Calling L{decorate} on a test suite will return a test suite with
each test decorated with the provided decorator.
N�r� r r� r� r� r� �r r7 r r� r r r �test_decorateTestSuitef s �z)TestDecoratorMixin.test_decorateTestSuitec C sZ | � � }t�|g�}t�|tj�}| �|t�t�|�g�� | �|t�t�|�g�� dS )zU
Calling L{decorate} on a test suite will mutate the original suite.
Nr r r r r �#test_decorateInPlaceMutatesOriginalq s � � �z6TestDecoratorMixin.test_decorateInPlaceMutatesOriginalc C s` t tdd�}|dkr t�d��| �� }t�|g�}||�}t�|tj� ||�}| �||� dS )ac
When decorating a test suite in-place, the number of references to the
test objects in that test suite should stay the same.
Previously, L{unittest.decorate} recreated a test suite, so the
original suite kept references to the test objects. This test is here
to ensure the problem doesn't reappear again.
� getrefcountNz*getrefcount not supported on this platform) r� �sysr ZSkipTestr� r� r� r� r )r r r7 r Zcount1Zcount2r r r � test_decorateTestSuiteReferences~ s � z3TestDecoratorMixin.test_decorateTestSuiteReferencesc C sT | � � }t�t�|g�g�}t�|tj�}t�t�t�|�g�g�}| �||� dS )z�
Calling L{decorate} on a test suite with nested suites will return a
test suite that maintains the same structure, but with all tests
decorated.
Nr )r r7 r r� r� r r r � test_decorateNestedTestSuite� s �z/TestDecoratorMixin.test_decorateNestedTestSuitec C s: | � � }t�|tj�}t�|tj�}| �|t�|�� dS )z�
Calling L{decorate} on a test suite with already-decorated tests
decorates all of the tests in the suite again.
Nr� )r r7 r� ZredecoratedTestr r r �test_decorateDecoratedSuite� s ��z.TestDecoratorMixin.test_decorateDecoratedSuitec C s@ | � � }t�|g�}t�|tj�}| �|t�t�|�g�� dS )z�
Tests can be in non-standard suites. L{decorate} preserves the
non-standard suites when it decorates the tests.
N)r� r ZDestructiveTestSuiter r� r� r� )r r7 r Z decoratedr r r �test_decoratePreservesSuite� s �z.TestDecoratorMixin.test_decoratePreservesSuiteN)r( r) r* r+ r� r� r� r� r� r r r r r r r r r r r� s
r� c @ s e Zd ZdZejZdS )� SynchronousTestDecoratorTestsz�
Tests for our test decoration features in the synchronous case.
See L{twisted.trial.test.test_tests.TestDecoratorMixin}
Nr� r r r r r
� s r
c @ s e Zd ZdZejZdS )� AsynchronousTestDecoratorTestsz�
Tests for our test decoration features in the asynchronous case.
See L{twisted.trial.test.test_tests.TestDecoratorMixin}
Nr� r r r r r � s r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�MonkeyPatchMixinzF
Tests for the patch() helper method in L{unittest.TestCase}.
c C s" d| _ d| _| j | _| �� | _dS )r. ZoriginalZpatchedN)�
originalValue� patchedValue�
objectToPatchr� r7 r$ r r r r0 � s zMonkeyPatchMixin.setUpc C s& | j �| d| j� | �| j| j� dS )zi
Calling C{patch()} on a test monkey patches the specified object and
attribute.
r N)r7 �patchr r r r$ r r r �
test_patch� s zMonkeyPatchMixin.test_patchc C s6 | j �| d| j� | j �t�� � | �| j| j� dS )zw
Any monkey patches introduced by a test using C{patch()} are reverted
after the test has run.
r N) r7 r r r; r
r� r r r
r$ r r r �test_patchRestoredAfterRun� s z+MonkeyPatchMixin.test_patchRestoredAfterRunc C s. | j �| d| j�}|�� | �| j| j� dS )z�
C{patch()} return a L{monkey.MonkeyPatcher} object that can be used to
restore the original values before the end of the test.
r N)r7 r r �restorer r r
�r r r r r �test_revertDuringTest� s z&MonkeyPatchMixin.test_revertDuringTestc C s6 | j �| d| j�}|�� |�� | �| j| j� dS )zq
The returned L{monkey.MonkeyPatcher} object can re-apply the patch
during the test run.
r N)r7 r r r r r r r r r �test_revertAndRepatch� s z&MonkeyPatchMixin.test_revertAndRepatchc C sd | j �| d| j� | �| j| j� | j �| dd� | �| jd� | j �t�� � | �| j| j� dS )zW
Successive patches are applied and reverted just like a single patch.
r z second valueN) r7 r r r r r; r
r� r
r$ r r r �test_successivePatches� s z'MonkeyPatchMixin.test_successivePatchesN)
r( r) r* r+ r0 r r r r r r r r r r � s
r c @ s e Zd ZdZejZdS )�SynchronousMonkeyPatchTestsz�
Tests for the patch() helper method in the synchronous case.
See L{twisted.trial.test.test_tests.MonkeyPatchMixin}
Nr� r r r r r s r c @ s e Zd ZdZejZdS )� AsynchronousMonkeyPatchTestsz�
Tests for the patch() helper method in the asynchronous case.
See L{twisted.trial.test.test_tests.MonkeyPatchMixin}
Nr� r r r r r s r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �IterateTestsMixinz]
L{_iterateTests} returns a list of all test cases in a test suite or test
case.
c C s" | � � }| �|gtt|��� dS )zj
L{_iterateTests} on a single test case returns a list containing that
test case.
N)r� r r� r r< r r r �test_iterateTestCase s z&IterateTestsMixin.test_iterateTestCasec C s. | � � }t�|g�}| �|gtt|��� dS )z�
L{_iterateTests} on a test suite that contains a single test case
returns a list containing that test case.
N�r� r r� r r� r �r r7 r r r r � test_iterateSingletonTestSuite' s z0IterateTestsMixin.test_iterateSingletonTestSuitec C s6 | � � }t�t�|g�g�}| �|gtt|��� dS )zP
L{_iterateTests} returns tests that are in nested test suites.
Nr r r r r �test_iterateNestedTestSuite1 s z-IterateTestsMixin.test_iterateNestedTestSuitec C s: | � � }t�t�|g�| g�}| �|| gtt|��� dS )zU
L{_iterateTests} returns tests in left-to-right, depth-first order.
Nr r r r r �#test_iterateIsLeftToRightDepthFirst: s z5IterateTestsMixin.test_iterateIsLeftToRightDepthFirstN)r( r) r* r+ r r r r r r r r r s
r c @ s e Zd ZdZejZdS )� SynchronousIterateTestsTestsz�
Check that L{_iterateTests} returns a list of all test cases in a test suite
or test case for synchronous tests.
See L{twisted.trial.test.test_tests.IterateTestsMixin}
Nr� r r r r r! C s r! c @ s e Zd ZdZejZdS )� AsynchronousIterateTestsTestsz�
Check that L{_iterateTests} returns a list of all test cases in a test suite
or test case for asynchronous tests.
See L{twisted.trial.test.test_tests.IterateTestsMixin}
Nr� r r r r r" M s r" c @ s e Zd ZdZdd� Zdd� ZdS )�TrialGeneratorFunctionTestsz=
Tests for generator function methods in test cases.
c C s� G dd� dt j�}|d�}t�� }|�|� | �t|j�d� | �t|j�d� | � d|jd d j
j d � | � d|jd d j
j d � | � d|jd d j
j d � d S )
z�
In a TestCase, a test method which is a generator function is reported
as an error, as such a method will never run assertions.
c @ s e Zd ZdZdd� ZdS )zTTrialGeneratorFunctionTests.test_errorOnGeneratorFunction.<locals>.GeneratorTestCasez?
A fake TestCase for testing purposes.
c s s | � d� dV dS �zt
A method which is also a generator function, for testing
purposes.
z this should never be reachedN�r� r$ r r r �test_generatorh s
zcTrialGeneratorFunctionTests.test_errorOnGeneratorFunction.<locals>.GeneratorTestCase.test_generatorN�r( r) r* r+ r& r r r r �GeneratorTestCasec s r( r& r r2 z GeneratorTestCase.test_generatorz+GeneratorTestCase testMethod=test_generator�4is a generator function and therefore will never runN) r r� r
r r; r rO r" r! �assertInr� �args)r r( �testCaser/ r r r � test_errorOnGeneratorFunction] s
���z9TrialGeneratorFunctionTests.test_errorOnGeneratorFunctionc C s� G dd� dt j�}|d�}t�� }|�|� | �t|j�d� | �t|j�d� | � d|jd d j
j d � | � d|jd d j
j d � | � d|jd d j
j d � d S )
z�
In a SynchronousTestCase, a test method which is a generator function
is reported as an error, as such a method will never run assertions.
c @ s e Zd ZdZdd� ZdS )zrTrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunction.<locals>.GeneratorSynchronousTestCasezJ
A fake SynchronousTestCase for testing purposes.
c s s | � d� dV dS r$ r% r$ r r r r& � s
z�TrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunction.<locals>.GeneratorSynchronousTestCase.test_generatorNr' r r r r � GeneratorSynchronousTestCase� s r. r& r r2 z+GeneratorSynchronousTestCase.test_generatorz6GeneratorSynchronousTestCase testMethod=test_generatorr) N) r r� r
r r; r rO r" r! r* r� r+ )r r. r, r/ r r r �0test_synchronousTestCaseErrorOnGeneratorFunction| s
���zLTrialGeneratorFunctionTests.test_synchronousTestCaseErrorOnGeneratorFunctionN)r( r) r* r+ r- r/ r r r r r# X s r# )Lr+ Z
__future__r r rA r r? r r Ztwisted.python.compatr r Ztwisted.python.reflectr Ztwisted.internetr r Z
twisted.trialr
r r r� r
Z#twisted.trial.test.test_suppressionr Ztwisted.trial._asyncrunnerr r r �objectr r, r� rE r� rH rI r] r_ r` rk rm rn r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r
r r r r r r! r" r# r r r r �<module> sp :I
3 Z
9
7 -656[
#
= *