← Back
Editing: itrial.cpython-38.pyc
U W[� � @ sT d Z ddlmZmZ ddlmZ ddlmZ G dd� dej�Z G dd� dej�Z dS ) z3 Interfaces for Trial. Maintainer: Jonathan Lange � )�division�absolute_importN)� Attributec @ 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 s 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__ s zITestCase.__call__c C s dS )zJ Return the number of tests in this test case. Usually 1. Nr r r r r �countTestCases s zITestCase.countTestCasesc C s dS )zk Return a unique identifier for the test, usually the fully-qualified Python name. Nr r r r r �id% s z ITestCase.idc C s dS )zj Run the test, storing the results in C{result}. @param result: A L{TestResult}. Nr r r r r �run, s z ITestCase.runc C s dS )z9 Return a short description of the test. Nr r r r r �shortDescription4 s zITestCase.shortDescriptionN) �__name__� __module__� __qualname__�__doc__�zir ZfailureExceptionr r r r r r r r r r s �r c @ s� e Zd ZdZe�d�Ze�d�Ze�d�Ze�d�Z ed�Z ed�Z dd � Z d d � Z d d � Zdd� Zdd� Zd.dd�Zdd� Zdd� Zdd� Zd/d d �Zd0d d �Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Z d,d-� Z dS )1� IReporterz6 I report results from a run of a test suite. zIDeprecated in Twisted 8.0. The io-stream that this reporter will write toz'Either 'default', 'brief', or 'verbose'z7Additional string argument passed from the command linezZ A boolean indicating that this reporter would like the test run to stop. z\Deprecated in Twisted 8.0. A value which will occasionally be passed to the L{write} method.zd The number of tests that seem to have been run according to this reporter. c C s dS )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 � startTestT s zIReporter.startTestc C s dS )z~ Report the status of a single test method @param method: an object that is adaptable to ITestMethod Nr r r r r �stopTest\ s zIReporter.stopTestc C s dS )z� Deprecated in Twisted 8.0. Suites which wish to appear in reporter output should call this before running their tests. Nr ��namer r r � startSuited s zIReporter.startSuitec C s dS )z� Deprecated in Twisted 8.0. Called at the end of a suite, if and only if that suite has called C{startSuite}. Nr r r r r �endSuitem s zIReporter.endSuitec C s dS )z� Deprecated in Twisted 8.0. Called when the reactor has been left in a 'dirty' state @param errs: a list of L{twisted.python.failure.Failure}s Nr )Zerrsr r r � cleanupErrorsv s zIReporter.cleanupErrorsTc C s dS )a� Deprecated in Twisted 8.0. Called when an error occurs in a setUp* or tearDown* method @param warn: indicates whether or not the reporter should emit a warning about the error @type warn: Boolean @param printStatus: indicates whether or not the reporter should print the name of the method and the status message appropriate for the type of error @type printStatus: Boolean Nr )ZuserMeth�warnZ printStatusr r r � upDownError� s zIReporter.upDownErrorc C s dS )z* Record that test passed. Nr )�testr r r � addSuccess� s zIReporter.addSuccessc C s dS )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 �addError� s zIReporter.addErrorc C s dS )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� s zIReporter.addFailureNc C s dS )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 error: L{failure.Failure} @param error: 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 �addExpectedFailure� s z IReporter.addExpectedFailurec C s dS )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 �addUnexpectedSuccess� s z IReporter.addUnexpectedSuccessc C s dS )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� s zIReporter.addSkipc C s dS )zq Deprecated in Twisted 8.0, use L{done} instead. Present a summary of the test results. Nr r r r r � printSummary� s zIReporter.printSummaryc C s dS )z� Deprecated in Twisted 8.0, use L{done} instead. Present the errors that have occurred during the test run. This method will be called after all tests have been run. Nr r r r r � printErrors� s zIReporter.printErrorsc C s dS )z� Deprecated in Twisted 8.0, use L{done} instead. Display a string to the user, without appending a new line. Nr ��stringr r r �write� s zIReporter.writec C s dS )z~ Deprecated in Twisted 8.0, use L{done} instead. Display a string to the user, appending a new line. Nr r- r r r �writeln� s zIReporter.writelnc C s dS )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� s zIReporter.wasSuccessfulc C s dS )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� s zIReporter.done)TT)N)N) r r r r r r �streamZtbformat�argsZ shouldStopZ separatorZtestsRunr r r r r r r! r# r% r' r( r* r+ r, r/ r0 r1 r2 r r r r r ; sF � ���� r ) r Z __future__r r Zzope.interfaceZ interfacer r Z Interfacer r r r r r �<module> s +
Save File
Cancel