Drop support for Python 3.10 and 3.11

HexDecimal · HexDecimal · commit 8fda0303d62e · 2026-06-22T08:56:06.000-07:00
Apply Ruff and Mypy lint fixes

Necessary to keep up with typing changes in Numpy

Not strictly required, but Python 3.10 is reaching EOL anyways
diff --git a/.github/workflows/python-package.yml b/.github/workflows/python-package.yml
@@ -109,17 +109,17 @@ jobs:
     strategy:
       matrix:
         os: ["ubuntu-latest", "windows-latest"]
-        python-version: ["3.10", "3.14t", "pypy-3.10"]
+        python-version: ["3.12", "3.14t", "pypy-3.12"]
         architecture: ["x64"]
         include:
           - os: "windows-latest"
-            python-version: "3.10"
+            python-version: "3.12"
             architecture: "x86"
           - os: "windows-latest"
             python-version: "3.14t"
             architecture: "x86"
           - os: "windows-11-arm"
-            python-version: "3.11"
+            python-version: "3.12"
             architecture: "arm64"
           - os: "windows-11-arm"
             python-version: "3.14t"
@@ -243,7 +243,7 @@ jobs:
     strategy:
       matrix:
         arch: ["x86_64", "aarch64"]
-        build: ["cp310-manylinux*", "pp311-manylinux*", "cp314t-manylinux*"]
+        build: ["cp312-manylinux*", "pp312-manylinux*", "cp314t-manylinux*"]
     env:
       BUILD_DESC: ""
     steps:
@@ -301,7 +301,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python: ["cp310-*_universal2", "cp314t-*_universal2", "pp311-*"]
+        python: ["cp312-*_universal2", "cp314t-*_universal2", "pp312-*"]
     env:
       PYTHON_DESC: ""
     steps:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,10 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 
 ## [Unreleased]
 
+### Removed
+
+- Support dropped for Python 3.10 and 3.11.
+
 ## [21.2.1] - 2026-06-04
 
 ### Deployment
diff --git a/README.rst b/README.rst
@@ -46,7 +46,7 @@ For the most part it's just::
 ==============
  Requirements
 ==============
-* Python 3.10+
+* Python 3.12+
 * Windows, Linux, or MacOS X 10.9+.
 * On Linux, requires libsdl3
 
diff --git a/build_libtcod.py b/build_libtcod.py
@@ -29,7 +29,7 @@
 if TYPE_CHECKING:
     from collections.abc import Iterable, Iterator
 
-Py_LIMITED_API: None | int = 0x03100000
+Py_LIMITED_API: None | int = 0x03120000
 
 HEADER_PARSE_PATHS = ("tcod/", "libtcod/src/libtcod/")
 HEADER_PARSE_EXCLUDES = ("gl2_ext_.h", "renderer_gl_internal.h", "event.h")
@@ -228,7 +228,7 @@ def walk_sources(directory: str) -> Iterator[str]:
 for include in includes:
     try:
         ffi.cdef(include.header)
-    except Exception:  # noqa: PERF203
+    except Exception:
         # Print the source, for debugging.
         print(f"Error with: {include.path}")
         for i, line in enumerate(include.header.split("\n"), 1):
diff --git a/build_sdl.py b/build_sdl.py
@@ -157,8 +157,7 @@ def check_sdl_version() -> None:
             )
             raise RuntimeError(msg) from exc
     except subprocess.CalledProcessError as exc:
-        if sys.version_info >= (3, 11):
-            exc.add_note(f"Note: {os.environ.get('PKG_CONFIG_PATH')=}")
+        exc.add_note(f"Note: {os.environ.get('PKG_CONFIG_PATH')=}")
         raise
     logger.info(f"Found SDL {sdl_version_str}.")
     sdl_version = tuple(int(s) for s in sdl_version_str.split("."))
diff --git a/docs/tcod/event.rst b/docs/tcod/event.rst
@@ -15,7 +15,7 @@ Getting events
 The primary way to capture events is with the :any:`tcod.event.get` and :any:`tcod.event.wait` functions.
 These functions return events in a loop until the internal event queue is empty.
 Use :func:`isinstance`, :any:`tcod.event.EventDispatch`, or `match statements <https://docs.python.org/3/tutorial/controlflow.html#match-statements>`_
