Modernize: Python 2 + pygame 1.9.3 → Python 3.12+ + pygame-ce

.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml,toml,json}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.dat]
+end_of_line = lf
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,26 @@
+# Normalize line endings: treat everything as text with LF in the repo, but let
+# Git auto-detect binary files so it never mangles them.
+* text=auto eol=lf
+
+# Source and data files are always LF.
+*.py    text eol=lf
+*.dat   text eol=lf
+*.cfg   text eol=lf
+*.toml  text eol=lf
+*.md    text eol=lf
+*.yml   text eol=lf
+*.yaml  text eol=lf
+
+# Binary assets — never touch these.
+*.png   binary
+*.jpg   binary
+*.jpeg  binary
+*.bmp   binary
+*.gif   binary
+*.svg   text eol=lf
+*.ogg   binary
+*.mp3   binary
+*.wav   binary
+*.ttf   binary
+*.otf   binary
+*.zip   binary

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / py${{ matrix.python }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.12", "3.13", "3.14"]
+    env:
+      # Run pygame without a real display or audio device.
+      SDL_VIDEODRIVER: dummy
+      SDL_AUDIODRIVER: dummy
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install SDL2 runtime libraries (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libsdl2-2.0-0 libsdl2-image-2.0-0 libsdl2-mixer-2.0-0 libsdl2-ttf-2.0-0 \
+            libfreetype6 libportmidi0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python }}
+        run: uv python install ${{ matrix.python }}
+
+      - name: Install project
+        run: uv sync --all-extras --python ${{ matrix.python }}
+
+      - name: Lint
+        run: uv run --python ${{ matrix.python }} ruff check .
+
+      - name: Format check
+        run: uv run --python ${{ matrix.python }} ruff format --check .
+
+      - name: Type check
+        run: uv run --python ${{ matrix.python }} mypy src
+
+      - name: Tests
+        run: uv run --python ${{ matrix.python }} pytest
+
+      - name: Headless smoke run
+        run: uv run --python ${{ matrix.python }} exit-dash-hyperion --headless --frames 120

.gitignore

@@ -99,3 +99,21 @@ ENV/
 
 # mypy
 .mypy_cache/
+
+# Ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+
+# uv
+# (uv.lock IS committed for reproducible installs)
+
+# IDEs / editors
+.idea/
+.vscode/
+*.swp
+*~
+
+# macOS
+.DS_Store