docs: introduce git-cliff

.cliff.toml

@@ -0,0 +1,63 @@
+[changelog]
+# changelog header
+header = """
+# Changelog
+All notable changes to this project will be documented in this file.
+For previous changelog entries, see [_docs/CHANGELOG-OLD.md](_docs/CHANGELOG-OLD.md).
+"""
+# template for the changelog body
+# https://tera.netlify.app/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 | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        {%- if commit.scope -%}
+            - **{{ commit.scope }}:** {{ commit.message | upper_first }} ([{{ commit.id | truncate(length=7, end="") }}](https://github.com/BiznetGIO/RESTKnot/commit/{{ commit.id }}))
+            {% if commit.breaking -%}
+            {% raw %}  {% endraw %}- **BREAKING!** ⚠️ : {{ commit.breaking_description }}
+            {% endif -%}
+            {% if commit.body -%}
+            {% raw %}\n{% endraw %}{% raw %}  {% endraw %}{{ commit.body | indent(width=4) }}{% raw %}\n{% endraw %}
+            {% endif -%}
+        {% else -%}
+            - {{ commit.message | upper_first }} ([{{ commit.id | truncate(length=7, end="") }}](https://github.com/BiznetGIO/RESTKnot/commit/{{ commit.id }}))
+            {% if commit.breaking -%}
+            {% raw %}  {% endraw %}- **BREAKING!** ⚠️ : {{ commit.breaking_description }}
+            {% endif -%}
+            {% if commit.body -%}
+            {% raw %}\n{% endraw %}{% raw %}  {% endraw %}{{ commit.body | indent(width=4) }}{% raw %}\n{% endraw %}
+            {% endif -%}
+        {% endif -%}
+    {% endfor -%}
+    {% raw %}\n{% endraw %}\
+{% endfor %}\n
+"""
+# remove the leading and trailing whitespaces from the template
+trim = true
+# changelog footer
+footer = """"""
+
+[git]
+# allow only conventional commits
+# https://www.conventionalcommits.org
+conventional_commits = true
+# regex for parsing and grouping commits
+commit_parsers = [
+  { message = "^feat", group = "<!-- 0 -->⛰️  Features" },
+  { message = "^fix", group = "<!-- 1 -->🐛 Bug Fixes" },
+  { message = "^refactor", group = "<!-- 2 -->🚜 Refactor" },
+  { message = "^doc", group = "<!-- 3 -->📚 Documentation" },
+  { message = "^perf", group = "<!-- 4 -->⚡ Performance" },
+  { message = "^test", group = "<!-- 5 -->🧪 Testing" },
+  { message = "^build", group = "<!-- 6 -->🏗️ Build" },
+  { message = "^ci", group = "<!-- 7 -->🤖 CI" },
+]
+# glob pattern for matching git tags
+tag_pattern = "v[0-9]*"
+# sort the commits inside sections by oldest/newest order
+sort_commits = "newest"

justfile

@@ -27,3 +27,8 @@ fmt-check:
 lint:
     # Run `typos  --write-changes` to fix the mistakes
     typos
+
+# Generate changelog
+changelog-gen version:
+    git-cliff --config .cliff.toml --output CHANGELOG.md --tag {{ version }}  v0.7.13..
+    just fmt