Added info on testing.

Author: and3rson

README.md

@@ -95,9 +95,59 @@ Just run the project from `example` directory, head to http://127.0.0.1:8000, lo
   - Python 2.7.x: Django 1.7, 1.8, 1.9, 1.10
   - Python 3.x: Django 1.8, 1.9, 1.10
 
+# Testing
+
+In order to support multiple Django and Python versions we use:
+
+  - `py.test` - test runner
+  - `tox` - handy tool to test app with different versions of Pythons & libraries
+  - `selenium`
+  - `coverage`
+
+Install them via `pip install -r requirements/dev.txt`
+
+To test things in specific environment, run the following commands:
+
+    ```bash
+    # Clear previous coverage data.
+    coverage erase
+
+    # This command can be ran multiple times.
+    tox -e <python_ver>-<django_ver>
+    # Possible python_ver values: `py27`, `py36`
+    # Possible django_ver values: `17`, `18`, `19`, `110`
+    # Values can be comma-seperated, e. g. `-e py27-17,py27-18,py36-18`
+    # If you omit `-e ...` parameter, all environments will be tests.
+    # Also - not problems with running this within a virtualenv.
+    # Check tox.ini for these values.
+
+    # Run this once all tests passed on all environment.
+    coverage combine
+
+    # Render HTML with coverage info.
+    coverage html
+    # ...or simply display % of covered SLOC for each file.
+    coverage report
+    ```
+
+To add a new Django version for testing, add it into `tox.ini`, lines 3-4.
+
+Why do we need `tox` and `coverage combine`? Because different versions of Python & libraries lead to different code execution: for example, consider this code:
+
+    ```python
+    import sys
+    if sys.version_info.major == 2:
+        foo = 'spam'  # Not covered in Python 3.x, leads to coverage < 100%
+    else:
+        foo = 'eggs'  # Not covered in Python 2.x, leads to coverage < 100%
+    ```
+
+Using `tox` and `coverage combine` we're able to "merge" coverage info from across different environments.
+
 # Known issues
 
   - Not tested with empty fields.
+  - Tests sometimes fail randomly due to some Selenium timeout issue. Weird.
 
 # Contributing
 

requirements/dev.txt

@@ -0,0 +1,6 @@
+coverage==4.2
+pytest==3.0.3
+pytest-cov==2.4.0
+pytest-django==3.0.0
+selenium==3.0.1
+tox==2.4.1

setup.py

@@ -4,7 +4,7 @@
 
 setup(
     name='django-searchable-select',
-    version='1.4.4-2',
+    version='1.4.4-3',
     description='django-searchable-select - a better and faster multiple selection widget with suggestions for Django',
     long_description="""django-searchable-select
 ========================
@@ -149,7 +149,7 @@ class TravelerAdmin(admin.ModelAdmin):
     license='GPLv2',
     packages=['searchableselect'],
     include_package_data=True,
-    install_requires=['setuptools', 'django'],
+    install_requires=['setuptools'],
     zip_safe=False,
     classifiers=[
         'Development Status :: 5 - Production/Stable',

tox.ini

@@ -1,7 +1,7 @@
 [tox]
 envlist =
-    py27-{17,18,19,110}
-    py35-{18,19,110}
+    py27-{17,18,19,110,111}
+    py36-{18,19,110,111}
 
 [testenv]
 usedevelop = true
@@ -12,6 +12,7 @@ deps =
     18: Django >= 1.8, < 1.9
     19: Django >= 1.9, < 1.10
     110: Django >= 1.10, < 1.11
+    111: Django >= 1.11, < 1.12
 commands =
     python example/manage.py collectstatic --noinput -v 0
     coverage run -p example/manage.py test example -v 3