tf6bdZddlmZGddejZGddejZdS)z3 Interfaces for Trial. Maintainer: Jonathan Lange NcPeZdZdZejdZdZdZdZ dZ dZ dS) ITestCasezU The interface that a test case must implement in order to be used in Trial. z7The exception class that is raised by failed assertionscdS)zQ Run the test. Should always do exactly the same thing as run(). Nresults S/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/trial/itrial.py__call__zITestCase.__call__cdS)zJ Return the number of tests in this test case. Usually 1. Nrrr r countTestCaseszITestCase.countTestCasesr r cdS)zk Return a unique identifier for the test, usually the fully-qualified Python name. Nrrr r idz ITestCase.id!r r cdS)zj Run the test, storing the results in C{result}. @param result: A L{TestResult}. Nrrs r runz ITestCase.run'r r cdS)z9 Return a short description of the test. Nrrr r shortDescriptionzITestCase.shortDescription.r r N) __name__ __module__ __qualname____doc__zi AttributefailureExceptionr rrrrrr r rrs$r|A                 r rceZdZdZejdZejdZdZdZ dZ dZ dZ dd Z dd Zd Zd ZdZd S) 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. cdS)z Report the beginning of a run of a single test method. @param method: an object that is adaptable to ITestMethod Nrmethods r startTestzIReporter.startTestCr r cdS)z~ Report the status of a single test method @param method: an object that is adaptable to ITestMethod Nrrs r stopTestzIReporter.stopTestJr r cdS)z* Record that test passed. Nr)tests r addSuccesszIReporter.addSuccessQr r cdS)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} object. Nr)r%errors r addErrorzIReporter.addErrorVr r cdS)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} object. Nr)r%failures r addFailurezIReporter.addFailure`r r NcdS)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 addExpectedFailurezIReporter.addExpectedFailurejr r cdS)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 addUnexpectedSuccesszIReporter.addUnexpectedSuccessyr r cdS)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.addSkipr r cdS)z Return a boolean indicating whether all test results that were reported to this reporter were successful or not. Nrrr r wasSuccessfulzIReporter.wasSuccessfulr r cdS)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. Nrrr r donezIReporter.doner r )N)rrrrrr shouldStoptestsRunr!r#r&r)r,r/r1r4r6r8rr r rr4sUJr| H                                    r r)rzope.interface interfacer Interfacerrrr r r>s# # # # #  # # # Li i i i i  i i i i i r