mini-arcade-core 0.6.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

mini_arcade_core/backend.py

@@ -57,6 +57,11 @@ class Backend(Protocol):
         Concrete backends will translate their native events into core Event objects.
         """
 
+    def set_clear_color(self, r: int, g: int, b: int) -> None:
+        """
+        Set the background/clear color used by begin_frame.
+        """
+
     def begin_frame(self) -> None:
         """
         Prepare for drawing a new frame (e.g. clear screen).
@@ -67,9 +72,34 @@ class Backend(Protocol):
         Present the frame to the user (swap buffers).
         """
 
-    def draw_rect(self, x: int, y: int, w: int, h: int) -> None:
+    # Justification: Simple drawing API for now
+    # pylint: disable=too-many-arguments,too-many-positional-arguments
+    def draw_rect(
+        self,
+        x: int,
+        y: int,
+        w: int,
+        h: int,
+        color: tuple[int, int, int] = (255, 255, 255),
+    ) -> None:
         """
         Draw a filled rectangle in some default color.
 
         We'll keep this minimal for now; later we can extend with colors/sprites.
         """
+
+    # pylint: enable=too-many-arguments,too-many-positional-arguments
+
+    def draw_text(
+        self,
+        x: int,
+        y: int,
+        text: str,
+        color: tuple[int, int, int] = (255, 255, 255),
+    ) -> None:
+        """
+        Draw text at the given position in a default font and color.
+
+        Backends may ignore advanced styling for now; this is just to render
+        simple labels like menu items, scores, etc.
+        """

mini_arcade_core/game.py

@@ -5,6 +5,7 @@ Game core module defining the Game class and configuration.
 from __future__ import annotations
 
 from dataclasses import dataclass
+from time import perf_counter, sleep
 from typing import TYPE_CHECKING
 
 from .backend import Backend
@@ -31,7 +32,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
+    backend: Backend | None = None
 
 
 class Game:
@@ -40,22 +41,31 @@ class Game:
     def __init__(self, config: GameConfig):
         """
         :param config: Game configuration options.
+        :type config: GameConfig
         """
         self.config = config
         self._current_scene: Scene | None = None
         self._running: bool = False
         self.backend: Backend | None = config.backend
 
+        if config.backend is None:
+            raise ValueError(
+                "GameConfig.backend must be set to a Backend instance"
+            )
+        self.backend: Backend = config.backend
+
     def change_scene(self, scene: Scene):
         """
         Swap the active scene. Concrete implementations should call
         ``on_exit``/``on_enter`` appropriately.
 
         :param scene: The new scene to activate.
+        :type scene: Scene
         """
-        raise NotImplementedError(
-            "Game.change_scene must be implemented by a concrete backend."
-        )
+        if self._current_scene is not None:
+            self._current_scene.on_exit()
+        self._current_scene = scene
+        self._current_scene.on_enter()
 
     def quit(self):
         """Request that the main loop stops."""
@@ -69,7 +79,40 @@ class Game:
         or another backend.
 
         :param initial_scene: The scene to start the game with.
+        :type initial_scene: Scene
         """
-        raise NotImplementedError(
-            "Game.run must be implemented by a concrete backend."
-        )
+        backend = self.backend
+        backend.init(self.config.width, self.config.height, self.config.title)
+
+        br, bg, bb = self.config.background_color
+        backend.set_clear_color(br, bg, bb)
+
+        self.change_scene(initial_scene)
+
+        self._running = True
+        target_dt = 1.0 / self.config.fps if self.config.fps > 0 else 0.0
+        last_time = perf_counter()
+
+        while self._running:
+            now = perf_counter()
+            dt = now - last_time
+            last_time = now
+
+            scene = self._current_scene
+            if scene is None:
+                break
+
+            for ev in backend.poll_events():
+                scene.handle_event(ev)
+
+            scene.update(dt)
+
+            backend.begin_frame()
+            scene.draw(backend)
+            backend.end_frame()
+
+            if target_dt > 0 and dt < target_dt:
+                sleep(target_dt - dt)
+
+        if self._current_scene is not None:
+            self._current_scene.on_exit()

{mini_arcade_core-0.6.0.dist-info → mini_arcade_core-0.7.0.dist-info}/METADATA

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

mini_arcade_core-0.7.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+mini_arcade_core/__init__.py,sha256=0PFa04KRSY3kT8YoD24zfFt92HYfrk6QrH8IlHbmeo4,1753
+mini_arcade_core/backend.py,sha256=Vus-TIU16ySSGKuy1S-sBWkpb2WUZCbUHYBPcwGpW9o,2665
+mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
+mini_arcade_core/game.py,sha256=G9x5FCzJN0KsnCy063sBgWkr3WkbPOJ8_SOHaslZ1mQ,3369
+mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
+mini_arcade_core-0.7.0.dist-info/METADATA,sha256=wRO23CTApLzioWwh50uJQPU823HRURJCRLueAabity0,8296
+mini_arcade_core-0.7.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.7.0.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.7.0.dist-info/RECORD,,

mini_arcade_core-0.6.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-mini_arcade_core/__init__.py,sha256=0PFa04KRSY3kT8YoD24zfFt92HYfrk6QrH8IlHbmeo4,1753
-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.6.0.dist-info/METADATA,sha256=hz6l1G6Oh3tm2UDzALEIAIKyG6YjYrZRr32_jz67K4o,8296
-mini_arcade_core-0.6.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.6.0.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.6.0.dist-info/RECORD,,