From abade6413bf55d305f005c02577ad7c6aede7fdf Mon Sep 17 00:00:00 2001 From: Anubhav Joshi Date: Sun, 16 Mar 2014 14:32:55 +0530 Subject: [PATCH] Fixed #21991 -- Added warning regarding tests failure if locales not installed. Thanks reidrac for the report. --- .../contributing/writing-code/unit-tests.txt | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt index 36f767614a6..bcee13f6d39 100644 --- a/docs/internals/contributing/writing-code/unit-tests.txt +++ b/docs/internals/contributing/writing-code/unit-tests.txt @@ -49,6 +49,8 @@ You can avoid typing the ``PYTHONPATH`` bit each time by adding your Django checkout to your ``PYTHONPATH`` or by installing the source checkout using pip. See :ref:`installing-development-version`. +Having problems? See :ref:`troubleshooting-unit-tests` for some common issues. + .. _running-unit-tests-settings: Using another ``settings`` module @@ -238,3 +240,21 @@ method as above: .. code-block:: bash $ ./runtests.py --settings=settings django.contrib.auth + +.. _troubleshooting-unit-tests: + +Troubleshooting +--------------- + +Many test failures with ``UnicodeEncodeError``. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If the ``locales`` package is not installed, some tests will fail with a +``UnicodeEncodeError``. + +You can resolve this on Debian-based systems, for example, by running: + +.. code-block:: bash + + $ apt-get install locales + $ dpkg-reconfigure locales