Feature/add calver release process

.cz.toml

@@ -0,0 +1,4 @@
+[tool.commitizen]
+tag_format = "v$version"
+version_provider = "pep621"
+update_changelog_on_bump = true

.github/workflows/.python-version

@@ -0,0 +1 @@
+3.10

.github/workflows/merge-demo-feature.yml

@@ -11,6 +11,17 @@ env:
   ROBUST_MATURIN_DEMO__APP_AUTHOR: ${{ github.repository_owner }}
 
 jobs:
+  update-demo:
+    name: Update Demo
+    uses: ./.github/workflows/update-demo.yml
+    strategy:
+      matrix:
+        demo_name:
+          - "robust-python-demo"
+          - "robust-maturin-demo"
+    with:
+      demo_name: ${{ matrix.demo_name }}
+
   merge-demo-feature:
     name: Merge Demo Feature
     runs-on: ubuntu-latest
@@ -24,12 +35,21 @@ jobs:
         uses: actions/checkout@v4
         with:
           repository: ${{ github.repository }}
-          path: "${{ github.workspace }}/cookiecutter-robust-python"
 
-      - name: Sync Demo
-        uses: "${{ github.workspace }}/cookiecutter-robust-python/.github/workflows/update-demo.yml"
+      - name: Checkout Demo
+        uses: actions/checkout@v4
+        with:
+          repository: "${{ github.repository_owner }}/${{ inputs.demo_name }}"
+          path: ${{ inputs.demo_name }}
+          ref: develop
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          demo_name: ${{ matrix.demo_name }}
+          python-version-file: "${{ github.workspace }}/cookiecutter-robust-python/.github/workflows/.python-version"
 
       - name: Merge Demo Feature PR into Develop
         working-directory: "${{ github.workspace }}/${{ matrix.demo_name }}"

.github/workflows/prepare-release.yml

@@ -0,0 +1,52 @@
+name: Prepare Release
+
+on:
+  push:
+    branches:
+      - "release/*"
+
+permissions:
+  contents: write
+
+jobs:
+  prepare-release:
+    name: Prepare Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .github/workflows/.python-version
+
+      - name: Get Current Version
+        id: current_version
+        run: echo "CURRENT_VERSION=$(uvx --from commitizen cz version -p)" >> $GITHUB_OUTPUT
+
+      - name: Get New Release Version
+        id: new_version
+        run: echo "NEW_VERSION=${GITHUB_REF_NAME#release/}" >> $GITHUB_OUTPUT
+
+      - name: Bump Version
+        if: ${{ steps.current_version.outputs.CURRENT_VERSION != steps.new_version.outputs.NEW_VERSION }}
+        run: uvx nox -s bump-version ${{ steps.new_version.outputs.NEW_VERSION }}
+
+      - name: Get Release Notes
+        run: uvx nox -s get-release-notes -- ${{ github.workspace }}-CHANGELOG.md
+
+      - name: Create Release Draft
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: ${{ github.workspace }}-CHANGELOG.md
+          draft: true
+          tag_name: v${{ steps.new_version.outputs.NEW_VERSION }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release-template.yml

@@ -0,0 +1,147 @@
+# .github/workflows/release-template.yml
+# Automated release workflow for the cookiecutter-robust-python template
+# Uses Calendar Versioning (CalVer): YYYY.MM.MICRO
+
+name: Release Template
+
+on:
+  push:
+    branches:
+      - main
+
+  workflow_dispatch:
+    inputs:
+      micro_version:
+        description: 'Override micro version (leave empty for auto-increment)'
+        required: false
+        type: string
+
+jobs:
+  bump_and_build:
+    name: Bump Version & Build
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.VERSION }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".github/workflows/.python-version"
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version and generate changelog
+        run: |
+          if [ -n "${{ inputs.micro_version }}" ]; then
+            uvx nox -s bump-version -- ${{ inputs.micro_version }}
+          else
+            uvx nox -s bump-version
+          fi
+
+      - name: Get version
+        id: version
+        run: |
+          VERSION=$(uvx --from commitizen cz version -p)
+          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Push version bump commit
+        run: git push origin HEAD
+
+      - name: Build packages
+        run: uvx nox -s build-python
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ steps.version.outputs.VERSION }}
+          path: dist/
+          retention-days: 7
+
+  publish_testpypi:
+    name: Publish to TestPyPI
+    runs-on: ubuntu-latest
+    needs: bump_and_build
+    permissions:
+      id-token: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-${{ needs.bump_and_build.outputs.version }}
+          path: dist/
+
+      - name: Publish to TestPyPI
+        run: uvx nox -s publish-python -- --test-pypi
+
+  publish_pypi:
+    name: Tag & Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [bump_and_build, publish_testpypi]
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: main
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".github/workflows/.python-version"
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Pull latest (includes version bump)
+        run: git pull origin main
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-${{ needs.bump_and_build.outputs.version }}
+          path: dist/
+
+      - name: Create and push tag
+        run: uvx nox -s tag-version -- push
+
+      - name: Publish to PyPI
+        run: uvx nox -s publish-python
+
+      - name: Extract release notes
+        run: uvx nox -s get-release-notes -- release_notes.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ needs.bump_and_build.outputs.version }}
+          name: v${{ needs.bump_and_build.outputs.version }}
+          body_path: release_notes.md
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/sync-demos.yml

@@ -7,21 +7,11 @@ on:
 jobs:
   update-demo:
     name: Update Demo
-    runs-on: ubuntu-latest
-
+    uses: ./.github/workflows/update-demo.yml
     strategy:
       matrix:
         demo_name:
           - "robust-python-demo"
           - "robust-maturin-demo"
-    steps:
-      - name: Checkout Template
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ github.repository }}
-          path: "${{ github.workspace }}/cookiecutter-robust-python"
-
-      - name: Update Demo
-        uses: "${{ github.workspace }}/cookiecutter-robust-python/.github/workflows/update-demo.yml"
-        with:
-          demo_name: ${{ matrix.demo_name }}
+    with:
+      demo_name: ${{ matrix.demo_name }}

.github/workflows/update-demo.yml

@@ -16,6 +16,12 @@ jobs:
   update-demo:
     runs-on: ubuntu-latest
     steps:
+      - name: Checkout Template
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository }}
+          path: "${{ github.workspace }}/cookiecutter-robust-python"
+
       - name: Checkout Demo
         uses: actions/checkout@v4
         with:
@@ -29,7 +35,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version-file: ".github/workflows/.python-version"
+          python-version-file: "${{ github.workspace }}/cookiecutter-robust-python/.github/workflows/.python-version"
 
       - name: Update Demo
         working-directory: "${{ github.workspace }}/cookiecutter-robust-python"