Drop Python 3.8 and 3.9 support

Apply Ruff safe fixes

Author: HexDecimal

.github/workflows/python-package.yml

@@ -95,14 +95,14 @@ jobs:
     strategy:
       matrix:
         os: ["ubuntu-latest", "windows-latest"]
-        python-version: ["3.8", "pypy-3.8"]
+        python-version: ["3.10", "pypy-3.10"]
         architecture: ["x64"]
         include:
           - os: "windows-latest"
-            python-version: "3.8"
+            python-version: "3.10"
             architecture: "x86"
           - os: "windows-latest"
-            python-version: "pypy-3.8"
+            python-version: "pypy-3.10"
             architecture: "x86"
       fail-fast: false
 
@@ -215,9 +215,9 @@ jobs:
     strategy:
       matrix:
         arch: ["x86_64", "aarch64"]
-        build: ["cp38-manylinux*", "pp38-manylinux*"]
+        build: ["cp310-manylinux*", "pp310-manylinux*"]
     env:
-      BUILD_DESC:
+      BUILD_DESC: ""
     steps:
       - uses: actions/checkout@v4
         with:
@@ -272,9 +272,9 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python: ["cp38-*_universal2", "pp38-*"]
+        python: ["cp310-*_universal2", "pp310-*"]
     env:
-      PYTHON_DESC:
+      PYTHON_DESC: ""
     steps:
       - uses: actions/checkout@v4
         with:

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
       - id: fix-byte-order-marker
       - id: detect-private-key
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.8
+    rev: v0.11.11
     hooks:
       - id: ruff
         args: [--fix-only, --exit-non-zero-on-fix]

CHANGELOG.md

@@ -6,6 +6,10 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 
 ## [Unreleased]
 
+### Removed
+
+- Support dropped for Python 3.8 and 3.9.
+
 ## [18.1.0] - 2025-05-05
 
 ### Added

README.rst

@@ -46,7 +46,7 @@ For the most part it's just::
 ==============
  Requirements
 ==============
-* Python 3.8+
+* Python 3.10+
 * Windows, Linux, or MacOS X 10.9+.
 * On Linux, requires libsdl2 (2.0.10+).
 

build_libtcod.py

@@ -9,8 +9,9 @@
 import platform
 import re
 import sys
+from collections.abc import Iterable, Iterator
 from pathlib import Path
-from typing import Any, ClassVar, Iterable, Iterator
+from typing import Any, ClassVar
 
 from cffi import FFI
 
@@ -20,7 +21,7 @@
 
 import build_sdl
 
-Py_LIMITED_API = 0x03060000
+Py_LIMITED_API = 0x03100000
 
 HEADER_PARSE_PATHS = ("tcod/", "libtcod/src/libtcod/")
 HEADER_PARSE_EXCLUDES = ("gl2_ext_.h", "renderer_gl_internal.h", "event.h")

examples/eventget.py

@@ -5,8 +5,6 @@
 # https://creativecommons.org/publicdomain/zero/1.0/
 """An demonstration of event handling using the tcod.event module."""
 
-from typing import List, Set
-
 import tcod.context
 import tcod.event
 import tcod.sdl.joystick
@@ -17,11 +15,11 @@
 
 def main() -> None:
     """Example program for tcod.event."""
-    event_log: List[str] = []
+    event_log: list[str] = []
     motion_desc = ""
     tcod.sdl.joystick.init()
-    controllers: Set[tcod.sdl.joystick.GameController] = set()
-    joysticks: Set[tcod.sdl.joystick.Joystick] = set()
+    controllers: set[tcod.sdl.joystick.GameController] = set()
+    joysticks: set[tcod.sdl.joystick.Joystick] = set()
 
     with tcod.context.new(width=WIDTH, height=HEIGHT) as context:
         console = context.new_console()

examples/framerate.py

@@ -8,7 +8,6 @@
 import statistics
 import time
 from collections import deque
-from typing import Deque, Optional
 
 import tcod
 
@@ -25,11 +24,11 @@ class Clock:
     def __init__(self) -> None:
         """Initialize this object with empty data."""
         self.last_time = time.perf_counter()  # Last time this was synced.
