15: Added workflow and noxfile

.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Create GitHub Release
+
+on:
+  push:
+    tags:
+      - '**'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Existing git tag to release (for example: v1.2.3)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-24.04
+    env:
+      TAG: ${{ inputs.tag || github.ref_name }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && format('refs/tags/{0}', inputs.tag) || github.ref }}
+
+      - name: Setup Python & Poetry Environment
+        uses: exasol/python-toolbox/.github/actions/python-environment@v9
+        with:
+          python-version: "3.10"
+          poetry-version: "2.3.0"
+
+      - name: Prepare release changelog
+        run: poetry run -- nox -s prepare-release -- --tag "$TAG"
+
+      - name: Create draft GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          changes_file="doc/changes/changes_${TAG}.md"
+          test -f "$changes_file"
+          gh release create "$TAG" \
+            --draft \
+            --title "$TAG" \
+            --notes-file "$changes_file"

noxfile.py

@@ -1,3 +1,4 @@
+import argparse
 from pathlib import Path
 
 from exasol.slc_ci_setup.nox.tasks import *
@@ -9,6 +10,40 @@
 nox.options.sessions = []
 
 
+@nox.session(name="prepare-release", python=False)
+def prepare_release(session: nox.Session):
+    """Prepare changelog files for the supplied release tag."""
+    parser = argparse.ArgumentParser(
+        usage=f"nox -s {session.name} -- --tag <tag>",
+    )
+    parser.add_argument("--tag", required=True, help="Release tag")
+    tag = parser.parse_args(session.posargs).tag
+
+    if Path(tag).name != tag:
+        session.error("Release tag must not contain a path separator.")
+
+    changes_dir = ROOT / "doc" / "changes"
+    unreleased_file = changes_dir / "unreleased.md"
+    changes_file = changes_dir / f"changes_{tag}.md"
+    changelog_file = changes_dir / "changelog.md"
+
+    if not unreleased_file.is_file():
+        session.error(f"Unreleased changelog file does not exist: {unreleased_file}")
+    if changes_file.exists():
+        session.error(f"Release changelog file already exists: {changes_file}")
+
+    changelog = changelog_file.read_text()
+    changelog_heading = "# Changes\n"
+    if not changelog.startswith(changelog_heading):
+        session.error(f"Unexpected changelog heading in: {changelog_file}")
+
+    release_entry = f"* [{tag}](changes_{tag}.md)\n"
+    changelog_file.write_text(
+        f"{changelog_heading}\n{release_entry}{changelog[len(changelog_heading):].lstrip()}"
+    )
+    unreleased_file.rename(changes_file)
+
+
 def get_oft_jar(session: nox.Session) -> Path:
     oft_version = "4.1.0"
     oft_jar = Path.home() / ".m2" / "repository" / "org" / "itsallcode" / "openfasttrace" / "openfasttrace" / oft_version / f"openfasttrace-{oft_version}.jar"