Fixed #25451 -- Added advice about organizing tests.

This commit is contained in:
Tim Graham 2015-09-24 14:48:49 -04:00
parent 7372cdebed
commit 53e89ce2e7
2 changed files with 12 additions and 1 deletions

View File

@ -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
==========================================================

View File

@ -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
=============