split requirements

requirements.txt

@@ -1,4 +1 @@
-# List required packages in this file, one per line.
-numpy>=1.7.1
-vtk>=8.1.0
-scipy>=0.9
+-r requirements/default.txt

requirements/README.md

@@ -0,0 +1,50 @@
+# pip requirements files
+
+## Index
+
+- [default.txt](default.txt) Default requirements
+- [docs.txt](docs.txt) Documentation requirements
+- [optional.txt](optional.txt) Optional requirements
+- [test.txt](test.txt) Requirements for running test suite
+
+## Examples
+
+### Installing requirements
+
+```bash
+$ pip install -U -r requirements/default.txt
+$ pip install -U -r requirements/optional.txt
+```
+
+or 
+
+```bash
+conda install --yes --file=requirements/default.txt --file=requirements/optional.txt
+```
+
+### Running the tests
+
+```bash
+$ pip install -U -r requirements/default.txt
+$ pip install -U -r requirements/test.txt
+```
+
+or 
+
+```bash
+conda install --yes --file=requirements/default.txt --file=requirements/test.txt
+```
+
+### Running the Docs
+
+```bash
+$ pip install -U -r requirements/default.txt
+$ pip install -U -r requirements/optional.txt
+$ pip install -U -r requirements/docs.txt
+```
+
+or 
+
+```bash
+conda install --yes --file=requirements/default.txt --file=requirements/optional.txt --file=requirements/docs.txt
+```

requirements/default.txt

@@ -0,0 +1,4 @@
+# List required packages in this file, one per line.
+numpy>=1.7.1
+vtk>=8.1.0
+scipy>=0.9

requirements/docs.txt

@@ -0,0 +1,9 @@
+# These are dependencies of various sphinx extensions for documentation.
+sphinx
+ipython
+matplotlib
+numpydoc
+sphinx-copybutton
+sphinx-gallery
+pillow
+sphinx_rtd_theme

requirements/optional.txt

@@ -0,0 +1,2 @@
+matplotlib>=2.0.0
+dipy

requirements-dev.txt → requirements/test.txt

@@ -6,12 +6,5 @@ flake8
 # nosetests for numpy.testing<=1.15
 nose
 pytest
-sphinx
-# These are dependencies of various sphinx extensions for documentation.
-ipython
-matplotlib
-numpydoc
-sphinx-copybutton
-sphinx_rtd_theme
 # temporary Dependency for the tests
-dipy
+dipy

setup.py

@@ -30,7 +30,7 @@
 with open(path.join(here, 'README.rst'), encoding='utf-8') as readme_file:
     readme = readme_file.read()
 
-with open(path.join(here, 'requirements.txt')) as requirements_file:
+with open(path.join(here, 'requirements', 'default.txt')) as requirements_file:
     # Parse requirements.txt, ignoring any commented-out lines.
     requirements = [line for line in requirements_file.read().splitlines()
                     if not line.startswith('#')]