docs: Add list of supported board to module page

jepler · jepler · commit f2b9e98a21e7 · 2021-07-24T14:11:04.000-05:00
diff --git a/conf.py b/conf.py
@@ -24,6 +24,7 @@
 import sys
 import urllib.parse
 import time
+from collections import defaultdict
 
 from sphinx.transforms import SphinxTransform
 from docutils import nodes
@@ -47,9 +48,15 @@
 
 #modules_support_matrix = shared_bindings_matrix.support_matrix_excluded_boards()
 modules_support_matrix = shared_bindings_matrix.support_matrix_by_board()
+modules_support_matrix_reverse = defaultdict(list)
+for board, modules in modules_support_matrix.items():
+    for module in modules:
+        modules_support_matrix_reverse[module].append(board)
+modules_support_matrix_reverse = dict((module, ", ".join(boards)) for module, boards in modules_support_matrix_reverse.items())
 
 html_context = {
-    'support_matrix': modules_support_matrix
+    'support_matrix': modules_support_matrix,
+    'support_matrix_reverse': modules_support_matrix_reverse
 }
 
 # -- General configuration ------------------------------------------------
@@ -94,6 +101,8 @@
 autoapi_python_class_content = "both"
 autoapi_python_use_implicit_namespaces = True
 autoapi_root = "shared-bindings"
+def autoapi_prepare_jinja_env(jinja_env):
+    jinja_env.globals['support_matrix_reverse'] = modules_support_matrix_reverse
 
 redirects_file = 'docs/redirects.txt'
 
diff --git a/docs/autoapi/templates/python/module.rst b/docs/autoapi/templates/python/module.rst
@@ -14,6 +14,18 @@
 
 {% endif %}
 
+{% if support_matrix_reverse[obj.name] is defined %}
+.. raw:: html
+
+    <p>
+    <details>
+    <summary>Module Availability</summary>
+    Available on: {{ support_matrix_reverse[obj.name] }}
+    </details>
+    </p>
+
+{% endif %}
+
 {% block subpackages %}
 {% set visible_subpackages = obj.subpackages|selectattr("display")|list %}
 {% if visible_subpackages %}
