Input Enums instead of strings.

src/PyKey.h

@@ -0,0 +1,44 @@
+#pragma once
+#include "Common.h"
+#include "Python.h"
+#include <SFML/Window/Keyboard.hpp>
+
+// Module-level Key enum class (created at runtime using Python's IntEnum)
+// Stored as a module attribute: mcrfpy.Key
+//
+// Values map to sf::Keyboard::Key enum values.
+// The enum compares equal to both its name ("ESCAPE") and legacy string ("Escape")
+//
+// Naming convention:
+//   - Letters: A, B, C, ... Z
+//   - Numbers: NUM_0, NUM_1, ... NUM_9 (top row)
+//   - Numpad: NUMPAD_0, NUMPAD_1, ... NUMPAD_9
+//   - Function keys: F1, F2, ... F15
+//   - Modifiers: LEFT_SHIFT, RIGHT_SHIFT, LEFT_CONTROL, RIGHT_CONTROL, etc.
+//   - Navigation: LEFT, RIGHT, UP, DOWN, HOME, END, PAGE_UP, PAGE_DOWN
+//   - Special: ESCAPE, ENTER, SPACE, TAB, BACKSPACE, DELETE, INSERT, PAUSE
+
+class PyKey {
+public:
+    // Create the Key enum class and add to module
+    // Returns the enum class (new reference), or NULL on error
+    static PyObject* create_enum_class(PyObject* module);
+
+    // Helper to extract key from Python arg
+    // Accepts Key enum, string (for backwards compatibility), int, or None
+    // Returns 1 on success, 0 on error (with exception set)
+    static int from_arg(PyObject* arg, sf::Keyboard::Key* out_key);
+
+    // Convert sf::Keyboard::Key to legacy string name (for passing to callbacks)
+    static const char* to_legacy_string(sf::Keyboard::Key key);
+
+    // Convert legacy string to sf::Keyboard::Key
+    // Returns sf::Keyboard::Unknown if not found
+    static sf::Keyboard::Key from_legacy_string(const char* name);
+
+    // Cached reference to the Key enum class for fast type checking
+    static PyObject* key_enum_class;
+
+    // Number of keys (matches sf::Keyboard::KeyCount)
+    static const int NUM_KEYS = sf::Keyboard::KeyCount;
+};