Initial commit

.github/workflows/commit_checks.yaml

@@ -0,0 +1,104 @@
+name: Commit Checks
+
+on:
+  push:
+    branches:
+      - '*'
+  workflow_call:
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: 🔀 checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: "${{ secrets.GITHUB_TOKEN }}"
+          submodules: 'recursive'
+
+      - name: 📦 install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: 🐍 python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: 📦 sync depedencies
+        run: |
+          uv sync
+          uv sync --group test
+
+      - name: 🧪 run tests
+        id: test
+        run: |
+          uv run pytest -v
+  coverage:
+    name: Check coverage
+    runs-on: ubuntu-latest
+    steps:
+      - name: 🔀 checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: "${{ secrets.GITHUB_TOKEN }}"
+          submodules: 'recursive'
+
+      - name: 📦 install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: 🐍 python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: 📦 sync depedencies
+        run: |
+          uv sync
+          uv sync --group test
+
+      - name: 🧪 run tests
+        id: test
+        run: |
+          uv run pytest -v --cov
+
+      - name: 📊 generate coverage report
+        if: always()
+        run: |
+          uv run coverage json
+          cov_percent=$(jq '.totals.percent_covered' coverage.json)
+          cov_percent_rounded=$(python3 -c "print(round(${cov_percent}, 2))")
+          cov_lines=$(jq '.totals.covered_lines' coverage.json)
+          cov_missing=$(jq '.totals.missing_lines' coverage.json)
+          cov_total=$(jq '.totals.num_statements' coverage.json)
+          cov_excluded=$(jq '.totals.excluded_lines' coverage.json)
+          report_success=$(python3 -c "print(str(${cov_percent} == 100).lower())")
+
+          if (( $(echo "$cov_percent >= 100" | bc -l) )); then
+            badge_color="brightgreen"
+          elif (( $(echo "$cov_percent >= 90" | bc -l) )); then
+            badge_color="yellow"
+          else
+            badge_color="red"
+          fi
+
+          echo "## 📊 Coverage Report" >> $GITHUB_STEP_SUMMARY
+
+          echo "![Coverage: $cov_percent_rounded%](https://img.shields.io/badge/Coverage-$cov_percent_rounded%25-$badge_color)" >> $GITHUB_STEP_SUMMARY
+
+          echo "| Total Lines | Covered | Missing | Excluded |" >> $GITHUB_STEP_SUMMARY
+          echo "|-------------|---------|---------|----------|" >> $GITHUB_STEP_SUMMARY
+          echo "| $cov_total | $cov_lines | $cov_missing | $cov_excluded |" >> $GITHUB_STEP_SUMMARY
+
+          echo "<details>" >> $GITHUB_STEP_SUMMARY
+          echo "<summary>Details</summary>" >> $GITHUB_STEP_SUMMARY
+          echo '' >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+          uv run coverage report >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+          echo '' >> $GITHUB_STEP_SUMMARY
+          echo "</details>" >> $GITHUB_STEP_SUMMARY

.github/workflows/pr_checks.yaml

@@ -0,0 +1,48 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches:
+      - '*'
+
+jobs:
+  comment_coverage:
+    name: Comment coverage on PR
+    runs-on: ubuntu-latest
+    steps:
+      - name: 🔀 checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: "${{ secrets.GITHUB_TOKEN }}"
+          submodules: 'recursive'
+
+      - name: 📦 install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: 🐍 python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: 📦 sync depedencies
+        run: |
+          uv sync
+          uv sync --group test
+
+
+      - name: configure git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: 🧪 run coverage
+        run: |
+          uv run pytest --cov --junitxml=pytest.xml --cov-report=term-missing | tee pytest-coverage.txt
+        continue-on-error: true
+
+      - name: 📊 comment coverage
+        uses: MishaKav/pytest-coverage-comment@main
+        with:
+          pytest-coverage-path: pytest-coverage.txt
+          junitxml-path: pytest.xml

.github/workflows/release.yaml

@@ -0,0 +1,125 @@
+name: Bump version
+
+on:
+  workflow_dispatch:
+    inputs:
+      short_description:
+        type: string
+        description: "Short description of the release"
+        required: false
+      auto_bump:
+        type: boolean
+        description: "Auto bump version?"
+        required: true
+      bump_type:
+        type: choice
+        description: "Bump type"
+        required: true
+        options:
+          - "major"
+          - "minor"
+          - "patch"
+          - "prerelease"
+      as_pre_release:
+        type: boolean
+        description: "As pre-release?"
+        required: true
+      prerelease_type:
+        type: choice
+        description: "Pre-release label"
+        required: true
+        options:
+          - "dev"
+          - "alpha"
+          - "beta"
+          - "rc"
+          - "post"
+jobs:
+  bump_version:
+    runs-on: ubuntu-latest
+    name: Bump version and create release
+    steps:
+      - name: 🔀 checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: "${{ secrets.GITHUB_TOKEN }}"
+          submodules: "recursive"
+
+      - name: 📦 install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: 🐍 python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: 📦 sync depedencies
+        run: |
+          uv sync
+          uv sync --group bump
+
+      - name: configure git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: 📦 bump version (auto)
+        if: ${{ github.event.inputs.auto_bump == 'true' }}
+        run: |
+          if [ "${{ github.event.inputs.as_pre_release }}" == "true" ]; then
+            uv run semantic-release version --no-changelog --no-commit --no-push --as-prerelease --prerelease-token ${{ github.event.inputs.prerelease_type }}
+          else
+            uv run semantic-release version --no-changelog --no-commit --no-push
+          fi
+
+      - name: 📦 bump version (manual)
+        if: ${{ github.event.inputs.auto_bump == 'false' }}
+        run: |
+          if [ "${{ github.event.inputs.as_pre_release }}" == "true" ]; then
+            uv run semantic-release version --no-changelog --no-commit --no-push --${{ github.event.inputs.bump_type }} --as-prerelease --prerelease-token ${{ github.event.inputs.prerelease_type }}
+          else
+            uv run semantic-release version --no-changelog --no-commit --no-push --${{ github.event.inputs.bump_type }}
+          fi
+
+      - name: 📦 get new version
+        id: get_version
+        run: echo "BUMPED_VERSION=$(cat pyproject.toml | grep -e "^version = " | cut -d '"' -f 2)" >> $GITHUB_OUTPUT
+
+      - name: 📝 create changelog
+        run: |
+          uv run git-cliff -s header -l > release_body.md
+          echo "Changes:" && cat release_body.md
+          uv run git-cliff > CHANGELOG.md
+
+      - name: 📦 update lockfile (re-sync)
+        run: uv sync
+
+      - name: 📤 push changes
+        run: |
+          git add CHANGELOG.md pyproject.toml src/*/__init__.py uv.lock
+          git commit -m "chore(release): ${{ steps.get_version.outputs.BUMPED_VERSION }}"
+          git push origin main
+
+      - name: create release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.event.repository.name }} ${{ steps.get_version.outputs.BUMPED_VERSION }} - ${{ github.event.inputs.short_description }}
+          tag_name: ${{ steps.get_version.outputs.BUMPED_VERSION }}
+          body_path: release_body.md
+          prerelease: ${{ github.event.inputs.as_pre_release }}
+          discussion_category_name: "Announcements"
+
+      - name: 🧹 cleanup
+        run: |
+          rm release_body.md
+
+      - name: 📤 merge into develop
+        continue-on-error: true
+        run: |
+          git checkout develop
+          git merge main
+          git push origin develop
+
+      - name: ✅ done
+        run: echo "done"