Move docs autoapi call to config.py setup

Makefile

@@ -134,7 +134,6 @@ coverage:
 .PHONY: docs
 docs: install-docs
 	@bash -c "source $(CONDA_HOME)/bin/activate $(CONDA_ENV); \
-		$(CUR_DIR)/docs/sphinx "apidoc" -o $(CUR_DIR)/docs/src $(CUR_DIR)/src; \
 		$(MAKE) -C $(CUR_DIR)/docs clean; \
 		$(MAKE) -C $(CUR_DIR)/docs html;"
 	$(BROWSER) $(CUR_DIR)/docs/build/html/index.html

docs/src/conf.py

@@ -55,5 +55,18 @@ def skip(app, what, name, obj, skip, options):
         return False
     return skip
 
+def run_apidoc(_):
+    argv = ["-o", "./src/", "../src/"]
+    try:
+        # Sphinx 1.7+
+        from sphinx.ext import apidoc
+        apidoc.main(argv)
+    except ImportError:
+        # Sphinx 1.6 (and earlier)
+        from sphinx import apidoc
+        argv.insert(0, apidoc.__file__)
+        apidoc.main(argv)
+
 def setup(app):
     app.connect("autodoc-skip-member", skip)
+    app.connect("builder-inited", run_apidoc)

tox.ini

@@ -62,7 +62,6 @@ deps =
     -r{toxinidir}/docs/requirements.txt
 whitelist_externals = make
 commands =
-    python docs/sphinx apidoc -o docs/src src
     make -C docs clean
     make -C docs html