build: filter release notes to useful categories (#16)

templates/.macros.j2

@@ -0,0 +1,20 @@
+{%- macro render_type_commits(type_commits) -%}
+{%- for type_ in ("breaking", "feature", "performance", "fix", "documentation") -%}
+{%- if type_ in type_commits %}
+### {{ type_ | capitalize }}
+{% for commit in type_commits[type_] %}
+* {{ commit["descriptions"][0] }} ([`{{ commit.short_hash }}`]({{ commit.hexsha | commit_hash_url }}))
+{% set ns = namespace(skip_line=false) -%}
+{%- for line in commit["descriptions"][1:] -%}
+{# skip co-author annotations in commit messages and internal notes #}
+{%- if "---------" in line -%}
+{%- set ns.skip_line = true -%}
+{%- elif not ns.skip_line %}
+{{ line | indent(2, first=True, blank=True)}}
+{% endif -%}
+{%- endfor %}
+{%- endfor -%}
+{%- endif %}
+{%- endfor -%}
+{%- endmacro -%}
+

templates/.release_notes.md.j2

@@ -0,0 +1,3 @@
+{% import '.macros.j2' as macros -%}
+# {{ version.as_tag() }} ({{ release.tagged_date.strftime("%Y-%m-%d") }})
+{{ macros.render_type_commits(release["elements"]) }}

templates/CHANGELOG.md.j2

@@ -0,0 +1,10 @@
+{% import '.macros.j2' as macros -%}
+# CHANGELOG
+{%- if context.history.unreleased | length > 0 %}
+## Unreleased
+{{ macros.render_type_commits(context.history.unreleased) }}
+{%- endif %}
+{%- for version, release in context.history.released.items() %}
+## {{ version.as_semver_tag() }} ({{ release.tagged_date.strftime("%Y-%m-%d") }})
+{{ macros.render_type_commits(release["elements"]) }}
+{%- endfor %}