Author: PaulM
Date: 2010-08-04 23:23:03 -0500 (Wed, 04 Aug 2010)
New Revision: 13477
Modified:
django/branches/soc2010/test-refactor/docs/internals/contributing.txt
django/branches/soc2010/test-refactor/docs/topics/testing.txt
Log:
[soc2010/test-refactor] Update docs to reflect unittest2 changes.
Modified: django/branches/soc2010/test-refactor/docs/internals/contributing.txt
===================================================================
--- django/branches/soc2010/test-refactor/docs/internals/contributing.txt
2010-08-05 04:00:56 UTC (rev 13476)
+++ django/branches/soc2010/test-refactor/docs/internals/contributing.txt
2010-08-05 04:23:03 UTC (rev 13477)
@@ -825,9 +825,10 @@
We appreciate any and all contributions to the test suite!
The Django tests all use the testing infrastructure that ships with
-Django for testing applications. New tests should use the unittest
-framework. See :ref:`Testing Django applications <topics-testing>` for
-an explanation of how to write new tests.
+Django for testing applications. New tests should use
+``django.utils.unittest``, and should not include doctests. See
+:ref:`Testing Django applications <topics-testing>` for an explanation
+of how to write new tests.
Running the unit tests
----------------------
Modified: django/branches/soc2010/test-refactor/docs/topics/testing.txt
===================================================================
--- django/branches/soc2010/test-refactor/docs/topics/testing.txt
2010-08-05 04:00:56 UTC (rev 13476)
+++ django/branches/soc2010/test-refactor/docs/topics/testing.txt
2010-08-05 04:23:03 UTC (rev 13477)
@@ -52,9 +52,9 @@
return a_list[idx]
* **Unit tests** -- tests that are expressed as methods on a Python class
- that subclasses ``unittest.TestCase``. For example::
+ that subclasses ``django.utils.unittest.TestCase``. For example::
- import unittest
+ from django.utils import unittest
class MyFuncTestCase(unittest.TestCase):
def testBasic(self):
@@ -157,6 +157,8 @@
This module uses a different way of defining tests, taking a class-based
approach.
+.. versionchanged:: 1.3 Django bundles the Python 2.7 unittest library as
``django.utils.unittest``. You can still use the system ``unittest`` package,
but the the bundled package includes more verbose error reporting and
additional assertions for versions of Python below 2.7.
+
As with doctests, for a given Django application, the test runner looks for
unit tests in two places:
@@ -170,7 +172,7 @@
This example ``unittest.TestCase`` subclass is equivalent to the example given
in the doctest section above::
- import unittest
+ from django.utils import unittest
from myapp.models import Animal
class AnimalTestCase(unittest.TestCase):
@@ -233,6 +235,8 @@
routines, which give you a high level of control over the environment
in which your test cases are run.
+ * If you're writing tests for Django itself, you should use ``unittest``.
+
Again, remember that you can use both systems side-by-side (even in the same
app). In the end, most projects will eventually end up using both. Each shines
in different circumstances.
@@ -913,7 +917,7 @@
The following is a simple unit test using the test client::
- import unittest
+ from django.utils import unittest
from django.test.client import Client
class SimpleTest(unittest.TestCase):
@@ -1010,7 +1014,7 @@
This means, instead of instantiating a ``Client`` in each test::
- import unittest
+ from django.utils import unittest
from django.test.client import Client
class SimpleTest(unittest.TestCase):
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-upda...@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
