Browse Source

Fixed #25451 -- Added advice about organizing tests.

Tim Graham 9 years ago
parent
commit
53e89ce2e7
2 changed files with 12 additions and 1 deletions
  1. 1 0
      docs/topics/testing/advanced.txt
  2. 11 1
      docs/topics/testing/overview.txt

+ 1 - 0
docs/topics/testing/advanced.txt

@@ -248,6 +248,7 @@ Advanced features of ``TransactionTestCase``
     Using ``reset_sequences = True`` will slow down the test, since the primary
     key reset is an relatively expensive database operation.
 
+.. _testing-reusable-applications:
 
 Using the Django test runner to test reusable applications
 ==========================================================

+ 11 - 1
docs/topics/testing/overview.txt

@@ -46,6 +46,17 @@ automatically build a test suite out of those test cases, and run that suite.
 
 For more details about :mod:`unittest`, see the Python documentation.
 
+.. admonition:: Where should the tests live?
+
+    The default :djadmin:`startapp` template creates a ``tests.py`` file in the
+    new application. This might be fine if you only have a few tests, but as
+    your test suite grows you'll likely want to restructure it into a tests
+    package so you can split your tests into different submodules such as
+    ``test_models.py``, ``test_views.py``, ``test_forms.py``, etc. Feel free to
+    pick whatever organizational scheme you like.
+
+    See also :ref:`testing-reusable-applications`.
+
 .. warning::
 
     If your tests rely on database access such as creating or querying models,
@@ -60,7 +71,6 @@ For more details about :mod:`unittest`, see the Python documentation.
 
 .. _running-tests:
 
-
 Running tests
 =============