Update for sphinx 2.0 and filter warning from sphinx_rtd_theme, pending

readthedocs/sphinx_rtd_theme#728

api-doc/source/conf.py

@@ -15,8 +15,6 @@
 import sys
 import os
 
-from recommonmark.parser import CommonMarkParser
-
 # 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.
@@ -40,11 +38,6 @@
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
-source_parsers = {
-    '.md': CommonMarkParser,
-}
-
 source_suffix = ['.rst', '.md']
 
 # The encoding of source files.

tests/test_apidoc.py

@@ -33,10 +33,10 @@ def test_lint_docstrings():
     p = subprocess.Popen('make html', shell=True, cwd=_path('api-doc'), stderr=subprocess.PIPE)
     _, stderr = p.communicate()
 
-    # Filter the deprecation warning from the cryptography package
+    # Filter any warnings we want to be okay with
     if stderr:
         stderr_lines = stderr.split(b"\n")
-        stderr = b"\n".join(l for l in stderr_lines if b'MIPS instruction groups' not in l)
+        stderr = b"\n".join(l for l in stderr_lines if b'sphinx_rtd_theme/search.html:20' not in l and b'{{ super() }}' not in l)
 
     if stderr:
         raise Exception("The following warnings were generated while building the API documentation:\n\n%s" % stderr.decode())