Fixes readthedocs documentation (#278)

* update conf

* Added requirements file

* updated reqs file

* update reqs

* catch pyspark import exception to make docs build

* try mocking out pyspark

* revert pyspark import change

* format code

* Show Python style violates in check_format.sh

bin/check_format.sh

@@ -58,6 +58,8 @@ if [ $num_py_violations -eq 0 ]; then
     echo "Passed Python PEP8 check"
 else
     echo "Found $num_py_violations Python PEP8 format violations"
+    find . -name '*.py' -print | egrep -v "yapf|ycm|googletest" \
+        | xargs python $CLIPPER_ROOT/bin/yapf/yapf -d
     exit 1
 fi
 

clipper_admin/docs/conf.py

@@ -34,10 +34,22 @@
 
 import sys
 import os
-import shlex
+# import shlex
 
 import sphinx_rtd_theme
 
+from mock import Mock as MagicMock
+
+
+class Mock(MagicMock):
+    @classmethod
+    def __getattr__(cls, name):
+        return MagicMock()
+
+
+MOCK_MODULES = ['pyspark']
+sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -115,7 +127,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # -- Options for HTMLHelp output ------------------------------------------
 

clipper_admin/requirements.txt

@@ -0,0 +1,7 @@
+requests==2.18.4
+subprocess32==3.2.7
+pyyaml==3.12
+docker==2.5.1
+kubernetes==3.0.0
+six==1.10.0
+mock