Stacked PR for test generation and docs update

Makefile

@@ -29,10 +29,10 @@ build:
 	mkdir -p $(out_folder)
 	cd src && python generate_dashing.py
 	# Sublime Text
-	cd $(st_site) && dashing build
+	cd $(st_site) && dashing build | tee ../../$(out_folder)/dashing-$(st_submodule).txt
 	mv $(st_built_path) $(out_folder)
 	# Sublime Merge
-	cd $(sm_site) && dashing build
+	cd $(sm_site) && dashing build | tee ../../$(out_folder)/dashing-$(sm_submodule).txt
 	mv $(sm_built_path) $(out_folder)
 
 .PHONY: post-build

resources/sublime-text.toml

@@ -272,7 +272,7 @@ css = '#module-sublime_plugin h2 code'
 type = 'Module'
 
 [[selectors.api_reference]]
-css = 'dl.class > div > dt[id]'
+css = 'dl.class > div[id^=sublime]'
 attr = 'id'
 type = 'Class'
 
@@ -281,6 +281,11 @@ css = 'dl.class > dt[id]'
 attr = 'id'
 type = 'Class'
 
+[[selectors.api_reference]]
+css = 'dl.exception > dt[id]'
+attr = 'id'
+type = 'Exception'
+
 [[selectors.api_reference]]
 css = 'dl.function > dt[id]'
 attr = 'id'

src/generate_tests_from_dashing.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+
+"""
+Strip portions of the HTML pages that we don't need
+"""
+import sys
+from collections import defaultdict
+from re import match, sub
+
+DASHING_LOGS = [
+    '../out/dashing-sublime-merge.txt',
+    '../out/dashing-sublime-text.txt',
+]
+
+
+def dump_test_stuff(doc_path, assertions):
+    if not doc_path:
+        return
+
+    name = match(r'docs/([\w-]+)\.html', doc_path).group(1)
+    tests = f'''
+    def test_{name.replace('-', '_')}(self):
+        contains = [
+            {('\n' + (' ' * 12)).join(sorted(assertions.keys()))}
+        ]
+        self._test_a_doc_page_index('{doc_path}', contains)'''
+    print(tests)
+
+    for assertion in [k for k in sorted(assertions.keys()) if assertions[k] > 1]:
+        print(f'{" " * 8}### {assertion} was found {assertions[assertion]} times')
+
+
+def process_dashing_output(dashing_filepath):
+    doc_path = None
+    assertion_histogram = defaultdict(int)
+
+    with open(dashing_filepath, 'r') as dashing_file:
+
+        for line in dashing_file:
+            doc_path_match = match(r'(docs/[\w-]+\.html) looks like HTML$', line)
+            test_match = match(r"Match: '(.+)' is type (\w+) at", line)
+
+            if doc_path_match:
+                dump_test_stuff(doc_path, assertion_histogram)
+                assertion_histogram = defaultdict(int)
+                doc_path = doc_path_match.group(1)
+            elif test_match:
+                index_type = test_match.group(2)
+                index_text = test_match.group(1).replace('\\', '\\\\')
+                assertion = f"('{index_type}', '{index_text}'),"
+                assertion_histogram[assertion] += 1
+
+        dump_test_stuff(doc_path, assertion_histogram)
+
+
+def main():
+
+    for dump in DASHING_LOGS:
+        print(f'\n# Starting test case for {dump} ###########################')
+        process_dashing_output(dump)
+
+
+if __name__ == '__main__':
+    sys.exit(main())