t.t.util : module documentation

Part of twisted.trial View Source

A collection of utility functions and classes, used internally by Trial.

This code is for Trial's internal use. Do NOT use this code if you are writing tests. It is subject to change at the Trial maintainer's whim. There is nothing here in this module for you to use unless you are maintaining Trial.

Any non-Trial Twisted code that uses this module will be shot.

Maintainer: Jonathan Lange
Class DirtyReactorAggregateError Passed to twisted.trial.itrial.IReporter.addError when the reactor is left in an unclean state after a test.
Function excInfoOrFailureToExcInfo Coerce a Failure to an _exc_info, if err is a Failure.
Function suppress Sets up the .suppress tuple properly, pass options to this method as you would the stdlib warnings.filterwarnings()
Function profiled Undocumented
Function getPythonContainers Walk up the Python tree from method 'meth', finding its class, its module and all containing packages.
Function acquireAttribute Go through the list 'objects' sequentially until we find one which has attribute 'attr', then return the value of that attribute. If not found, return 'default' if set, otherwise, raise AttributeError.
Function findObject Get a fully-named package, module, module-global object or attribute. Forked from twisted.python.reflect.namedAny.
Class _Janitor The guy that cleans up after you.
Function _runSequentially Run the given callables one after the other. If a callable returns a Deferred, wait until it has finished before running the next callable.
def excInfoOrFailureToExcInfo(err): (source)
Coerce a Failure to an _exc_info, if err is a Failure.
ParameterserrEither a tuple such as returned by sys.exc_info or a Failure object.
ReturnsA tuple like the one returned by sys.exc_info. e.g. exception_type, exception_object, traceback_object.
def suppress(action='ignore', **kwarg): (source)

Sets up the .suppress tuple properly, pass options to this method as you would the stdlib warnings.filterwarnings()

So, to use this with a .suppress magic attribute you would do the following:
>>> from twisted.trial import unittest, util
>>> import warnings
>>>
>>> class TestFoo(unittest.TestCase):
...     def testFooBar(self):
...         warnings.warn("i am deprecated", DeprecationWarning)
...     testFooBar.suppress = [util.suppress(message='i am deprecated')]
...
>>>
Note that as with the todo and timeout attributes: the module level attribute acts as a default for the class attribute which acts as a default for the method attribute. The suppress attribute can be overridden at any level by specifying .suppress = []
def profiled(f, outputFile): (source)
Undocumented
def getPythonContainers(meth): (source)
Walk up the Python tree from method 'meth', finding its class, its module and all containing packages.
def acquireAttribute(objects, attr, default=_DEFAULT): (source)
Go through the list 'objects' sequentially until we find one which has attribute 'attr', then return the value of that attribute. If not found, return 'default' if set, otherwise, raise AttributeError.
def findObject(name): (source)

Get a fully-named package, module, module-global object or attribute. Forked from twisted.python.reflect.namedAny.

Returns a tuple of (bool, obj). If bool is True, the named object exists and is returned as obj. If bool is False, the named object does not exist and the value of obj is unspecified.
def _runSequentially(callables, stopOnFirstError=False): (source)
Run the given callables one after the other. If a callable returns a Deferred, wait until it has finished before running the next callable.
ParameterscallablesAn iterable of callables that take no parameters.
stopOnFirstErrorIf True, then stop running callables as soon as one raises an exception or fires an errback. False by default.
ReturnsA Deferred that fires a list of (flag, value) tuples. Each tuple will be either (SUCCESS, <return value>) or (FAILURE, <Failure>).
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:17:34.