mini-arcade-core 0.6.1__py3-none-any.whl → 0.7.1__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,42 @@ 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.
+        """
+
+    def capture_frame(self, path: str | None = None) -> bytes | None:
+        """
+        Capture the current frame.
+        If `path` is provided, save to that file (e.g. PNG).
+        Returns raw bytes (PNG) or None if unsupported.
+        """
+        raise NotImplementedError

mini_arcade_core/game.py

@@ -4,7 +4,9 @@ Game core module defining the Game class and configuration.
 
 from __future__ import annotations
 
+import os
 from dataclasses import dataclass
+from datetime import datetime
 from time import perf_counter, sleep
 from typing import TYPE_CHECKING
 
@@ -32,7 +34,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:
@@ -84,6 +86,9 @@ class Game:
         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
@@ -113,3 +118,19 @@ class Game:
 
         if self._current_scene is not None:
             self._current_scene.on_exit()
+
+    def screenshot(
+        self, label: str | None = None, directory: str = "screenshots"
+    ) -> str | None:
+        """
+        Ask backend to save a screenshot. Returns the file path or None.
+        """
+        os.makedirs(directory, exist_ok=True)
+        stamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        label = label or "shot"
+        filename = f"{stamp}_{label}.png"
+        path = os.path.join(directory, filename)
+
+        if self.backend.capture_frame(path):
+            return path
+        return None

{mini_arcade_core-0.6.1.dist-info → mini_arcade_core-0.7.1.dist-info}/METADATA

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

mini_arcade_core-0.7.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+mini_arcade_core/__init__.py,sha256=0PFa04KRSY3kT8YoD24zfFt92HYfrk6QrH8IlHbmeo4,1753
+mini_arcade_core/backend.py,sha256=DZUEO4zMlXIk3ctD9ZNqvgOo7n_ZKpC6x--hIede_YY,2946
+mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
+mini_arcade_core/game.py,sha256=yRMy0IJVB_yuF9P_SKjcxJG0YVMs52khVFLomSUeVw8,3935
+mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
+mini_arcade_core-0.7.1.dist-info/METADATA,sha256=KNIe3xKd_vY9eKTYdg6CujZL93-uznlqVXQaU3jl9M4,8296
+mini_arcade_core-0.7.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.7.1.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.7.1.dist-info/RECORD,,

mini_arcade_core-0.6.1.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=5mLbi3IzgfRXBTwl88L-ooez16NtwLKLQZzYvMkLHco,3280
-mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
-mini_arcade_core-0.6.1.dist-info/METADATA,sha256=pXNVRAEdlB52_Vz50sUTIPLoYLjMrPyvLfYFQsDXspw,8296
-mini_arcade_core-0.6.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.6.1.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.6.1.dist-info/RECORD,,