Update bundled SDL to 3.4.18

Update ReadTheDocs to Ubuntu 26.04, fetch SDL from APT

Add newer SDL dependencies

Author: HexDecimal

.github/workflows/python-package.yml

@@ -18,7 +18,7 @@ defaults:
 
 env:
   git-depth: 0 # Depth to search for tags.
-  sdl-version: "3.2.16" # SDL version to bundle
+  sdl-version: "3.4.18" # SDL version to bundle
 
 jobs:
   ruff:
@@ -53,7 +53,7 @@ jobs:
     runs-on: ubuntu-26.04-arm
     timeout-minutes: 5
     steps:
-      - uses: libsdl-org/setup-sdl@1894460666e4fe0c6603ea0cce5733f1cca56ba1
+      - uses: libsdl-org/setup-sdl@v1.0.1
         with:
           install-linux-dependencies: true
           build-type: "Debug"
@@ -143,7 +143,7 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install xvfb
-      - uses: libsdl-org/setup-sdl@1894460666e4fe0c6603ea0cce5733f1cca56ba1
+      - uses: libsdl-org/setup-sdl@v1.0.1
         if: runner.os == 'Linux'
         with:
           install-linux-dependencies: true
@@ -178,25 +178,21 @@ jobs:
 
   test-docs:
     needs: [ruff, mypy, sdist]
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-26.04
     timeout-minutes: 15
     steps:
-      - uses: libsdl-org/setup-sdl@1894460666e4fe0c6603ea0cce5733f1cca56ba1
-        if: runner.os == 'Linux'
-        with:
-          install-linux-dependencies: true
-          build-type: "Debug"
-          version: ${{ env.sdl-version }}
+      - name: APT update
+        run: sudo apt-get update
+      - name: Install SDL
+        run: sudo apt-get install libsdl3-dev
       - uses: actions/checkout@v7
         with:
           persist-credentials: false
           fetch-depth: ${{ env.git-depth }}
       - name: Checkout submodules
         run: git submodule update --init --recursive --depth 1
       - name: Install Python dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r docs/requirements.txt
+        run: pip install -r docs/requirements.txt
       - name: Install package
         run: pip install -e .
         env:
@@ -226,7 +222,7 @@ jobs:
       - name: Install Python dependencies
         run: |
           python -m pip install --upgrade pip tox
-      - uses: libsdl-org/setup-sdl@1894460666e4fe0c6603ea0cce5733f1cca56ba1
+      - uses: libsdl-org/setup-sdl@v1.0.1
         if: runner.os == 'Linux'
         with:
           install-linux-dependencies: true
@@ -265,12 +261,13 @@ jobs:
             yum install -y epel-release &&
             yum-config-manager --enable epel &&
             yum install -y gcc git-core make cmake \
-                alsa-lib-devel pulseaudio-libs-devel \
+                alsa-lib-devel fribidi-devel pulseaudio-libs-devel pipewire-devel \
                 libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXfixes-devel \
-                libXi-devel libXScrnSaver-devel dbus-devel ibus-devel \
+                libXi-devel libXScrnSaver-devel libXtst-devel dbus-devel ibus-devel \
                 systemd-devel mesa-libGL-devel libxkbcommon-devel mesa-libGLES-devel \
                 mesa-libEGL-devel vulkan-devel wayland-devel wayland-protocols-devel \
-                libdrm-devel mesa-libgbm-devel libusb-devel
+                libdrm-devel mesa-libgbm-devel libusb1-devel libdecor-devel \
+                pipewire-jack-audio-connection-kit-devel libthai-devel
             git clone --depth 1 --branch release-${{env.sdl-version}} https://github.com/libsdl-org/SDL.git sdl_repo &&
             cmake -S sdl_repo -B sdl_build &&
             cmake --build sdl_build --config Release &&

.readthedocs.yaml

@@ -5,21 +5,12 @@
 version: 2
 
 build:
-  os: ubuntu-24.04
+  os: ubuntu-26.04
   tools:
-    python: "3.11"
+    python: "3.14"
   apt_packages:
-    - build-essential
-    - make
     - pkg-config
-    - cmake
-    - ninja-build
-  jobs:
-    pre_install:
-      - git clone --depth 1 --branch release-3.2.16 https://github.com/libsdl-org/SDL.git sdl_repo
-      - cmake -S sdl_repo -B sdl_build -D CMAKE_INSTALL_PREFIX=~/.local
-      - cmake --build sdl_build --config Debug
-      - cmake --install sdl_build
+    - libsdl3-dev
 
 submodules:
   include: all

.vscode/settings.json

@@ -173,6 +173,7 @@
         "fonty",
         "freethreading",
         "freetype",
+        "fribidi",
         "frombuffer",
         "fullscreen",
         "furo",
@@ -277,11 +278,13 @@
         "letterpaper",
         "LGUI",
         "LHYPER",
+        "libdecor",
         "libdrm",
         "libgbm",
         "libsdl",
         "libtcod",
         "libtcodpy",
+        "libthai",
         "libusb",
         "libxkbcommon",
         "linspace",
@@ -369,6 +372,7 @@
         "PERLIN",
         "PILCROW",
         "pilmode",
+        "pipewire",
         "PIXELART",
         "PIXELFORMAT",
         "PLUSMINUS",
@@ -553,6 +557,7 @@
         "Xfixes",
         "Xrandr",
         "xrel",
+        "Xtst",
         "xvfb",
         "ydst",
         "yrel",

CHANGELOG.md

@@ -6,6 +6,10 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 
 ## [Unreleased]
 
+### Changed
+
+- Updated bundled SDL to 3.4.18
+
 ### Fixed
 
 - `tcod.path.SimpleGraph` caps its automatic diagonal heuristic at two cardinal steps when those are cheaper. https://github.com/libtcod/python-tcod/pull/198

build_sdl.py

@@ -46,9 +46,9 @@ def python_machine() -> str:
 # Reject versions of SDL older than this, update the requirements in the readme if you change this.
 SDL_MIN_VERSION = (3, 2, 0)
 # The SDL version to parse and export symbols from.
-SDL_PARSE_VERSION = os.environ.get("SDL_VERSION", "3.2.16")
+SDL_PARSE_VERSION = os.environ.get("SDL_VERSION", "3.4.18")
 # The SDL version to include in binary distributions.
-SDL_BUNDLE_VERSION = os.environ.get("SDL_VERSION", "3.2.16")
+SDL_BUNDLE_VERSION = os.environ.get("SDL_VERSION", "3.4.18")
 
 
 # Used to remove excessive newlines in debug outputs.
@@ -105,6 +105,7 @@ def python_machine() -> str:
     "SDL_SensorEvent",
     "SDL_QuitEvent",
     "SDL_UserEvent",
+    "SDL_PinchFingerEvent",
 )
 
 # Other defined names which sometimes cause issues when parsed.