PPc@`sqdZddlmZmZddljZddlmZdejfdYZ dejfdYZ dS( s3 Interfaces for Trial. Maintainer: Jonathan Lange i(tdivisiontabsolute_importN(t Attributet ITestCasecB`sJeZdZejdZdZdZdZdZ 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 assertionscC`sdS(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__scC`sdS(sJ Return the number of tests in this test case. Usually 1. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytcountTestCasesscC`sdS(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%scC`sdS(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,scC`sdS(s9 Return a short description of the test. N((((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytshortDescription4s( t__name__t __module__t__doc__tziRtfailureExceptionRRRRR (((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyRs     t IReportercB`s 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. cC`sdS(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 startTestTscC`sdS(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.pytstopTest\scC`sdS(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 startSuitedscC`sdS(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.pytendSuitemscC`sdS(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 cleanupErrorsvscC`sdS(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 upDownErrorscC`sdS(s* Record that test passed. N((ttest((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyt addSuccessscC`sdS(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.pytaddErrorscC`sdS(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 addFailurescC`sdS(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((RR ttodo((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pytaddExpectedFailurescC`sdS(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.pytaddUnexpectedSuccessscC`sdS(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.pytaddSkipscC`sdS(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 printSummaryscC`sdS(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 printErrorsscC`sdS(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.pytwritescC`sdS(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.pytwritelnscC`sdS(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 wasSuccessfulscC`sdS(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(R R R R Rtstreamttbformattargst shouldStopt separatorttestsRunRRRRRtTrueRRRR!R#R$R&R'R(R*R+R,R-(((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyR;s<             ( R t __future__RRtzope.interfacet interfaceR Rt InterfaceRR(((s8/usr/lib/python2.7/dist-packages/twisted/trial/itrial.pyts +