Tweaked autodoc to skip :internal: methods.

docs/conf.py

@@ -17,6 +17,7 @@ import sys, os
 # 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.
 sys.path.append(os.path.abspath('_themes'))
+sys.path.append(os.path.abspath('.'))
 
 # -- General configuration -----------------------------------------------------
 
@@ -25,7 +26,8 @@ sys.path.append(os.path.abspath('_themes'))
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx',
+              'flaskdocext']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/flaskdocext.py

@@ -0,0 +1,16 @@
+import re
+import inspect
+
+
+_internal_mark_re = re.compile(r'^\s*:internal:\s*$(?m)')
+
+
+def skip_member(app, what, name, obj, skip, options):
+    docstring = inspect.getdoc(obj)
+    if skip:
+        return True
+    return _internal_mark_re.search(docstring or '') is not None
+
+
+def setup(app):
+    app.connect('autodoc-skip-member', skip_member)