[docs] requirements for readthedocs (#82)

.readthedocs.yaml

@@ -1,4 +1,3 @@
-# read-the-docs.yaml
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
@@ -10,15 +9,16 @@ sphinx:
   configuration: doc/conf.py
   fail_on_warning: true
 
-# Optionally build your docs in additional formats such as PDF and ePub
+# Build your docs in additional formats such as PDF and ePub
 # [], all, or - epub, - pdf
 formats: []
 
-# Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.6
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+   version: 3.6
+   install:
+      - requirements: doc/requirements.txt
+      # Unfortunately can only do this from pip
+      # - method: setuptools
+      #   path: .
+      #   extra_requirements:
+      #       - docs

doc/requirements.txt

@@ -0,0 +1,14 @@
+##############################################################################
+#
+# Requirements for sphinx documentation environment. Most dependencies
+# are mocked.
+#
+# This file is discovered by the root level
+# .readthedocs.yaml (rtd build) and docenv.bash (local build)
+##############################################################################
+
+Sphinx<2
+sphinx-argparse<0.3
+sphinx_rtd_theme<0.5
+sphinx-autodoc-typehints==1.6.0
+py_trees>=1.1

docenv.bash

@@ -88,7 +88,8 @@ if [ "${VIRTUAL_ENV}" == "" ]; then
 fi
 
 # Get all dependencies for doc generation
-pip install -e .[docs]
+# pip install -e .[docs]
+pip install -r doc/requirements.txt
 
 # NB: this automagically nabs install_requires
 python setup.py develop

setup.py

@@ -5,15 +5,6 @@
 
 package_name = 'py_trees_ros'
 
-extras_require = {
-    'docs': ["Sphinx<2",
-             "sphinx-argparse<0.3",
-             "sphinx_rtd_theme<0.5",
-             "sphinx-autodoc-typehints==1.6.0",
-             'py_trees'
-             ],
-}
-
 setup(
     name=package_name,
     version='1.0.0',
@@ -25,7 +16,7 @@
     ],
     package_data={},
     install_requires=[],
-    extras_require=extras_require,
+    extras_require={},
     author='Daniel Stonier, Naveed Usmani, Michal Staniaszek',
     maintainer='Daniel Stonier <d.stonier@gmail.com>',
     url='https://github.com/splintered-reality/py_trees_ros',