From 2ca137e271116342065d448d3fcbdf5d29b931ba Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Thu, 24 Sep 2015 14:48:49 -0400 Subject: [1.8.x] Fixed #25451 -- Added advice about organizing tests. Backport of 53e89ce2e71411ff9d1c3fd6f2b10d052a4aeace from master --- docs/topics/testing/advanced.txt | 1 + docs/topics/testing/overview.txt | 12 +++++++++++- 2 files changed, 12 insertions(+), 1 deletion(-) (limited to 'docs/topics/testing') diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt index 6adae9ed50..e47666c5b1 100644 --- a/docs/topics/testing/advanced.txt +++ b/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 ========================================================== diff --git a/docs/topics/testing/overview.txt b/docs/topics/testing/overview.txt index 0aca7fb0a4..d1a75c1c91 100644 --- a/docs/topics/testing/overview.txt +++ b/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 ============= -- cgit v1.3