Commit 2ca137e2 authored by Tim Graham's avatar Tim Graham
Browse files

[1.8.x] Fixed #25451 -- Added advice about organizing tests.

Backport of 53e89ce2 from master
parent 8794ded8
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -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
Original line number Diff line number Diff line
@@ -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
=============