| Index: third_party/twisted_8_1/twisted/trial/itrial.py
|
| diff --git a/third_party/twisted_8_1/twisted/trial/itrial.py b/third_party/twisted_8_1/twisted/trial/itrial.py
|
| deleted file mode 100644
|
| index 99540b44d2df0f060087f9317e7ca3f7e0761832..0000000000000000000000000000000000000000
|
| --- a/third_party/twisted_8_1/twisted/trial/itrial.py
|
| +++ /dev/null
|
| @@ -1,250 +0,0 @@
|
| -"""
|
| -Interfaces for Trial.
|
| -"""
|
| -
|
| -# Copyright (c) 2001-2007 Twisted Matrix Laboratories.
|
| -# See LICENSE for details.
|
| -# Maintainer: Jonathan Lange <jml@twistedmatrix.com>
|
| -
|
| -import zope.interface as zi
|
| -from zope.interface import Attribute
|
| -
|
| -
|
| -class ITestCase(zi.Interface):
|
| - """
|
| - The interface that a test case must implement in order to be used in Trial.
|
| - """
|
| -
|
| - failureException = zi.Attribute(
|
| - "The exception class that is raised by failed assertions")
|
| -
|
| -
|
| - def __call__(result):
|
| - """
|
| - Run the test. Should always do exactly the same thing as run().
|
| - """
|
| -
|
| -
|
| - def countTestCases():
|
| - """
|
| - Return the number of tests in this test case. Usually 1.
|
| - """
|
| -
|
| -
|
| - def id():
|
| - """
|
| - Return a unique identifier for the test, usually the fully-qualified
|
| - Python name.
|
| - """
|
| -
|
| -
|
| - def run(result):
|
| - """
|
| - Run the test, storing the results in C{result}.
|
| -
|
| - @param result: A L{TestResult}.
|
| - """
|
| -
|
| -
|
| - def shortDescription():
|
| - """
|
| - Return a short description of the test.
|
| - """
|
| -
|
| -
|
| -
|
| -class IReporter(zi.Interface):
|
| - """
|
| - I report results from a run of a test suite.
|
| - """
|
| -
|
| - stream = zi.Attribute(
|
| - "Deprecated in Twisted 8.0. "
|
| - "The io-stream that this reporter will write to")
|
| - tbformat = zi.Attribute("Either 'default', 'brief', or 'verbose'")
|
| - args = zi.Attribute(
|
| - "Additional string argument passed from the command line")
|
| - shouldStop = zi.Attribute(
|
| - """
|
| - A boolean indicating that this reporter would like the test run to stop.
|
| - """)
|
| - separator = Attribute(
|
| - "Deprecated in Twisted 8.0. "
|
| - "A value which will occasionally be passed to the L{write} method.")
|
| - testsRun = Attribute(
|
| - """
|
| - The number of tests that seem to have been run according to this
|
| - reporter.
|
| - """)
|
| -
|
| -
|
| - def startTest(method):
|
| - """
|
| - Report the beginning of a run of a single test method.
|
| -
|
| - @param method: an object that is adaptable to ITestMethod
|
| - """
|
| -
|
| -
|
| - def stopTest(method):
|
| - """
|
| - Report the status of a single test method
|
| -
|
| - @param method: an object that is adaptable to ITestMethod
|
| - """
|
| -
|
| -
|
| - def startSuite(name):
|
| - """
|
| - Deprecated in Twisted 8.0.
|
| -
|
| - Suites which wish to appear in reporter output should call this
|
| - before running their tests.
|
| - """
|
| -
|
| -
|
| - def endSuite(name):
|
| - """
|
| - Deprecated in Twisted 8.0.
|
| -
|
| - Called at the end of a suite, if and only if that suite has called
|
| - C{startSuite}.
|
| - """
|
| -
|
| -
|
| - def cleanupErrors(errs):
|
| - """
|
| - 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
|
| - """
|
| -
|
| -
|
| - def upDownError(userMeth, warn=True, printStatus=True):
|
| - """
|
| - 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
|
| - """
|
| -
|
| -
|
| - def addSuccess(test):
|
| - """
|
| - Record that test passed.
|
| - """
|
| -
|
| -
|
| - def addError(test, error):
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def addFailure(test, failure):
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def addExpectedFailure(test, failure, todo):
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def addUnexpectedSuccess(test, todo):
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def addSkip(test, reason):
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def printSummary():
|
| - """
|
| - Deprecated in Twisted 8.0, use L{done} instead.
|
| -
|
| - Present a summary of the test results.
|
| - """
|
| -
|
| -
|
| - def printErrors():
|
| - """
|
| - 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.
|
| - """
|
| -
|
| -
|
| - def write(string):
|
| - """
|
| - Deprecated in Twisted 8.0, use L{done} instead.
|
| -
|
| - Display a string to the user, without appending a new line.
|
| - """
|
| -
|
| -
|
| - def writeln(string):
|
| - """
|
| - Deprecated in Twisted 8.0, use L{done} instead.
|
| -
|
| - Display a string to the user, appending a new line.
|
| - """
|
| -
|
| - def wasSuccessful():
|
| - """
|
| - Return a boolean indicating whether all test results that were reported
|
| - to this reporter were successful or not.
|
| - """
|
| -
|
| -
|
| - def done():
|
| - """
|
| - 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.
|
| - """
|
|
|