Home | Trees | Index | Help |
|
---|
Package twisted :: Package trial :: Module unittest :: Class TestCase |
|
object
--+ |object
--+ | | |TestCase
--+ |_Assertions
--+ | TestCase
AttributeType_KnownValues
,
BERBaseEquality
,
BERBooleanKnownValues
,
BEREnumeratedKnownValues
,
BEREnumeratedSanityCheck
,
BERIntegerKnownValues
,
BERIntegerSanityCheck
,
BerLengths
,
BERNullKnownValues
,
BEROctetStringKnownValues
,
BEROctetStringSanityCheck
,
BERSequenceKnownValues
,
DistinguishedName_Comparison
,
DistinguishedName_Init
,
KnownValues
,
LDAPDistinguishedName_contains
,
LDAPDistinguishedName_DomainName
,
LDAPDistinguishedName_Malformed
,
LDAPDistinguishedName_Prettify
,
NetmaskToNumbits
,
ObjectClass_KnownValues
,
PtrSoaName
,
RelativeDistinguishedName_Init
,
RFC2254Examples
,
Substrings
,
TestCallableOverride
,
TestCaseWithKnownValues
,
TestComparison
,
TestComparison
,
TestEquality
,
TestInvalid
,
TestMaybeSubstring
,
TestSetOperations
,
TestValid
,
TestWhitespace
A unit test. The atom of the unit testing universe.
This class extends unittest.TestCase
from the standard
library. The main feature is the ability to return Deferred
s
from tests and fixture methods and to have the suite wait for those
Deferred
s to fire.
To write a unit test, subclass TestCase
and define a
method (say, 'test_foo') on the subclass. To run the test, instantiate
your subclass with the name of the method, and call run
on the instance, passing a
TestResult
object.
The trial
script will automatically find any
TestCase
subclasses defined in modules beginning with
'test_' and construct test cases for all methods beginning with
'test'.
log.err
.
Method Summary | |
---|---|
Construct an asynchronous test case for methodName . | |
__call__(self,
*args,
**kwargs)
| |
deferSetUp(self,
ignored,
result)
| |
deferSetUpClass(self,
result)
| |
deferTearDown(self,
ignored,
result)
| |
deferTearDownClass(self,
ignored,
result)
| |
deferTestMethod(self,
ignored,
result)
| |
Remove stored errors received from the log. | |
Return the skip reason set on this test, if any is set. | |
Returns any warning suppressions set for this test. | |
Returns the timeout value set on this test. | |
Return a Todo object if the test is marked todo. | |
Returns a unique name that may be used as either a temporary directory or filename. | |
Run the test case, storing the results in result . | |
If no methodName argument is passed to the constructor,
run will treat this method as the thing
with the actual test inside. | |
Returns a one-line description of the test, or None if no description has been provided. | |
Visit this test case. | |
_cbDeferTestMethod(self,
ignored,
result)
| |
_classCleanUp(self,
result)
| |
_cleanUp(self,
result)
| |
Deprecate iterate , crash and
stop on reactor . | |
_ebDeferSetUp(self,
failure,
result)
| |
_ebDeferSetUpClass(self,
error,
result)
| |
_ebDeferTearDown(self,
failure,
result)
| |
_ebDeferTestMethod(self,
f,
result)
| |
_ebTearDownClass(self,
error,
result)
| |
_getReason(self,
f)
| |
_initInstances(cls)
(Class method) | |
_installObserver(self)
| |
_isFirst(self)
| |
_isLast(self)
| |
Create a method which wraps the reactor method name . | |
Lots of tests assume that test methods all run in the same instance of TestCase. | |
_removeObserver(self)
| |
_run(self,
methodName,
result)
| |
Restore the deprecated reactor methods. | |
Take a Deferred that only ever callbacks. | |
Inherited from _Assertions | |
fails the test if condition evaluates to True | |
Fail if the two objects are unequal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
Fail if the two objects are unequal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
asserts that first - second >
tolerance | |
fail the test if first and second are not
equal | |
fail the test if first and second are not
equal | |
Assert that deferred will errback with one of
expectedFailures . | |
fails the test if condition evaluates to False | |
fail the test if first is not second . | |
fail the test if containee is not found in
container | |
fails the test if condition evaluates to False | |
Fail if the two objects are equal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
Fail if the two objects are equal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
fail the test if first == second | |
fail the test if first == second | |
fail the test if first is second . | |
fail the test if containee is found in
container | |
| |
fails the test unless calling the function f with the
given args and kwargs does not raise
exception . | |
| |
fails the test if condition evaluates to True | |
absolutely fails the test, do not pass go, do not collect $200 | |
fails the test if condition evaluates to False | |
Fail if the two objects are equal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
Fail if the two objects are equal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
fail the test if first == second | |
fail the test if first == second | |
fail the test if first is second . | |
fail the test if containee is found in
container | |
| |
fails the test if condition evaluates to True | |
Fail if the two objects are unequal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
Fail if the two objects are unequal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero. | |
asserts that first - second >
tolerance | |
fail the test if first and second are not
equal | |
fail the test if first and second are not
equal | |
Assert that deferred will errback with one of
expectedFailures . | |
fails the test if condition evaluates to False | |
fail the test if first is not second . | |
fail the test if containee is not found in
container | |
fails the test unless calling the function f with the
given args and kwargs does not raise
exception . | |
| |
fails the test if condition evaluates to True | |
Inherited from TestCase | |
| |
| |
| |
Run the test without collecting errors in a TestResult | |
| |
| |
Hook method for setting up the test fixture before exercising it. | |
Hook method for deconstructing the test fixture after testing it. | |
Return a version of sys.exc_info() with the traceback frame minimised; usually the top level of the traceback frame is not needed. | |
Inherited from object | |
x.__delattr__('name') <==> del x.name | |
x.__getattribute__('name') <==> x.name | |
x.__hash__() <==> hash(x) | |
T.__new__(S, ...) -> a new object with type S, a subtype of T | |
helper for pickle | |
helper for pickle | |
x.__setattr__('name', value) <==> x.name = value |
Instance Variable Summary | |
---|---|
type |
failureException = twisted.trial.unittest.FailTest |
forceGarbageCollection : If set to True, gc.collect() will be called before and
after the test. | |
skip : None or a string explaining why this test is to be
skipped. | |
suppress : None or a list of tuples of (args, kwargs)
to be passed to warnings.filterwarnings . | |
timeout : None or a real number of seconds. | |
todo : None , a string or a tuple of (errors,
reason) where errors is either an exception class or
an iterable of exception classes, and reason is a
string. |
Class Variable Summary | |
---|---|
Implements |
__implemented__ = <implementedBy twisted.trial.unittest....
|
ClassProvides |
__provides__ = <zope.interface.declarations.ClassProvide...
|
Inherited from TestCase | |
ClassProvides |
__providedBy__ = <zope.interface.declarations.ClassProvi...
|
Instance Method Details |
---|
__init__(self,
methodName='runTest')
Construct an asynchronous test case for |
flushLoggedErrors(self, *errorTypes)Remove stored errors received from the log. TestCase stores each error logged during the run of the
test and reports them as errors during the cleanup phase (after
tearDown ).
|
getSkip(self)Return the skip reason set on this test, if any is set. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with askip attribute, returns
that. Returns None if it cannot find anything. See TestCase docstring for more details.
|
getSuppress(self)Returns any warning suppressions set for this test. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with asuppress attribute, returns
that. Returns any empty list (i.e. suppress no warnings) if it cannot
find anything. See TestCase docstring for more details.
|
getTimeout(self)Returns the timeout value set on this test. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with atimeout attribute, returns that.
Returns util.DEFAULT_TIMEOUT_DURATION if it cannot find
anything. See TestCase docstring for more details.
|
getTodo(self)Return aTodo object if the test is marked todo. Checks
on the instance first, then the class, then the module, then packages.
As soon as it finds something with a todo attribute,
returns that. Returns None if it cannot find anything. See
TestCase docstring for more details.
|
mktemp(self)Returns a unique name that may be used as either a temporary directory or filename.
|
run(self, result)Run the test case, storing the results in setUp on self, then runs the test method
(defined in the constructor), then runs tearDown . Any of
these may return Deferred s. After they complete, does some
reactor cleanup.
|
runTest(self)If nomethodName argument is passed to the constructor,
run will treat this method as the thing
with the actual test inside.
|
shortDescription(self)Returns a one-line description of the test, or None if no description has been provided. The default implementation of this method returns the first line of the specified test method's docstring.
|
visit(self, visitor)Visit this test case. Callvisitor with
self as a parameter.
|
_deprecateReactor(self, reactor)Deprecateiterate , crash and
stop on reactor . That is, each method is
wrapped in a function that issues a deprecation warning, then calls the
original.
|
_makeReactorMethod(self, name)Create a method which wraps the reactor methodname .
The new method issues a deprecation warning and calls the original.
|
_prepareClassFixture(self)Lots of tests assume that test methods all run in the same instance of TestCase. This isn't true. Calling this method ensures that self.__class__._testCaseInstance contains an instance of this class that will remain the same for all tests from this class. |
_undeprecateReactor(self, reactor)Restore the deprecated reactor methods. Undoes what_deprecateReactor did.
|
_wait(self, d, running=[])Take a Deferred that only ever callbacks. Block until it happens. |
Instance Variable Details |
---|
forceGarbageCollectionIf set to True,gc.collect() will be called before and
after the test. Otherwise, garbage collection will happen in whatever way
Python sees fit.
|
timeoutNone or a real number of seconds. If set, the test will
raise an error if it takes longer than timeout seconds.
|
todoNone , a string or a tuple of (errors,
reason) where errors is either an exception class or
an iterable of exception classes, and reason is a string.
See Todo or makeTodo for more information.
|
Class Variable Details |
---|
__implemented__
|
__provides__
|
Home | Trees | Index | Help |
|
---|
Generated by Epydoc 2.1 on Wed Jan 24 20:46:21 2007 | http://epydoc.sf.net |