69 lines
1.5 KiB
Plaintext
69 lines
1.5 KiB
Plaintext
Running the django-filter tests
|
|
===============================
|
|
|
|
The easiest way to run the django-filter tests is to check out the source
|
|
code into a virtualenv, where you can install the test dependencies.
|
|
django-filter uses a custom test runner to locate all of the tests, so a
|
|
wrapper script is available to set up and run the test suite.
|
|
|
|
.. note::
|
|
|
|
The following assumes you have `virtualenv`__ and `git`__ installed.
|
|
|
|
__ http://www.virtualenv.org
|
|
__ http://git-scm.com
|
|
|
|
Set up a virtualenv for the test suite
|
|
--------------------------------------
|
|
|
|
Run the following to create a new virtualenv to run the test suite in::
|
|
|
|
.. code-block:: bash
|
|
|
|
virtualenv django-filter-tests
|
|
cd django-filter-tests
|
|
. bin/activate
|
|
|
|
Get a copy of django-filter
|
|
---------------------------
|
|
|
|
Get the django-filter source code using the following command::
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone https://github.com/alex/django-filter.git
|
|
|
|
Switch to the django-filter directory::
|
|
|
|
.. code-block:: bash
|
|
|
|
cd django-filter
|
|
|
|
Install the test dependencies
|
|
-----------------------------
|
|
|
|
Run the following to install the test dependencies within the
|
|
virutalenv::
|
|
|
|
.. code-block:: bash
|
|
|
|
pip install -r requirements/test.txt
|
|
|
|
Run the django-filter tests::
|
|
|
|
.. code-block:: bash
|
|
|
|
python runtests.py
|
|
|
|
|
|
Testing all supported versions
|
|
------------------------------
|
|
|
|
You can also use the excellent tox testing tool to run the tests against all supported versions of
|
|
Python and Django. Install tox globally, and then simply run::
|
|
|
|
.. code-block:: bash
|
|
|
|
tox
|
|
|