Merge 46039a2 into 4d800ab

.travis.yml

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

docs/conf.py

@@ -119,6 +119,12 @@
 }
 
 
+# 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')}},
+      )