Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

[1.6.x] Fixed #19196 -- Added test/requirements

Backport of 4d92a0b from master.
  • Loading branch information...
commit aecbaaed0c1a0d7da99a8d3deb9328ad2b5c601d 1 parent a2b4af3
@timgraham timgraham authored
View
19 docs/internals/contributing/writing-code/unit-tests.txt
@@ -136,23 +136,40 @@ Running all the tests
If you want to run the full suite of tests, you'll need to install a number of
dependencies:
+* Pillow_
* PyYAML_
+* pytz_
* setuptools_
* memcached_, plus a :ref:`supported Python binding <memcached>`
* gettext_ (:ref:`gettext_on_windows`)
-* selenium_ (if also using Python >= 2.6)
+* selenium_
+
+You can find these dependencies in `pip requirements files`_ inside the
+``tests/requirements`` directory of the Django source tree and install them
+like so::
+
+ pip install -r tests/requirements/py2.txt # Python 3: py3.txt
+
+You can also install the database adapter(s) of your choice using
+``oracle.txt``, ``mysql.txt``, or ``postgres.txt``.
If you want to test the memcached cache backend, you'll also need to define
a :setting:`CACHES` setting that points at your memcached instance.
+To run the GeoDjango tests, you will need to :doc:`setup a spatial database
+and install the Geospatial libraries</ref/contrib/gis/install/index>`.
+
Each of these dependencies is optional. If you're missing any of them, the
associated tests will be skipped.
+.. _Pillow: https://pypi.python.org/pypi/Pillow/
.. _PyYAML: http://pyyaml.org/wiki/PyYAML
+.. _pytz: https://pypi.python.org/pypi/pytz/
.. _setuptools: http://pypi.python.org/pypi/setuptools/
.. _memcached: http://memcached.org/
.. _gettext: http://www.gnu.org/software/gettext/manual/gettext.html
.. _selenium: http://pypi.python.org/pypi/selenium
+.. _pip requirements files: http://www.pip-installer.org/en/latest/requirements.html
Code coverage
~~~~~~~~~~~~~
View
6 tests/requirements/base.txt
@@ -0,0 +1,6 @@
+bcrypt
+docutils
+Pillow
+PyYAML
+pytz
+selenium
View
1  tests/requirements/mysql.txt
@@ -0,0 +1 @@
+MySQL-python
View
1  tests/requirements/oracle.txt
@@ -0,0 +1 @@
+cx_oracle
View
1  tests/requirements/postgres.txt
@@ -0,0 +1 @@
+psycopg2
View
2  tests/requirements/py2.txt
@@ -0,0 +1,2 @@
+-r base.txt
+python-memcached
View
2  tests/requirements/py3.txt
@@ -0,0 +1,2 @@
+-r base.txt
+python3-memcached
View
1  tests/runtests.py
@@ -22,6 +22,7 @@
os.environ['DJANGO_TEST_TEMP_DIR'] = TEMP_DIR
SUBDIRS_TO_SKIP = [
+ 'requirements',
'templates',
'test_discovery_sample',
'test_discovery_sample2',
Please sign in to comment.
Something went wrong with that request. Please try again.