build(python): migrate to pyproject.toml and uv tooling (#140)

Author: ReenigneArcher

.github/workflows/ci.yml

@@ -12,6 +12,9 @@ concurrency:
   group: "${{ github.workflow }}-${{ github.ref }}"
   cancel-in-progress: true
 
+env:
+  PYTHON_VERSION: '3.14'
+
 jobs:
   setup_release:
     name: Setup Release
@@ -173,21 +176,18 @@ jobs:
         id: setup-python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
-          python-version: '3.14'
+          python-version: ${{ env.PYTHON_VERSION }}
 
-      - name: Python Path
-        id: python-path
-        run: |
-          if [ "${{ runner.os }}" = "Windows" ]; then
-            # replace backslashes with double backslashes
-            python_path=$(echo "${{ steps.setup-python.outputs.python-path }}" | sed 's/\\/\\\\/g')
-          else
-            python_path=${{ steps.setup-python.outputs.python-path }}
-          fi
+      - name: Setup uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+        with:
+          enable-cache: true
 
-          # step output
-          echo "python-path=${python_path}"
-          echo "python-path=${python_path}" >> "${GITHUB_OUTPUT}"
+      - name: Sync Python tools
+        env:
+          MSYS2_PATH_TYPE: inherit
+          UV_PYTHON: ${{ steps.setup-python.outputs.python-path }}
+        run: uv sync --locked
 
       - name: Configure
         run: |
@@ -271,9 +271,10 @@ jobs:
           always() &&
           (steps.test.outcome == 'success' || steps.test.outcome == 'failure')
         working-directory: build
+        env:
+          MSYS2_PATH_TYPE: inherit
         run: |
-          ${{ steps.python-path.outputs.python-path }} -m pip install gcovr
-          ${{ steps.python-path.outputs.python-path }} -m gcovr . -r ../src \
+          uv run --locked gcovr . -r ../src \
             --exclude-noncode-lines \
             --exclude-throw-branches \
             --exclude-unreachable-branches \

.gitignore

@@ -37,6 +37,9 @@
 # VSCode IDE
 .vscode/
 
+# Python
+.venv/
+
 # build directories
 build/
 cmake-*/

README.md

@@ -84,6 +84,15 @@ cmake -G Ninja -B build -S .
 ninja -C build
 ```
 
+## Python Tooling
+
+Install [uv](https://docs.astral.sh/uv/) to sync and run the Python tools:
+
+```bash
+uv sync
+uv run python scripts/update_clang_format.py
+```
+
 ## Demo
 
 Execute the `tray_example` application:

pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "tray"
+version = "0.0.0"
+description = "A cross-platform system tray library"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = []
+
+[dependency-groups]
+dev = [
+    "clang-format==21.*",
+    "gcovr==8.6",
+]