twisted.trial.reporter.TreeReporter : API documentation

t.t.r.TreeReporter(Reporter) : class documentation

Print out the tests in the form a tree.

Tests are indented according to which class and module they belong. Results are printed in ANSI color.

Method	__init__	Undocumented
Method	getDescription	Return the name of the method which 'test' represents. This is what gets displayed in the leaves of the tree.
Method	addSuccess	Report that the given test succeeded.
Method	addError	Called when a test raises an error. If `realtime` is set, then it prints the error to the stream.
Method	addFailure	Called when a test fails. If `realtime` is set, then it prints the error to the stream.
Method	addSkip	Report that the given test was skipped.
Method	addExpectedFailure	Report that the given test failed, and was expected to do so.
Method	addUnexpectedSuccess	Report that the given test succeeded against expectations.
Method	cleanupErrors	Report an error that occurred during the cleanup between tests.
Method	upDownError	Undocumented
Method	startTest	Called when `test` starts. Writes the tests name to the stream using a tree format.
Method	endLine	Print 'message' in the given color.
Method	_write	Safely write to the reporter's stream.
Method	_getPreludeSegments	Return a list of all non-leaf segments to display in the tree.
Method	_testPrelude	Write the name of the test to the stream, indenting it appropriately.
Method	_printSummary	Print a line summarising the test results to the stream, and color the status result.

Inherited from Reporter:

Method	stream	Undocumented
Method	separator	Undocumented
Method	write	Undocumented
Method	writeln	Undocumented
Method	printErrors	Print all of the non-success results in full to the stream.
Method	printSummary	Print a line summarising the test results to the stream.
Method	done	Summarize the result of the test run.
Instance Variable	_startTime	The time when the first test was started. It defaults to `None`, which means that no test was actually launched. (type: `float` or `NoneType`)
Instance Variable	_warningCache	A `set` of tuples of warning message (file, line, text, category) which have already been written to the output stream during the currently executing test. This is used to avoid writing duplicates of the same warning to the output stream. (type: `set`)
Instance Variable	_publisher	The log publisher which will be observed for warning events. (type: `LogPublisher` (or another type sufficiently similar))
Method	_observeWarnings	Observe warning events and write them to `self._stream`.
Method	_writeln	Safely write a line to the reporter's stream. Newline is appended to the format string.
Method	_trimFrames	Trim frames to remove internal paths.
Method	_formatFailureTraceback	Undocumented
Method	_groupResults	Group tests together based on their results.
Method	_printResults	Print a group of errors to the stream.
Method	_printExpectedFailure	Undocumented
Method	_printUnexpectedSuccess	Undocumented
Method	_printErrors	Print all of the non-success results to the stream in full.
Method	_getSummary	Return a formatted count of tests status results.

Inherited from TestResult (via Reporter):

Instance Variable	successes	count the number of successes achieved by the test run. (type: `int`)
Method	__repr__	Undocumented
Method	stopTest	This must be called after the given test is completed.
Method	startSuite	Undocumented
Method	endSuite	Undocumented
Method	_getTime	Undocumented
Method	_getFailure	Convert a `sys.exc_info()`-style tuple to a `Failure`, if necessary.

def __init__(self, *args, stream=sys.stdout, **kwargs): (source)

overrides twisted.trial.reporter.Reporter.__init__

Undocumented

def getDescription(self, test): (source)

Return the name of the method which 'test' represents. This is what gets displayed in the leaves of the tree.

e.g. getDescription(TestCase('test_foo')) ==> test_foo

def addSuccess(self, test): (source)

overrides twisted.trial.reporter.TestResult.addSuccess

Report that the given test succeeded.

def addError(self, *args): (source)

overrides twisted.trial.reporter.Reporter.addError

Called when a test raises an error. If realtime is set, then it prints the error to the stream.

Parameters	test	`ITestCase` that raised the error.
	error	`failure.Failure` containing the error.

def addFailure(self, *args): (source)

overrides twisted.trial.reporter.Reporter.addFailure

Called when a test fails. If realtime is set, then it prints the error to the stream.

Parameters	test	`ITestCase` that failed.
	fail	`failure.Failure` containing the error.

def addSkip(self, *args): (source)

overrides twisted.trial.reporter.TestResult.addSkip

Report that the given test was skipped.

In Trial, tests can be 'skipped'. Tests are skipped mostly because there is some platform or configuration issue that prevents them from being run correctly.

def addExpectedFailure(self, *args): (source)

overrides twisted.trial.reporter.TestResult.addExpectedFailure

Report that the given test failed, and was expected to do so.

In Trial, tests can be marked 'todo'. That is, they are expected to fail.

def addUnexpectedSuccess(self, *args): (source)

overrides twisted.trial.reporter.TestResult.addUnexpectedSuccess

Report that the given test succeeded against expectations.

In Trial, tests can be marked 'todo'. That is, they are expected to fail. When a test that is expected to fail instead succeeds, it should call this method to report the unexpected success.

def _write(self, format, *args): (source)

overrides twisted.trial.reporter.Reporter._write

Safely write to the reporter's stream.

Parameters	format	A format string to write.
	*args	The arguments for the format string.

def _getPreludeSegments(self, testID): (source)

Return a list of all non-leaf segments to display in the tree.

Normally this is the module and class name.

def _testPrelude(self, testID): (source)

Write the name of the test to the stream, indenting it appropriately.

If the test is the first test in a new 'branch' of the tree, also write all of the parents in that branch.

def cleanupErrors(self, errs): (source)

overrides twisted.trial.reporter.Reporter.cleanupErrors

Report an error that occurred during the cleanup between tests.

def upDownError(self, method, error, warn, printStatus): (source)

overrides twisted.trial.reporter.Reporter.upDownError

Undocumented

def startTest(self, test): (source)

overrides twisted.trial.reporter.Reporter.startTest

Called when test starts. Writes the tests name to the stream using a tree format.

def endLine(self, message, color): (source)

Print 'message' in the given color.

Parameters	message	A string message, usually '[OK]' or something similar.
	color	A string color, 'red', 'green' and so forth.

def _printSummary(self): (source)

overrides twisted.trial.reporter.Reporter._printSummary

Print a line summarising the test results to the stream, and color the status result.