From 23873496a4878dd3e4f1e8991f5d83499c91ab6e Mon Sep 17 00:00:00 2001 From: Peter Galonza Date: Mon, 24 Jun 2024 10:07:18 +0300 Subject: [PATCH] feature: add release job with changelog --- .github/workflows/release.yml | 37 +++++++++++++++++++ configs/cliff.toml | 69 +++++++++++++++++++++++++++++++++++ 2 files changed, 106 insertions(+) create mode 100644 .github/workflows/release.yml create mode 100644 configs/cliff.toml diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 00000000..2f1d3ee2 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,37 @@ +name: Create release + +on: + push: + tags: + - '[0-9]+.[0-9]+.[0-9]+' + +permissions: + contents: write + +jobs: + build-workflow: + uses: ./.github/workflows/build-jobs.yaml + create-release: + runs-on: ubuntu-latest + needs: build-workflow + steps: + - name: Checkout + uses: actions/checkout@v4 + with: + fetch-depth: 0 + - name: Generate a changelog + uses: orhun/git-cliff-action@v3 + with: + config: ./configs/cliff.toml + args: --verbose + - name: Download artifact + uses: actions/download-artifact@v4 + with: + path: "./" + - name: Create release + uses: ncipollo/release-action@v1 + with: + artifacts: "hactoolnet-*/hactoolnet-*" + prerelease: false + name: "hactoolnet ${{ github.ref_name }}" + bodyFile: "git-cliff/CHANGELOG.md" diff --git a/configs/cliff.toml b/configs/cliff.toml new file mode 100644 index 00000000..f9762855 --- /dev/null +++ b/configs/cliff.toml @@ -0,0 +1,69 @@ +# git-cliff ~ configuration file +# https://git-cliff.org/docs/configuration + +[changelog] +# changelog header +header = """ +# Changelog\n +All notable changes to this project will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n +""" +# template for the changelog body +# https://keats.github.io/tera/docs/#introduction +body = """ +{% if version -%} + ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }} +{% else -%} + ## [Unreleased] +{% endif -%} +{% for group, commits in commits | group_by(attribute="group") %} + ### {{ group | upper_first }} + {% for commit in commits %} + - {{ commit.message | upper_first }}\ + {% endfor %} +{% endfor %}\n +""" +# template for the changelog footer +footer = """ + +""" +# remove the leading and trailing whitespace from the templates +trim = true + +[git] +# parse the commits based on https://www.conventionalcommits.org +conventional_commits = true +# filter out the commits that are not conventional +filter_unconventional = false +# process each line of a commit as an individual commit +split_commits = false +# regex for parsing and grouping commits +commit_parsers = [ + { message = "^feat", group = "Features" }, + { message = "^fix", group = "Bug Fixes" }, + { message = "^doc", group = "Documentation" }, + { message = "^perf", group = "Performance" }, + { message = "^refactor", group = "Refactor" }, + { message = "^style", group = "Styling" }, + { message = "^test", group = "Testing" }, + { message = "^chore\\(release\\): prepare for", skip = true }, + { message = "^chore", group = "Miscellaneous Tasks" }, + { body = ".*security", group = "Security" }, + { body = ".*", group = "Other (unconventional)" }, +] +# protect breaking changes from being skipped due to matching a skipping commit_parser +protect_breaking_commits = false +# filter out the commits that are not matched by commit parsers +filter_commits = true +# regex for matching git tags +tag_pattern = "[0-9]+.[0-9]+.[0-9]+" +# regex for skipping tags +skip_tags = "v0.1.0-beta.1" +# regex for ignoring tags +ignore_tags = "" +# sort the tags topologically +topo_order = false +# sort the commits inside sections by oldest/newest order +sort_commits = "oldest"