From 76561da67562809c25c6f5fe03897750e958e69d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Odd=20Str=C3=A5b=C3=B8?= Date: Sun, 17 Oct 2021 21:35:48 +0200 Subject: [PATCH] Improve changelog formatting --- .github/tools/reformat_changelog.py | 87 +++++++++++++++++++ .../workflows/create-prepare-release-pr.yaml | 9 +- 2 files changed, 93 insertions(+), 3 deletions(-) create mode 100755 .github/tools/reformat_changelog.py diff --git a/.github/tools/reformat_changelog.py b/.github/tools/reformat_changelog.py new file mode 100755 index 00000000..9a3f108e --- /dev/null +++ b/.github/tools/reformat_changelog.py @@ -0,0 +1,87 @@ +#!/usr/bin/env python3.8 + +import argparse +import sys +import re +from typing import Dict, List, Pattern, Union, TypedDict + +from emoji.core import emojize, demojize, replace_emoji + + +ITEM_FORMAT = "+ {title} ({issue}) @{username}" +OUTPUT_EMOJI = False + +ITEM_PATTERN: Pattern = re.compile( + r"^\s*(?P[-*+])\s*(?P.*?)\s*\(#(?P<issue>[0-9]+)\)\s*@(?P<username>[^\s]*)$" +) + + +class SectionType(TypedDict): + title: str + items: List[Dict[str, str]] + + +def reformat(item_format: str, output_emoji: bool) -> None: + data = [ + emojize(x.strip(), use_aliases=True, variant="emoji_type") + for x in sys.stdin.readlines() + if x.strip() + ] + + sections = [] + + section: Union[SectionType, Dict] = {} + for line in data: + if line.startswith("## "): + pass + if line.startswith("### "): + if section: + sections.append(section) + _section: SectionType = { + "title": line.strip("# "), + "items": [], + } + section = _section + + m = ITEM_PATTERN.match(line) + if m: + gd = m.groupdict() + section["items"].append(gd) + + sections.append(section) + + first = True + + for section in sections: + if not section: + continue + if first: + first = False + else: + print() + + title = section["title"] + if not output_emoji: + title = replace_emoji(title).strip() + + print(title) + print("-" * len(title)) + + for item in section["items"]: + formatted_item = item_format.format(**item) + if not output_emoji: + formatted_item = demojize(formatted_item) + print(formatted_item) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("--format", type=str, default=ITEM_FORMAT) + + parser.add_argument("--no-emoji", dest="emoji", action="store_false") + parser.add_argument("--emoji", dest="emoji", action="store_true") + parser.set_defaults(emoji=OUTPUT_EMOJI) + + args = parser.parse_args() + + reformat(args.format, args.emoji) diff --git a/.github/workflows/create-prepare-release-pr.yaml b/.github/workflows/create-prepare-release-pr.yaml index e09c5eaf..062cef08 100644 --- a/.github/workflows/create-prepare-release-pr.yaml +++ b/.github/workflows/create-prepare-release-pr.yaml @@ -22,14 +22,17 @@ jobs: - name: Parse Changlog run: | + pip install emoji cat << EOF >> cl.md ${{ steps.draft.outputs.body }} EOF - sed -i cl.md -e 's/^*/-/' TAG="${{ steps.draft.outputs.tag_name }}" echo "VERSION=${TAG#v}" >> $GITHUB_ENV + echo "YAML_CHANGELOG<<EOF" >> $GITHUB_ENV + cat cl.md | python .github/tools/reformat_changelog.py --no-emoji >> $GITHUB_ENV + echo "EOF" >> $GITHUB_ENV echo "CHANGELOG<<EOF" >> $GITHUB_ENV - cat cl.md | grep '^-' >> $GITHUB_ENV + cat cl.md | python .github/tools/reformat_changelog.py --emoji --format='+ #{issue} by @{username}' >> $GITHUB_ENV echo "EOF" >> $GITHUB_ENV rm cl.md @@ -38,7 +41,7 @@ jobs: - name: Update release.yaml run: | - yq eval '.version = env(VERSION) | .changelog = strenv(CHANGELOG) | .changelog style="literal"' -i release.yaml + yq eval '.version = env(VERSION) | .changelog = strenv(YAML_CHANGELOG) | .changelog style="literal"' -i release.yaml - name: Commit Changes run: |