NEW: Add type, format, transformer info to plugin pages

source/sphinx_extensions/plugin_directory/extension.py

@@ -46,14 +46,31 @@ def generate_rst(app):
         fh.write(rendered)
 
     for plugin in plugins.values():
+        transformers_list = []
+
+        for from_type, to_type in plugin.transformers:
+            from_type = repr(from_type) \
+                .replace("<class '", "").replace("'>", "").split('.')[-1]
+            to_type = repr(to_type) \
+                .replace("<class '", "").replace("'>", "").split('.')[-1]
+
+            transformers_list.append((from_type, to_type))
+
+        # .upper() because Python sorts all capitalized elements above all
+        # lowercase ones, and I figured we didn't want 'dict' sorting under
+        # 'TaxonomicClassifierDirFmt'
+        transformers_list.sort(
+            key=lambda element: (element[0].upper(), element[1].upper()))
+
         plugin_cli_name = plugin.name.replace('_', '-')
         plugin_dir = os.path.join(rst_dir, plugin_cli_name)
         os.mkdir(plugin_dir)
 
         index_path = os.path.join(plugin_dir, 'index.rst')
         with open(index_path, 'w') as fh:
             template = env.get_template('plugin.rst')
-            rendered = template.render(title=plugin_cli_name, plugin=plugin)
+            rendered = template.render(title=plugin_cli_name, plugin=plugin,
+                                       transformers_list=transformers_list)
             fh.write(rendered)
 
         if plugin.citations:

source/sphinx_extensions/plugin_directory/templates/plugin.rst

@@ -112,3 +112,30 @@ Visualizers
    {{ id.replace('_', '-') }}
    {% endfor %}
 {% endif %}
+
+{% if plugin.types %}
+Types
+-----
+
+{% for id, _ in plugin.types|dictsort %}
+- {{ id }}
+{% endfor %}
+{% endif %}
+
+{% if plugin.formats %}
+Formats
+-------
+
+{% for id, _ in plugin.formats|dictsort %}
+- {{ id }}
+{% endfor %}
+{% endif %}
+
+{% if plugin.transformers %}
+Transformers
+------------
+
+{% for from, to in transformers_list %}
+- {{ from }} -> {{ to }}
+{% endfor %}
+{% endif %}