mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-31 09:41:08 +00:00
Code Issues 32 Releases Wiki Activity

[1.9.x] Fixed #25860 -- Documented a transaction leak possiblity in TestCase.

Browse Source 
Thanks Jonas Haag for report and review.

Backport of a5619f7ed3 from master
This commit is contained in:
Tim Graham
2015-12-05 17:48:58 -05:00
parent c0da598077
commit 35b5e11a98
1 changed files with 11 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/topics/testing/tools.txt
View File

@@ -694,13 +694,22 @@ then you should use :class:`~django.test.TransactionTestCase` or
@classmethod
def setUpClass(cls):
super(MyTestCase, cls).setUpClass() # Call parent first
super(MyTestCase, cls).setUpClass()
...
@classmethod
def tearDownClass(cls):
...
super(MyTestCase, cls).tearDownClass() # Call parent last
super(MyTestCase, cls).tearDownClass()
Be sure to account for Python's behavior if an exception is raised during
``setUpClass()``. If that happens, neither the tests in the class nor
``tearDownClass()`` are run. In the case of :class:`django.test.TestCase`,
this will leak the transaction created in ``super()`` which results in
various symptoms including a segmentation fault on some platforms (reported
on OS X). If you want to intentionally raise an exception such as
:exc:`unittest.SkipTest` in ``setUpClass()``, be sure to do it before
calling ``super()`` to avoid this.
TransactionTestCase
~~~~~~~~~~~~~~~~~~~