Deprecate EventDispatch class

This class has faded into irrelevance due to modern Python language features.
I need to discourage its usage in new programs.

Author: HexDecimal

CHANGELOG.md

@@ -19,6 +19,9 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 - `Console.print_box` has been replaced by `Console.print`.
 - `Console.draw_frame`: deprecated `clear`, `fg`, `bg`, and `bg_blend` being given as positional arguments.
 - `Console.draw_rect`: deprecated `fg`, `bg`, and `bg_blend` being given as positional arguments.
+- The `EventDispatch` class is now deprecated.
+  This class was made before Python supported protocols and structural pattern matching,
+  now the class serves little purpose and its usage can create a minor technical burden.
 
 ## [17.1.0] - 2025-03-29
 

tcod/event.py

@@ -87,7 +87,7 @@
 from typing import TYPE_CHECKING, Any, Callable, Final, Generic, Iterator, Mapping, NamedTuple, TypeVar
 
 import numpy as np
-from typing_extensions import Literal
+from typing_extensions import Literal, deprecated
 
 import tcod.event
 import tcod.event_constants
@@ -1238,6 +1238,10 @@ def wait(timeout: float | None = None) -> Iterator[Any]:
     return get()
 
 
+@deprecated(
+    "Event dispatch should be handled via a single custom method in a Protocol instead of this class.",
+    category=DeprecationWarning,
+)
 class EventDispatch(Generic[T]):
     '''Dispatches events to methods depending on the events type attribute.
 
@@ -1248,6 +1252,10 @@ class EventDispatch(Generic[T]):
         This is now a generic class.
         The type hints at the return value of :any:`dispatch` and the `ev_*` methods.
 
+    .. deprecated:: Unreleased
+        Event dispatch should be handled via a single custom method in a Protocol instead of this class.
+        Note that events can and should be handled using Python's `match` statement.
+
     Example::
 
         import tcod