Merge pull request #2399 from webknjaz/maintenance/towncrier-categories

📝 Enable showing news categories in towncrier log

changelog.d/2394.doc.rst

+Extended towncrier news template to include change note categories.
+This allows to see what types of changes a given version introduces
+-- by :user:`webknjaz`

pyproject.toml

@@ -15,7 +15,7 @@ backend-path = ["."]
     title_format = "v{version}"
     issue_format = "#{issue}"
     template = "towncrier_template.rst"
-    underlines = ["-"]
+    underlines = ["-", "^"]
 
     [[tool.towncrier.type]]
         directory = "deprecation"

towncrier_template.rst

 {% for section, _ in sections.items() %}
 {% set underline = underlines[0] %}{% if section %}{{section}}
 {{ underline * section|length }}
+{% set underline = underlines[1] %}
 {% endif %}
 
 {% if sections[section] %}
 {% for category, val in definitions.items() if category in sections[section]%}
+
+{{ definitions[category]['name'] }}
+{{ underline * definitions[category]['name']|length }}
 {% if definitions[category]['showcontent'] %}
 {% for text, values in sections[section][category].items() %}
 * {{ values|join(', ') }}: {{ text }}