Merge 14529ae into 4d800ab

.travis.yml

@@ -10,6 +10,6 @@ install:
   - pip install pytest flaky .
 script:
   - py.test -s -v --cov=convoys .
-  - sphinx-build -M html docs/ docs/_build/
+  - python setup.py build_sphinx
 after_success:
   - coveralls

docs/conf.py

@@ -119,6 +119,11 @@
 }
 
 
+# Mock modules during doc generation
+# TODO: would be nice if this is pulled automatically from setup.py
+autodoc_mock_imports = ['autograd', 'autograd-gamma', 'emcee', 'matplotlib', 'numpy', 'pandas', 'scipy']
+
+
 # -- Extension configuration -------------------------------------------------
 
 # -- Options for todo extension ----------------------------------------------

setup.py

@@ -1,4 +1,5 @@
 from setuptools import setup, find_packages
+from sphinx.setup_command import BuildDoc
 
 long_description = '''
 For more information, see
@@ -26,4 +27,12 @@
           'pandas',
           'numpy',
           'scipy',
-      ])
+      ],
+
+      # Sphinx-specific setup
+      cmdclass={'build_sphinx': BuildDoc},
+      command_options={
+        'build_sphinx': {
+            'source_dir': ('setup.py', 'docs'),
+            'build_dir': ('setup.py', 'docs/_build')}},
+)