tests: check sphinx-apidoc output

* Checks that `spinhx-apidoc` has been run and the output matches what
  is in `docs/api/*`. (closes inveniosoftware#72)

Signed-off-by: Jose Benito Gonzalez Lopez <jose.benito.gonzalez@cern.ch>

.travis.yml

@@ -49,6 +49,12 @@ before_install:
          TRAVIS_COMMIT_RANGE=$PR_FIRST^..$TRAVIS_COMMIT
        fi
   - echo ${TRAVIS_COMMIT_RANGE}
+  - |
+      sphinx-apidoc -f -e -o docs/api/ claimstore
+      if [ -n "$(git status -s)" ]; then
+        echo "sphinx-apidoc and docs/api/* mismatch"
+        exit 1
+      fi
 
 install:
   - travis_retry pip install --upgrade pip

docs/api/claimstore.app.rst

@@ -1,4 +1,4 @@
-claimstore.app module
+xlaimstore.app module
 =====================
 
 .. automodule:: claimstore.app

run-tests.sh

@@ -18,6 +18,12 @@
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
 # USA.
 
+sphinx-apidoc -f -e -o docs/api/ claimstore
+if [ -n "$(git status -s)" ]; then
+  echo
+  echo "ERROR: there is a mismatch between sphinx-apidoc and docs/api. Check 'git status'."
+  exit 1
+fi
 sphinx-build -qnNW docs docs/_build/html
 python setup.py test
 sphinx-build -qnNW -b doctest docs docs/_build/doctest