mini-arcade-core 0.3.2__py3-none-any.whl → 0.5.2__py3-none-any.whl

mini_arcade_core/__init__.py

@@ -5,11 +5,16 @@ Provides access to core classes and a convenience function to run a game.
 
 from __future__ import annotations
 
+import logging
+from importlib.metadata import PackageNotFoundError, version
+
 from .backend import Backend, Event, EventType
 from .entity import Entity, SpriteEntity
 from .game import Game, GameConfig
 from .scene import Scene
 
+logger = logging.getLogger(__name__)
+
 
 def run_game(initial_scene_cls: type[Scene], config: GameConfig | None = None):
     """
@@ -34,3 +39,38 @@ __all__ = [
     "Event",
     "EventType",
 ]
+
+PACKAGE_NAME = "mini-arcade-core"  # or whatever is in your pyproject.toml
+
+
+def get_version() -> str:
+    """
+    Return the installed package version.
+
+    This is a thin helper around importlib.metadata.version so games can do:
+
+        from mini_arcade_core import get_version
+        print(get_version())
+
+    :return: The version string of the installed package.
+    :rtype: str
+
+    :raises PackageNotFoundError: If the package is not installed.
+    """
+    try:
+        return version(PACKAGE_NAME)
+    except PackageNotFoundError:  # if running from source / editable
+        logger.warning(
+            f"Package '{PACKAGE_NAME}' not found. Returning default version '0.0.0'."
+        )
+        return "0.0.0"
+
+
+try:
+    __version__ = get_version()
+# Justification: We want to ensure that any exception during version retrieval
+# results in a default version being set, rather than crashing the import.
+# pylint: disable=broad-exception-caught
+except Exception:
+    __version__ = "0.0.0"
+# pylint: enable=broad-exception-caught

mini_arcade_core/game.py

@@ -7,6 +7,8 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
+from .backend import Backend
+
 if TYPE_CHECKING:  # avoid runtime circular import
     from .scene import Scene
 
@@ -21,6 +23,7 @@ class GameConfig:
     :ivar title: Title of the game window.
     :ivar fps: Target frames per second.
     :ivar background_color: RGB background color.
+    :ivar backend: Optional backend class to use for rendering and input.
     """
 
     width: int = 800
@@ -28,6 +31,7 @@ class GameConfig:
     title: str = "Mini Arcade Game"
     fps: int = 60
     background_color: tuple[int, int, int] = (0, 0, 0)
+    backend: type[Backend] | None = None
 
 
 class Game:
@@ -40,6 +44,7 @@ class Game:
         self.config = config
         self._current_scene: Scene | None = None
         self._running: bool = False
+        self.backend: Backend | None = config.backend
 
     def change_scene(self, scene: Scene):
         """
@@ -52,6 +57,10 @@ class Game:
             "Game.change_scene must be implemented by a concrete backend."
         )
 
+    def quit(self):
+        """Request that the main loop stops."""
+        self._running = False
+
     def run(self, initial_scene: Scene):
         """
         Run the main loop starting with the given scene.

{mini_arcade_core-0.3.2.dist-info → mini_arcade_core-0.5.2.dist-info}/METADATA

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

mini_arcade_core-0.5.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+mini_arcade_core/__init__.py,sha256=xlePCq6tvPfIgHlhQ-WtESvEyX2sjkgu_aann-1QsZk,2041
+mini_arcade_core/backend.py,sha256=6_3-ni0EQJXfaSReavcrOeUOCNkdrjGctFn5q0D9nrw,1847
+mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
+mini_arcade_core/game.py,sha256=OkQIFkFLqFailZDPY1fAq6Tyi7IQ9EKxloW1UgDaHko,2123
+mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
+mini_arcade_core-0.5.2.dist-info/METADATA,sha256=5ogfRfSrJtRHRqnSAGo2ZSNQWDMal3USAFZ3rCeJGtY,8296
+mini_arcade_core-0.5.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.5.2.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.5.2.dist-info/RECORD,,

mini_arcade_core-0.3.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-mini_arcade_core/__init__.py,sha256=c66IkzZjiyUbTtjQRyf4XyiH6xPS79Ajxeb1OvnVPZA,887
-mini_arcade_core/backend.py,sha256=6_3-ni0EQJXfaSReavcrOeUOCNkdrjGctFn5q0D9nrw,1847
-mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
-mini_arcade_core/game.py,sha256=j9savb7y3NPgQsiX3xeRTrEadP7xzIpfsekE74s8AAY,1825
-mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
-mini_arcade_core-0.3.2.dist-info/METADATA,sha256=Zl_Dq8BvNSj8kenLvLDiixNZkTt1gwTBXvQIZuh3adc,8296
-mini_arcade_core-0.3.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.3.2.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.3.2.dist-info/RECORD,,