Include class summary in automodule docs

docs/_templates/module.rst_t

@@ -2,6 +2,16 @@
 
 Summary
 ^^^^^^^
+{#
+   TODO: Include these sections only if classes/functions exist in the current module.
+   The automodule directive currently doesn't pass enough info into the template context
+   to make this possible.
+#}
+.. rubric:: Classes
+.. automodsumm:: {{ qualname }}
+   :classes-only:
+
+.. rubric:: Functions
 .. automodsumm:: {{ qualname }}
    :functions-only:
 

docs/conf.py

@@ -190,6 +190,7 @@ def setup(app):
         * https://docs.readthedocs.io/en/stable/builds.html
         * https://github.com/sphinx-contrib/apidoc
     """
+    app.connect('config-inited', patch_sphinx_jinja_extensions)
     app.connect('builder-inited', document_models)
     app.connect('builder-inited', setup_external_files)
     app.connect('builder-inited', patch_automodapi)
@@ -211,6 +212,21 @@ def make_symlink(src, dest):
         symlink(src, dest)
 
 
+# TODO: Surely there's an easier way to do this?
+def patch_sphinx_jinja_extensions(*args):
+    """Monkey-patch Sphinx to enable Jinja extensions"""
+    from jinja2 import Environment
+    from sphinx.jinja2glue import SphinxFileSystemLoader
+
+    original_get_source = SphinxFileSystemLoader.get_source
+
+    def get_source(self, environment: Environment, template: str):
+        environment.add_extension('jinja2.ext.debug')
+        return original_get_source(self, environment, template)
+
+    SphinxFileSystemLoader.get_source = get_source
+
+
 def patch_automodapi(app):
     """Monkey-patch the automodapi extension to exclude imported members.