-        self.time_samples: Deque[float] = deque()  # Delta time samples.
+        self.time_samples: deque[float] = deque()  # Delta time samples.
         self.max_samples = 64  # Number of fps samples to log.  Can be changed.
         self.drift_time = 0.0  # Tracks how much the last frame was overshot.
 
-    def sync(self, fps: Optional[float] = None) -> float:
+    def sync(self, fps: float | None = None) -> float:
         """Sync to a given framerate and return the delta time.
 
         `fps` is the desired framerate in frames-per-second.  If None is given

examples/samples_tcod.py

@@ -1209,7 +1209,7 @@ def on_draw(self) -> None:
             # new pixels are based on absolute elapsed time
             int_abs_t = int(self.abs_t)
 
-            texture = np.roll(texture, -int_t, 1)
+            texture = np.roll(texture, -int_t, 1)  # type: ignore[assignment]
             # replace new stretch of texture with new values
             for v in range(RES_V - int_t, RES_V):
                 for u in range(RES_U):

examples/thread_jobs.py

@@ -19,7 +19,7 @@
 import platform
 import sys
 import timeit
-from typing import Callable, List, Tuple
+from collections.abc import Callable
 
 import tcod.map
 
@@ -37,35 +37,35 @@ def test_fov(map_: tcod.map.Map) -> tcod.map.Map:
     return map_
 
 
-def test_fov_single(maps: List[tcod.map.Map]) -> None:
+def test_fov_single(maps: list[tcod.map.Map]) -> None:
     for map_ in maps:
         test_fov(map_)
 
 
-def test_fov_threads(executor: concurrent.futures.Executor, maps: List[tcod.map.Map]) -> None:
+def test_fov_threads(executor: concurrent.futures.Executor, maps: list[tcod.map.Map]) -> None:
     for _result in executor.map(test_fov, maps):
         pass
 
 
-def test_astar(map_: tcod.map.Map) -> List[Tuple[int, int]]:
+def test_astar(map_: tcod.map.Map) -> list[tuple[int, int]]:
     astar = tcod.path.AStar(map_)
     return astar.get_path(0, 0, MAP_WIDTH - 1, MAP_HEIGHT - 1)
 
 
-def test_astar_single(maps: List[tcod.map.Map]) -> None:
+def test_astar_single(maps: list[tcod.map.Map]) -> None:
     for map_ in maps:
         test_astar(map_)
 
 
-def test_astar_threads(executor: concurrent.futures.Executor, maps: List[tcod.map.Map]) -> None:
+def test_astar_threads(executor: concurrent.futures.Executor, maps: list[tcod.map.Map]) -> None:
     for _result in executor.map(test_astar, maps):
         pass
 
 
 def run_test(
-    maps: List[tcod.map.Map],
-    single_func: Callable[[List[tcod.map.Map]], None],
-    multi_func: Callable[[concurrent.futures.Executor, List[tcod.map.Map]], None],
+    maps: list[tcod.map.Map],
+    single_func: Callable[[list[tcod.map.Map]], None],
+    multi_func: Callable[[concurrent.futures.Executor, list[tcod.map.Map]], None],
 ) -> None:
     """Run a function designed for a single thread and compare it to a threaded version.
 

examples/ttf.py

@@ -9,7 +9,7 @@
 # To the extent possible under law, the libtcod maintainers have waived all
 # copyright and related or neighboring rights to this example script.
 # https://creativecommons.org/publicdomain/zero/1.0/
-from typing import TYPE_CHECKING, Tuple
+from typing import TYPE_CHECKING
 
 import freetype  # type: ignore  # pip install freetype-py
 import numpy as np
@@ -25,7 +25,7 @@
 FONT = "VeraMono.ttf"
 
 
-def load_ttf(path: str, size: Tuple[int, int]) -> tcod.tileset.Tileset:
+def load_ttf(path: str, size: tuple[int, int]) -> tcod.tileset.Tileset:
     """Load a TTF file and return a tcod Tileset.
 
     `path` is the file path to the font, this can be any font supported by the