tests: check sphinx-apidoc output

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

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

.travis.yml

@@ -60,6 +60,9 @@ before_script:
   - travis_retry pip install kwalitee GitPython --pre  # needs recent pep257
   - kwalitee check message -s ${TRAVIS_COMMIT_RANGE}
   - travis_retry pip install pytest-pep257  # needs older pep257
+  - travis_retry pip install sphinx
+  - sphinx-apidoc -f -e -o docs/api/ claimstore
+  - if [ -n "$(git status -s)" ]; then echo "Mismatch between the output of sphinx-apidoc and the files in docs/api/*. Please, run 'sphinx-apidoc -f -e -o docs/api/ claimstore' and commit/push again." && exit 1; fi
 
 script:
   - python setup.py test

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 output and the actual content of 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