�
Ϫ�f6 � �h � d Z ddlmZ G d� dej � Z G d� dej � Zy)z3
Interfaces for Trial.
Maintainer: Jonathan Lange
� Nc �R � e Zd ZdZ ej
d� Zd� Zd� Zd� Z d� Z
d� Z y) � ITestCasezU
The interface that a test case must implement in order to be used in Trial.
z7The exception class that is raised by failed assertionsc � � y)zQ
Run the test. Should always do exactly the same thing as run().
N� ��results �6/usr/lib/python3/dist-packages/twisted/trial/itrial.py�__call__zITestCase.__call__ � � � c � � y)zJ
Return the number of tests in this test case. Usually 1.
Nr r r r �countTestCaseszITestCase.countTestCases r r c � � y)zk
Return a unique identifier for the test, usually the fully-qualified
Python name.
Nr r r r �idz ITestCase.id! r r c � � y)zj
Run the test, storing the results in C{result}.
@param result: A L{TestResult}.
Nr r s r �runz
ITestCase.run' r r c � � y)z9
Return a short description of the test.
Nr r r r �shortDescriptionzITestCase.shortDescription. r r N) �__name__�
__module__� __qualname__�__doc__�zi� Attribute�failureExceptionr
r r r r r r r r r s6 � �� $�r�|�|�A��� �
�
� � r r c � � e Zd ZdZ ej
d� Z ej
d� Zd� Zd� Z d� Z
d� Z d� Z dd
�Z
dd �Zd � Zd
� Zd� Zy )� IReporterz6
I report results from a run of a test suite.
zHA boolean indicating that this reporter would like the test run to stop.zd
The number of tests that seem to have been run according to this
reporter.
c � � y)z�
Report the beginning of a run of a single test method.
@param method: an object that is adaptable to ITestMethod
Nr ��methods r � startTestzIReporter.startTestC r r c � � y)z~
Report the status of a single test method
@param method: an object that is adaptable to ITestMethod
Nr r s r �stopTestzIReporter.stopTestJ r r c � � y)z*
Record that test passed.
Nr )�tests r �
addSuccesszIReporter.addSuccessQ r r c � � y)aI
Record that a test has raised an unexpected exception.
@param test: The test that has raised an error.
@param error: The error that the test raised. It will either be a
three-tuple in the style of C{sys.exc_info()} or a
L{Failure<twisted.python.failure.Failure>} object.
Nr )r% �errors r �addErrorzIReporter.addErrorV r r c � � y)aH
Record that a test has failed with the given failure.
@param test: The test that has failed.
@param failure: The failure that the test failed with. It will
either be a three-tuple in the style of C{sys.exc_info()}
or a L{Failure<twisted.python.failure.Failure>} object.
Nr )r% �failures r �
addFailurezIReporter.addFailure` r r Nc � � y)a�
Record that the given test failed, and was expected to do so.
In Twisted 15.5 and prior, C{todo} was a mandatory parameter.
@type test: L{unittest.TestCase}
@param test: The test which this is about.
@type failure: L{failure.Failure}
@param failure: The error which this test failed with.
@type todo: L{unittest.Todo}
@param todo: The reason for the test's TODO status. If L{None}, a
generic reason is used.
Nr )r% r+ �todos r �addExpectedFailurez IReporter.addExpectedFailurej r r c � � y)a�
Record that the given test failed, and was expected to do so.
In Twisted 15.5 and prior, C{todo} was a mandatory parameter.
@type test: L{unittest.TestCase}
@param test: The test which this is about.
@type todo: L{unittest.Todo}
@param todo: The reason for the test's TODO status. If L{None}, a
generic reason is used.
Nr )r% r. s r �addUnexpectedSuccessz IReporter.addUnexpectedSuccessy r r c � � y)z�
Record that a test has been skipped for the given reason.
@param test: The test that has been skipped.
@param reason: An object that the test case has specified as the reason
for skipping the test.
Nr )r% �reasons r �addSkipzIReporter.addSkip� r r c � � y)z�
Return a boolean indicating whether all test results that were reported
to this reporter were successful or not.
Nr r r r �
wasSuccessfulzIReporter.wasSuccessful� r r c � � y)a1
Called when the test run is complete.
This gives the result object an opportunity to display a summary of
information to the user. Once you have called C{done} on an
L{IReporter} object, you should assume that the L{IReporter} object is
no longer usable.
Nr r r r �donezIReporter.done� r r )N)r r r r r r �
shouldStop�testsRunr! r# r& r) r, r/ r1 r4 r6 r8 r r r r r 4 se � �� �� � �U��J� �r�|�|� ��H� � � �
� �
� � � � r r )r �zope.interface� interfacer � Interfacer r r r r �<module>r> s2 ��� �# �� � � # �Li �� � � i r |