[XMc@s[dZddljZddlmZdejfdYZdejfdYZdS(s3 Interfaces for Trial. Maintainer: Jonathan Lange iN(t Attributet ITestCasecBsJeZdZejdZdZdZdZdZ dZ RS(sU The interface that a test case must implement in order to be used in Trial. s7The exception class that is raised by failed assertionscCsdS(sQ Run the test. Should always do exactly the same thing as run(). N((tresult((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt__call__scCsdS(sJ Return the number of tests in this test case. Usually 1. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytcountTestCasesscCsdS(sk Return a unique identifier for the test, usually the fully-qualified Python name. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytid#scCsdS(sj Run the test, storing the results in C{result}. @param result: A L{TestResult}. N((R((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytrun*scCsdS(s9 Return a short description of the test. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytshortDescription2s( t__name__t __module__t__doc__tziRtfailureExceptionRRRRR(((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyRs     t IReportercBs eZdZejdZejdZejdZejdZedZ edZ dZ dZ d Z d Zd Zeed Zd ZdZdZdZdZdZdZdZdZdZdZdZRS(s6 I report results from a run of a test suite. sIDeprecated in Twisted 8.0. The io-stream that this reporter will write tos'Either 'default', 'brief', or 'verbose's7Additional string argument passed from the command linesZ A boolean indicating that this reporter would like the test run to stop. s\Deprecated in Twisted 8.0. A value which will occasionally be passed to the L{write} method.sd The number of tests that seem to have been run according to this reporter. cCsdS(s Report the beginning of a run of a single test method. @param method: an object that is adaptable to ITestMethod N((tmethod((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt startTestRscCsdS(s~ Report the status of a single test method @param method: an object that is adaptable to ITestMethod N((R((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytstopTestZscCsdS(s Deprecated in Twisted 8.0. Suites which wish to appear in reporter output should call this before running their tests. N((tname((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt startSuitebscCsdS(s Deprecated in Twisted 8.0. Called at the end of a suite, if and only if that suite has called C{startSuite}. N((R((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytendSuitekscCsdS(s 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 N((terrs((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt cleanupErrorstscCsdS(s 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 N((tuserMethtwarnt printStatus((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt upDownError~scCsdS(s* Record that test passed. N((ttest((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt addSuccessscCsdS(sI 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. N((Rterror((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytaddErrorscCsdS(sH 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. N((Rtfailure((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt addFailurescCsdS(sp Record that the given test failed, and was expected to do so. @type test: L{pyunit.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. N((RRttodo((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytaddExpectedFailurescCsdS(s  Record that the given test failed, and was expected to do so. @type test: L{pyunit.TestCase} @param test: The test which this is about. @type todo: L{unittest.Todo} @param todo: The reason for the test's TODO status. N((RR ((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytaddUnexpectedSuccessscCsdS(s 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. N((Rtreason((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytaddSkipscCsdS(sq Deprecated in Twisted 8.0, use L{done} instead. Present a summary of the test results. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt printSummaryscCsdS(s Deprecated in Twisted 8.0, use L{done} instead. Present the errors that have occured during the test run. This method will be called after all tests have been run. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt printErrorsscCsdS(s Deprecated in Twisted 8.0, use L{done} instead. Display a string to the user, without appending a new line. N((tstring((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytwritescCsdS(s~ Deprecated in Twisted 8.0, use L{done} instead. Display a string to the user, appending a new line. N((R'((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytwritelnscCsdS(s Return a boolean indicating whether all test results that were reported to this reporter were successful or not. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt wasSuccessfulscCsdS(s1 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. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytdones(RR R R Rtstreamttbformattargst shouldStopt separatorttestsRunRRRRRtTrueRRRRR!R"R$R%R&R(R)R*R+(((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyR 9s<             (R tzope.interfacet interfaceR Rt InterfaceRR (((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyts+