mini-arcade-core 0.9.3__tar.gz → 0.9.4__tar.gz

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-arcade-core
-Version: 0.9.3
+Version: 0.9.4
 Summary: Tiny scene-based game loop core for small arcade games.
 License: Copyright (c) 2025 Santiago Rincón
            

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "mini-arcade-core"
-version = "0.9.3"
+version = "0.9.4"
 description = "Tiny scene-based game loop core for small arcade games."
 authors = [
     { name = "Santiago Rincon", email = "rincores@gmail.com" },

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.4}/src/mini_arcade_core/__init__.py

@@ -8,6 +8,7 @@ from __future__ import annotations
 import logging
 from importlib.metadata import PackageNotFoundError, version
 
+from .autoreg import register_scene
 from .backend import Backend, Event, EventType
 from .boundaries2d import (
     RectKinematic,
@@ -78,6 +79,7 @@ __all__ = [
     "Key",
     "keymap",
     "SceneRegistry",
+    "register_scene",
 ]
 
 PACKAGE_NAME = "mini-arcade-core"  # or whatever is in your pyproject.toml

mini_arcade_core-0.9.4/src/mini_arcade_core/autoreg.py

@@ -0,0 +1,39 @@
+"""
+Autoregistration utilities for mini arcade core.
+Allows automatic registration of Scene classes via decorators.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Dict, Type
+
+if TYPE_CHECKING:
+    from .scene import Scene
+
+_AUTO: Dict[str, Type["Scene"]] = {}
+
+
+def register_scene(scene_id: str):
+    """Decorator to mark and register a Scene class under an id."""
+
+    def deco(cls: Type["Scene"]):
+        _AUTO[scene_id] = cls
+        setattr(cls, "__scene_id__", scene_id)
+        return cls
+
+    return deco
+
+
+def snapshot() -> Dict[str, Type["Scene"]]:
+    """
+    Copy of current catalog (useful for tests).
+
+    :return: A copy of the current scene catalog.
+    :rtype: Dict[str, Type["Scene"]]
+    """
+    return dict(_AUTO)
+
+
+def clear():
+    """Clear the current catalog (useful for tests)."""
+    _AUTO.clear()

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.4}/src/mini_arcade_core/registry.py

@@ -5,9 +5,13 @@ Allows registering and creating scenes by string IDs.
 
 from __future__ import annotations
 
+import importlib
+import pkgutil
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Dict, Protocol
 
+from .autoreg import snapshot
+
 if TYPE_CHECKING:
     from mini_arcade_core.game import Game
     from mini_arcade_core.scene import Scene
@@ -29,7 +33,7 @@ class SceneRegistry:
 
     _factories: Dict[str, SceneFactory]
 
-    def register(self, scene_id: str, factory: SceneFactory) -> None:
+    def register(self, scene_id: str, factory: SceneFactory):
         """
         Register a scene factory under a given scene ID.
 
@@ -41,6 +45,22 @@ class SceneRegistry:
         """
         self._factories[scene_id] = factory
 
+    def register_cls(self, scene_id: str, scene_cls: type["Scene"]):
+        """
+        Register a Scene class under a given scene ID.
+
+        :param scene_id: The string ID for the scene.
+        :type scene_id: str
+
+        :param scene_cls: The Scene class to register.
+        :type scene_cls: type["Scene"]
+        """
+
+        def return_factory(game: "Game") -> "Scene":
+            return scene_cls(game)
+
+        self.register(scene_id, return_factory)
+
     def create(self, scene_id: str, game: "Game") -> "Scene":
         """
         Create a scene instance using the registered factory for the given scene ID.
@@ -60,3 +80,33 @@ class SceneRegistry:
             return self._factories[scene_id](game)
         except KeyError as e:
             raise KeyError(f"Unknown scene_id={scene_id!r}") from e
+
+    def load_catalog(self, catalog: Dict[str, type["Scene"]]):
+        """
+        Load a catalog of Scene classes into the registry.
+
+        :param catalog: A dictionary mapping scene IDs to Scene classes.
+        :type catalog: Dict[str, type["Scene"]]
+        """
+        for scene_id, cls in catalog.items():
+            self.register_cls(scene_id, cls)
+
+    def discover(self, package: str) -> "SceneRegistry":
+        """
+        Import all modules in a package so @scene decorators run.
+
+        :param package: The package name to scan for scene modules.
+        :type package: str
+
+        :return: The SceneRegistry instance (for chaining).
+        :rtype: SceneRegistry
+        """
+        pkg = importlib.import_module(package)
+        if not hasattr(pkg, "__path__"):
+            return self  # not a package
+
+        for mod in pkgutil.walk_packages(pkg.__path__, pkg.__name__ + "."):
+            importlib.import_module(mod.name)
+
+        self.load_catalog(snapshot())
+        return self

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.4}/src/mini_arcade_core/ui/menu.py

@@ -253,9 +253,7 @@ class Menu:
                 color=self.style.hint_color,
             )
 
-    def _draw_text_items(
-        self, surface: Backend, x_center: int, cursor_y: int
-    ) -> None:
+    def _draw_text_items(self, surface: Backend, x_center: int, cursor_y: int):
         for i, item in enumerate(self.items):
             color = (
                 self.style.selected
@@ -272,9 +270,7 @@ class Menu:
 
     # Justification: Local variables for layout calculations
     # pylint: disable=too-many-locals
-    def _draw_buttons(
-        self, surface: Backend, x_center: int, cursor_y: int
-    ) -> None:
+    def _draw_buttons(self, surface: Backend, x_center: int, cursor_y: int):
         # Determine button width: fixed or auto-fit
         if self.style.button_width is not None:
             bw = self.style.button_width
@@ -366,6 +362,6 @@ class Menu:
         text: str,
         *,
         color: Color,
-    ) -> None:
+    ):
         w, _ = surface.measure_text(text)
         surface.draw_text(x_center - (w // 2), y, text, color=color)