Split requirements files up following DRF example (#720)

Fixes #712
Fixes #635

This way not all dependency need to be installed for the different
testing steps.

Author: sliverc

.pyup.yml

@@ -1,5 +1,17 @@
 search: False
 requirements:
-  - requirements-development.txt:
+  - requirements/requirements-codestyle.txt:
+      update: all
+      pin: True
+  - requirements/requirements-documentation.txt:
+      update: all
+      pin: True
+  - requirements/requirements-optionals.txt:
+      update: all
+      pin: True
+  - requirements/requirements-packaging.txt:
+      update: all
+      pin: True
+  - requirements/requirements-testing.txt:
       update: all
       pin: True

.travis.yml

@@ -15,7 +15,9 @@ matrix:
 
   include:
     - python: 3.6
-      env: TOXENV=flake8
+      env: TOXENV=lint
+    - python: 3.6
+      env: TOXENV=docs
 
     - python: 3.5
       env: TOXENV=py35-django111-drf310

README.rst

@@ -128,8 +128,7 @@ installed and activated:
 
     $ git clone https://github.com/django-json-api/django-rest-framework-json-api.git
     $ cd django-rest-framework-json-api
-    $ pip install -r example/requirements.txt
-    $ pip install -e .
+    $ pip install -U -e . -r requirements.txt
     $ django-admin migrate --settings=example.settings
     $ django-admin loaddata drf_example --settings=example.settings
     $ django-admin runserver --settings=example.settings
@@ -145,7 +144,7 @@ installed and activated:
 
 ::
 
-    $ pip install -Ur requirements-development.txt
+    $ pip install -Ur requirements.txt
     $ flake8
     $ pytest
 

docs/conf.py

@@ -31,7 +31,7 @@
 django.setup()
 
 # Auto-generate API documentation.
-main(['-o', '_build/apidoc', '-f', '-e', '-T', '-M', '../rest_framework_json_api'])
+main(['-o', 'apidoc', '-f', '-e', '-T', '-M', '../rest_framework_json_api'])
 
 # -- General configuration ------------------------------------------------
 

docs/getting-started.md

@@ -77,8 +77,7 @@ From Source
 	cd django-rest-framework-json-api
 	python3 -m venv env
 	source env/bin/activate
-	pip install -r example/requirements.txt
-	pip install -e .
+	pip install -U -e . r requirements.txt
 	django-admin migrate --settings=example.settings
 	django-admin loaddata drf_example --settings=example.settings
 	django-admin runserver --settings=example.settings

requirements-development.txt

@@ -1 +1,13 @@
- 
+# The base set of requirements for Django REST framework JSON API is actually
+# fairly small, but for the purposes of development and testing
+# there are a number of packages that are useful to install.
+
+# Laying these out as separate requirements files, allows us to
+# only included the relevant sets when running tox, and ensures
+# we are only ever declaring our dependencies in one place.
+
+-r requirements/requirements-optionals.txt
+-r requirements/requirements-testing.txt
+-r requirements/requirements-documentation.txt
+-r requirements/requirements-codestyle.txt
+-r requirements/requirements-packaging.txt

requirements.txt

@@ -0,0 +1,3 @@
+flake8==3.7.7
+flake8-isort==2.7.0
+isort==4.3.21

requirements/requirements-codestyle.txt

@@ -0,0 +1,3 @@
+recommonmark==0.6.0
+Sphinx==2.2.0
+sphinx_rtd_theme==0.4.3

requirements/requirements-documentation.txt

@@ -0,0 +1,2 @@
+django-filter==2.2.0
+django-polymorphic==2.1.2