mini-arcade-core 0.7.0__tar.gz → 0.7.1__tar.gz

{mini_arcade_core-0.7.0 → mini_arcade_core-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-arcade-core
-Version: 0.7.0
+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.0 → mini_arcade_core-0.7.1}/pyproject.toml

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

{mini_arcade_core-0.7.0 → mini_arcade_core-0.7.1}/src/mini_arcade_core/backend.py

@@ -103,3 +103,11 @@ class Backend(Protocol):
         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-0.7.0 → mini_arcade_core-0.7.1}/src/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
 
@@ -116,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