CasperSecurity
o
�b6 � @ s8 d Z ddlmZ G dd� dej�ZG dd� dej�ZdS )z3
Interfaces for Trial.
Maintainer: Jonathan Lange
� Nc @ sB e Zd ZdZe�d�Zdd� Zdd� Zdd� Z d d
� Z
d d � Z d
S )� 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 C � dS )zQ
Run the test. Should always do exactly the same thing as run().
N� ��resultr r �6/usr/lib/python3/dist-packages/twisted/trial/itrial.py�__call__ � zITestCase.__call__c C r )zJ
Return the number of tests in this test case. Usually 1.
Nr r r r r �countTestCases r zITestCase.countTestCasesc C r )zk
Return a unique identifier for the test, usually the fully-qualified
Python name.
Nr r r r r �id! r z ITestCase.idc C r )zj
Run the test, storing the results in C{result}.
@param result: A L{TestResult}.
Nr r r r r �run' r z
ITestCase.runc C r )z9
Return a short description of the test.
Nr r r r r �shortDescription. r zITestCase.shortDescriptionN) �__name__�
__module__� __qualname__�__doc__�zi� Attribute�failureExceptionr r
r r r
r r r r r s � r c @ sx e Zd ZdZe�d�Ze�d�Zdd� Zdd� Z dd � Z
d
d � Z d d
� Z ddd�Z
ddd�Zdd� Zdd� Zdd� ZdS )� 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 C r )z�
Report the beginning of a run of a single test method.
@param method: an object that is adaptable to ITestMethod
Nr ��methodr r r � startTestC r zIReporter.startTestc C r )z~
Report the status of a single test method
@param method: an object that is adaptable to ITestMethod
Nr r r r r �stopTestJ r zIReporter.stopTestc C r )z*
Record that test passed.
Nr )�testr r r �
addSuccessQ r zIReporter.addSuccessc C r )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 �errorr r r �addErrorV r zIReporter.addErrorc C r )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 �failurer r r �
addFailure` r zIReporter.addFailureNc C r )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 �todor r r �addExpectedFailurej r z IReporter.addExpectedFailurec C r )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 r r r �addUnexpectedSuccessy r z IReporter.addUnexpectedSuccessc C r )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 �reasonr r r �addSkip� r zIReporter.addSkipc C r )z�
Return a boolean indicating whether all test results that were reported
to this reporter were successful or not.
Nr r r r r �
wasSuccessful� r zIReporter.wasSuccessfulc C r )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 r �done� r zIReporter.done)N)r r r r r r �
shouldStop�testsRunr r r r r r! r" r$ r% r& r r r r r 4 s$ ��
r )r �zope.interface� interfacer � Interfacer r r r r r �<module> s &