Single source of truth for requirements

requirements.txt

@@ -1,21 +1,13 @@
-# Minimum Django version
+# The base set of requirements for REST framework is actually
-Django>=1.4.11
+# just Django, but for the purposes of development and testing
+# there are a number of packages that it is useful to install.
 
-# Test requirements
+# Laying these out as seperate requirements files, allows us to
-pytest-django==2.8.0
+# only included the relevent sets when running tox, and ensures
-pytest==2.6.4
+# we are only ever declaring out dependancies in one place.
-pytest-cov==1.6
-flake8==2.2.2
 
-# Optional packages
+-r requirements/requirements-optionals.txt
-markdown>=2.1.0
+-r requirements/requirements-testing.txt
-django-guardian==1.2.4
+-r requirements/requirements-documentation.txt
-django-filter>=0.9.2
+-r requirements/requirements-codestyle.txt
-
+-r requirements/requirements-packaging.txt
-# wheel for PyPI installs
-wheel==0.24.0
-# twine for secured PyPI uploads
-twine==1.4.0
-
-# MkDocs for documentation previews/deploys
-mkdocs==0.11.1

requirements/requirements-codestyle.txt

@@ -0,0 +1,3 @@
+# PEP8 code linting, which we run on all commits.
+flake8==2.3.0
+pep8==1.6.2

requirements/requirements-documentation.txt

@@ -0,0 +1,2 @@
+# MkDocs to build our documentation.
+mkdocs==0.11.1

requirements/requirements-optionals.txt

@@ -0,0 +1,4 @@
+# Optional packages which may be used with REST framework.
+markdown==2.5.2
+django-guardian==1.2.5
+django-filter==0.9.2

requirements/requirements-packaging.txt

@@ -0,0 +1,11 @@
+# Wheel for PyPI installs.
+wheel==0.24.0
+
+# Twine for secured PyPI uploads.
+twine==1.4.0
+
+# Transifex client for managing translation resources.
+transifex-client==0.10
+
+# The pip-review and pip-dump tools for package upgrades.
+pip-tools==0.3.5

requirements/requirements-testing.txt

@@ -0,0 +1,3 @@
+# PyTest for running the tests.
+pytest==2.6.4
+pytest-django==2.8.0

tox.ini

@@ -15,18 +15,17 @@ deps =
        django16: Django==1.6.3  # Should track minimum supported
        django17: Django==1.7.2  # Should track maximum supported
        django18alpha: https://www.djangoproject.com/download/1.8a1/tarball/
-       django-guardian==1.2.4
+       -rrequirements/requirements-testing.txt
-       pytest-django==2.8.0
+       -rrequirements/requirements-optionals.txt
-       django-filter==0.9.2
-       markdown>=2.1.0
 
 [testenv:py27-flake8]
 deps =
-       pytest==2.6.4
+       -rrequirements/requirements-testing.txt
-       flake8==2.2.2
+       -rrequirements/requirements-codestyle.txt
 commands = ./runtests.py --lintonly
 
 [testenv:py27-docs]
 deps =
-       mkdocs>=0.11.1
+       -rrequirements/requirements-testing.txt
+       -rrequirements/requirements-documentation.txt
 commands = mkdocs build