o

�
b6�@s8dZd
dl
mZ
Gdd�dej�ZGdd�dej�ZdS)z3
Interfaces for Trial.

Maintainer: Jonathan Lange
�Nc@sBeZ
dZd
Ze�d�
Zdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
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�d
S)zQ
        Run the test. Should always do exactly the same thing as run().
        N��
�resultrr�6/usr/lib/python3/dist-packages/twisted/trial/itrial.py�__call__�zITestCase.__call__c
Cr)zJ
        Return the number of tests in this test case. Usually 1.
        Nrrrrr�countTestCasesr	zITestCase.countTestCasesc
Cr)zk
        Return a unique identifier for the test, usually the fully-qualified
        Python name.
        Nrrrrr�id!r	zITestCase.idc


Cr)zj
        Run the test, storing the results in C{result}.

        @param result: A L{TestResult}.
        Nrrrrr�run'r	z
ITestCase.runc
Cr)z9
        Return a short description of the test.
        Nrrrrr�shortDescription.r	zITestCase.shortDescriptionN)�__name__�
__module__�__qualname__�__doc__�zi�	Attribute�failureExceptionrr
rrr
rrrrrs

�rc@sxeZ
dZd
Ze�d�
Ze�d�
Zdd�Zdd�Z	dd	�Z
d
d�Zd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


Cr)z�
        Report the beginning of a run of a single test method.

        @param method: an object that is adaptable to ITestMethod
        Nr�
�methodrrr�	startTestCr	zIReporter.startTestc


Cr)z~
        Report the status of a single test method

        @param method: an object that is adaptable to ITestMethod
        Nrrrrr�stopTestJr	zIReporter.stopTestc


Cr)z*
        Record that test passed.
        Nr)
�testrrr�
addSuccessQr	zIReporter.addSuccessc
Cr)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�errorrrr�addErrorVr	zIReporter.addErrorc
Cr)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�failurerrr�
addFailure`r	zIReporter.addFailureNc
Cr)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)rr�todorrr�addExpectedFailurejr	zIReporter.addExpectedFailurec
Cr)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)rr rrr�addUnexpectedSuccessyr	zIReporter.addUnexpectedSuccessc
Cr)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�reasonrrr�addSkip�r	zIReporter.addSkipc
Cr)z�
        Return a boolean indicating whether all test results that were reported
        to this reporter were successful or not.
        Nrrrrr�
wasSuccessful�r	zIReporter.wasSuccessfulc
Cr)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.
        Nrrrrr�done�r	zIReporter.done)
N)rrrrrr�
shouldStop�testsRunrrrrrr!r"r$r%r&rrrrr4s$

�
�




	r)r�zope.interface�	interfacer�	Interfacerrrrrr�<module>
s&