-(introduced in Python 3.10) to determine which event was returned.
+to determine which event was returned.
 
 .. autofunction:: tcod.event.get
 .. autofunction:: tcod.event.wait
diff --git a/pyproject.toml b/pyproject.toml
@@ -20,7 +20,7 @@ dynamic = ["version"]
 description = "The official Python port of libtcod."
 authors = [{ name = "Kyle Benesch", email = "4b796c65+tcod@gmail.com" }]
 readme = "README.rst"
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 license = "BSD-2-Clause"
 license-files = [
     "LICENSE.txt",
@@ -106,7 +106,7 @@ enable = ["pypy", "pyodide-prerelease"]
 
 [tool.mypy]
 files = ["."]
-python_version = "3.10"
+python_version = "3.12"
 warn_unused_configs = true
 show_error_codes = true
 disallow_subclassing_any = true
diff --git a/scripts/tag_release.py b/scripts/tag_release.py
@@ -36,7 +36,7 @@ def parse_changelog(args: argparse.Namespace) -> tuple[str, str]:
     assert match
     header, changes, tail = match.groups()
 
-    iso_date = datetime.datetime.now(tz=datetime.timezone.utc).date().isoformat()
+    iso_date = datetime.datetime.now(tz=datetime.UTC).date().isoformat()
     tagged = f"\n## [{args.tag}] - {iso_date}\n{changes}"
     if args.verbose:
         print("--- Tagged section:")
diff --git a/setup.py b/setup.py
@@ -42,7 +42,7 @@ def get_package_data() -> list[str]:
 
 options = {
     "bdist_wheel": {
-        "py_limited_api": "cp310",
+        "py_limited_api": "cp312",
     }
 }
 if "free-threading build" in sys.version:
diff --git a/tcod/_internal.py b/tcod/_internal.py
@@ -61,7 +61,7 @@ def _check(error: int) -> int:
     return error
 
 
-def _check_p(pointer: T) -> T:
+def _check_p[T](pointer: T) -> T:
     """Treats NULL pointers as errors and raises a libtcod exception."""
     if not pointer:
         _raise_tcod_error()
@@ -94,13 +94,13 @@ def _int(int_or_str: SupportsInt | str | bytes) -> int:
     return int(int_or_str)
 
 
-def _bytes(string: AnyStr) -> bytes:
+def _bytes(string: AnyStr) -> bytes:  # noqa: UP047
     if isinstance(string, str):
         return string.encode("utf-8")
     return string
 
 
-def _unicode(string: AnyStr, stacklevel: int = 2) -> str:
+def _unicode(string: AnyStr, stacklevel: int = 2) -> str:  # noqa: UP047
     if isinstance(string, bytes):
         warnings.warn(
             "Passing byte strings as parameters to Unicode functions is deprecated.",
@@ -129,8 +129,7 @@ def _path_encode(path: Path) -> bytes:
     try:
         return str(path).encode(locale.getlocale()[1] or "utf-8")  # Stay classy, Windows
     except UnicodeEncodeError as exc:
-        if sys.version_info >= (3, 11):
-            exc.add_note("""Consider calling 'locale.setlocale(locale.LC_CTYPES, ".UTF8")' to support Unicode paths.""")
+        exc.add_note("""Consider calling 'locale.setlocale(locale.LC_CTYPES, ".UTF8")' to support Unicode paths.""")
         raise
 
 
diff --git a/tcod/console.py b/tcod/console.py
@@ -9,10 +9,10 @@
 
 import warnings
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Literal, overload
+from typing import TYPE_CHECKING, Any, Literal, Self, overload
 
 import numpy as np
-from typing_extensions import Self, deprecated
+from typing_extensions import deprecated
 
 import tcod._internal
 import tcod.constants
diff --git a/tcod/context.py b/tcod/context.py
@@ -31,9 +31,9 @@
 import warnings
 from math import floor
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Literal, NoReturn, TypeVar
+from typing import TYPE_CHECKING, Any, Literal, NoReturn, Self, TypeVar
 
-from typing_extensions import Self, deprecated
+from typing_extensions import deprecated
 
 import tcod.console
 import tcod.event
diff --git a/tcod/event.py b/tcod/event.py
@@ -41,8 +41,8 @@
             elif isinstance(event, tcod.event.MouseMotion):
                 print(f"{event.integer_position=}, {event.integer_motion=}")  # Current mouse tile and tile motion
 
-Python 3.10 introduced `match statements <https://docs.python.org/3/tutorial/controlflow.html#match-statements>`_
-which can be used to dispatch events more gracefully:
+`Match statements <https://docs.python.org/3/tutorial/controlflow.html#match-statements>`_
+can be used to dispatch events more gracefully:
 
 Example::
 
@@ -93,11 +93,10 @@
     TYPE_CHECKING,
     Any,
     Final,
-    Generic,
     Literal,
     NamedTuple,
     Protocol,
-    TypeAlias,
+    Self,
     TypedDict,
     TypeVar,
     overload,
@@ -106,7 +105,7 @@
 
 import attrs
 import numpy as np
-from typing_extensions import Self, deprecated
+from typing_extensions import deprecated
 
 import tcod.context
 import tcod.event_constants
@@ -123,7 +122,7 @@
 T = TypeVar("T")
 _EventType = TypeVar("_EventType", bound="Event")
 
-_C_SDL_Event: TypeAlias = Any
+type _C_SDL_Event = Any
 """A CFFI pointer to an SDL_Event union.
 
 See SDL docs: https://wiki.libsdl.org/SDL3/SDL_Event
@@ -173,27 +172,20 @@ def _pixel_to_tile(xy: tuple[float, float], /) -> Point[float] | None:
     return Point(float(xy_out[0]), float(xy_out[1]))
 
 
-if sys.version_info >= (3, 11) or TYPE_CHECKING:
+class Point[T](NamedTuple):
+    """A 2D position used for events with mouse coordinates.
 
-    class Point(NamedTuple, Generic[T]):
-        """A 2D position used for events with mouse coordinates.
-
-        .. seealso::
-            :any:`MouseMotion` :any:`MouseButtonDown` :any:`MouseButtonUp`
-
-        .. versionchanged:: 19.0
-            Now uses floating point coordinates due to the port to SDL3.
-        """
+    .. seealso::
+        :any:`MouseMotion` :any:`MouseButtonDown` :any:`MouseButtonUp`
 
-        x: T
-        """A pixel or tile coordinate starting with zero as the left-most position."""
-        y: T
-        """A pixel or tile coordinate starting with zero as the top-most position."""
-else:
+    .. versionchanged:: 19.0
+        Now uses floating point coordinates due to the port to SDL3.
+    """
 
-    class Point(NamedTuple):  # noqa: D101
-        x: Any
-        y: Any
+    x: T
+    """A pixel or tile coordinate starting with zero as the left-most position."""
+    y: T
+    """A pixel or tile coordinate starting with zero as the top-most position."""
 
 
 def _verify_tile_coordinates(xy: Point[int] | None) -> Point[int]:
@@ -1429,7 +1421,7 @@ def wait(timeout: float | None = None) -> Iterator[Event]:
 Event dispatching should be handled via a single custom method in a Protocol instead of this class.""",
     category=DeprecationWarning,
 )
-class EventDispatch(Generic[T]):
+class EventDispatch[T]:
     '''Dispatches events to methods depending on the events type attribute.
 
     To use this class, make a sub-class and override the relevant `ev_*` methods.
@@ -1741,7 +1733,7 @@ def get_mouse_state() -> MouseState:
 
 
 @overload
-def convert_coordinates_from_window(
+def convert_coordinates_from_window(  # noqa: UP047
     event: _EventType,
     /,
     context: tcod.context.Context | tcod.sdl.render.Renderer,
@@ -1756,7 +1748,7 @@ def convert_coordinates_from_window(
     console: tcod.console.Console | tuple[int, int],
     dest_rect: tuple[int, int, int, int] | None = None,
 ) -> tuple[float, float]: ...
-def convert_coordinates_from_window(
+def convert_coordinates_from_window(  # noqa: UP047
     event: _EventType | tuple[float, float],
     /,
     context: tcod.context.Context | tcod.sdl.render.Renderer,
@@ -1819,11 +1811,10 @@ def _sdl_event_watcher(userdata: Any, sdl_event: _C_SDL_Event) -> int:  # noqa:
     return 0
 
 
-_EventCallback = TypeVar("_EventCallback", bound=Callable[[Event], None])
 _event_watch_handles: dict[Callable[[Event], None], Any] = {}  # Callbacks and their FFI handles.
 
 
-def add_watch(callback: _EventCallback) -> _EventCallback:
+def add_watch[EventCallback: Callable[[Event], None]](callback: EventCallback) -> EventCallback:
     """Add a callback for watching events.
 
     This function can be called with the callback to register, or be used as a decorator.
@@ -3127,7 +3118,7 @@ def __getattr__(name: str) -> int:
             FutureWarning,
             stacklevel=2,
         )
-        return replacement
+        return replacement  # type: ignore[return-value]
 
     if name.startswith("K_") and len(name) == 3:  # noqa: PLR2004
         name = name.upper()  # Silently fix single letter key symbols removed from SDL3, these are still deprecated
diff --git a/tcod/path.py b/tcod/path.py
@@ -21,10 +21,9 @@
 import functools
 import itertools
 import warnings
-from typing import TYPE_CHECKING, Any, Final, Literal
+from typing import TYPE_CHECKING, Any, Final, Literal, Self
 
 import numpy as np
-from typing_extensions import Self
 
 import tcod.map
 from tcod._internal import _check
@@ -775,7 +774,7 @@ def add_edge(
             cost = cost.T
             if condition is not None:
                 condition = condition.T
-        key = (_as_hashable(cost), _as_hashable(condition))  # type: ignore[arg-type]
+        key = (_as_hashable(cost), _as_hashable(condition))
         try:
             rule = self._graph[key]
         except KeyError:
@@ -897,16 +896,16 @@ def add_edges(
             # edge_map needs to be converted into C.
             # The other parameters are converted by the add_edge method.
             edge_map = edge_map.T
-        edge_center = tuple(i // 2 for i in edge_map.shape)  # type: ignore[union-attr]
-        edge_map[edge_center] = 0  # type: ignore[index]
-        edge_map[edge_map < 0] = 0  # type: ignore[index, operator]
-        edge_nz = edge_map.nonzero()  # type: ignore[union-attr]
-        edge_costs = edge_map[edge_nz]  # type: ignore[index]
+        edge_center = tuple(i // 2 for i in edge_map.shape)
+        edge_map[edge_center] = 0
+        edge_map[edge_map < 0] = 0
+        edge_nz = edge_map.nonzero()
+        edge_costs = edge_map[edge_nz]
         edge_array = np.transpose(edge_nz)
         edge_array -= edge_center
         for edge, edge_cost in zip(
             edge_array,
-            edge_costs,  # type: ignore[arg-type]
+            edge_costs,
             strict=True,
         ):
             self.add_edge(
@@ -1177,7 +1176,7 @@ def traversal(self) -> NDArray[Any]:
         """
         if self._order == "F":
             axes = range(self._travel.ndim)
-            return self._travel.transpose((*axes[-2::-1], axes[-1]))[..., ::-1]  # type: ignore[no-any-return]
+            return self._travel.transpose((*axes[-2::-1], axes[-1]))[..., ::-1]
         return self._travel
 
     def clear(self) -> None:
diff --git a/tcod/sdl/_internal.py b/tcod/sdl/_internal.py
@@ -5,9 +5,7 @@
 import logging
 import sys
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, NoReturn, Protocol, TypeVar, overload, runtime_checkable
-
-from typing_extensions import Self
+from typing import TYPE_CHECKING, Any, NoReturn, Protocol, Self, TypeVar, overload, runtime_checkable
 
 from tcod.cffi import ffi, lib
 
diff --git a/tcod/sdl/audio.py b/tcod/sdl/audio.py
diff --git a/tcod/sdl/sys.py b/tcod/sdl/sys.py
diff --git a/tcod/sdl/video.py b/tcod/sdl/video.py
diff --git a/tcod/tileset.py b/tcod/tileset.py

Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,7 @@ def get_package_data() -> list[str]:`
`42`	`42`
`43`	`43`	`options = {`
`44`	`44`	`"bdist_wheel": {`
`45`		`- "py_limited_api": "cp310",`
	`45`	`+ "py_limited_api": "cp312",`
`46`	`46`	`}`
`47`	`47`	`}`
`48`	`48`	`if "free-threading build" in sys.version:`