Deprecate older keyboard constants.

Add warnings telling which enum replaces any key.

Test deprecated keys and colors.

Author: HexDecimal

CHANGELOG.md

@@ -5,7 +5,9 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 
 ## [Unreleased]
 ### Deprecated
-- Deprecated all color constants
+- Deprecated all libtcod color constants.  Replace these with your own manually defined colors.
+  Using a color will tell you the color values of the deprecated color in the warning.
+- Deprecated older scancode and keysym constants.  These were replaced with the Scancode and KeySym enums.
 
 ### Fixed
 - DLL loader could fail to load `SDL2.dll` when other tcod namespace packages were installed.

build_libtcod.py

@@ -256,9 +256,8 @@ def find_sdl_attrs(prefix: str) -> Iterator[Tuple[str, Union[int, str, Any]]]:
             yield attr[name_starts_at:], getattr(lib, attr)
 
 
-def parse_sdl_attrs(prefix: str, all_names: List[str]) -> Tuple[str, str]:
-    """Return the name/value pairs, and the final dictionary string for the
-    library attributes with `prefix`.
+def parse_sdl_attrs(prefix: str, all_names: list[str] | None) -> tuple[str, str]:
+    """Return the name/value pairs, and the final dictionary string for the library attributes with `prefix`.
 
     Append matching names to the `all_names` list.
     """
@@ -267,10 +266,11 @@ def parse_sdl_attrs(prefix: str, all_names: List[str]) -> Tuple[str, str]:
     for name, value in sorted(find_sdl_attrs(prefix), key=lambda item: item[1]):
         if name == "KMOD_RESERVED":
             continue
-        all_names.append(name)
+        if all_names is not None:
+            all_names.append(name)
         names.append(f"{name} = {value}")
         lookup.append(f'{value}: "{name}"')
-    return "\n".join(names), "{\n    %s,\n}" % (",\n    ".join(lookup),)
+    return "\n".join(names), "{{\n    {},\n}}".format(",\n    ".join(lookup))
 
 
 EXCLUDE_CONSTANTS = [
@@ -370,10 +370,10 @@ def write_library_constants() -> None:
         all_names = []
         f.write(EVENT_CONSTANT_MODULE_HEADER)
         f.write("\n# --- SDL scancodes ---\n")
-        f.write(f"""{parse_sdl_attrs("SDL_SCANCODE", all_names)[0]}\n""")
+        f.write(f"""{parse_sdl_attrs("SDL_SCANCODE", None)[0]}\n""")
 
         f.write("\n# --- SDL keyboard symbols ---\n")
-        f.write(f"""{parse_sdl_attrs("SDLK", all_names)[0]}\n""")
+        f.write(f"""{parse_sdl_attrs("SDLK", None)[0]}\n""")
 
         f.write("\n# --- SDL keyboard modifiers ---\n")
         f.write("%s\n_REVERSE_MOD_TABLE = %s\n" % parse_sdl_attrs("KMOD", all_names))