add nox task for checking if the changelog got updated

Author: Jannis-Mittenzwei

.github/workflows/checks.yml

@@ -40,6 +40,22 @@ jobs:
         run: |
           poetry run python -m nox -s docs:build
 
+  Changelog:
+    name: Changelog Update Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: SCM Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python & Poetry Environment
+        uses: ./.github/actions/python-environment
+        with:
+          python-version: "3.9"
+
+      - name: Run changelog update check
+        run: poetry run nox -s changelog:updated
+
   build-matrix:
     name: Generate Build Matrix
     uses: ./.github/workflows/matrix-python.yml

exasol/toolbox/nox/_documentation.py

@@ -11,6 +11,9 @@
     PROJECT_CONFIG,
     Config,
 )
+import subprocess
+from pathlib import Path
+import sys
 
 
 def _build_docs(session: nox.Session, config: Config) -> None:
@@ -36,6 +39,19 @@ def _build_multiversion_docs(session: nox.Session, config: Config) -> None:
     )
 
 
+def _git_diff_changes_main() -> bool:
+    p = subprocess.run(
+        [
+            "git",
+            "diff",
+            "main",
+            "--quiet",
+            Path(PROJECT_CONFIG.root, "doc/changes")
+        ],
+        capture_output=True,
+    )
+    return bool(p.returncode)
+
 @nox.session(name="docs:multiversion", python=False)
 def build_multiversion(session: Session) -> None:
     """Builds the multiversion project documentation"""
@@ -64,3 +80,11 @@ def clean_docs(_session: Session) -> None:
     docs_folder = PROJECT_CONFIG.root / DOCS_OUTPUT_DIR
     if docs_folder.exists():
         shutil.rmtree(docs_folder)
+
+
+@nox.session(name="changelog:updated", python=False)
+def updated(_session: Session) -> None:
+    """Checks if the change log has been updated"""
+    if not _git_diff_changes_main():
+        print("Changelog have to be updated")
+        sys.exit(1)

exasol/toolbox/nox/tasks.py

@@ -58,6 +58,7 @@ def check(session: Session) -> None:
     build_docs,
     clean_docs,
     open_docs,
+    updated,
 )
 from exasol.toolbox.nox._release import prepare_release
 from exasol.toolbox.nox._shared import (

exasol/toolbox/templates/github/workflows/checks.yml

@@ -50,6 +50,22 @@ jobs:
     name: Generate Build Matrix
     uses: ./.github/workflows/matrix-python.yml
 
+  Changelog:
+    name: Changelog Update Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: SCM Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python & Poetry Environment
+        uses: ./.github/actions/python-environment
+        with:
+          python-version: "3.9"
+
+      - name: Run changelog update check
+        run: poetry run nox -s changelog:updated
+
   Lint:
     name: Linting (Python-${{ matrix.python-version }})
     needs: [ Version-Check, build-matrix ]