mini-arcade-core 0.2.3__py3-none-any.whl → 0.3.1__py3-none-any.whl

mini_arcade_core/__init__.py

@@ -5,6 +5,7 @@ Provides access to core classes and a convenience function to run a game.
 
 from __future__ import annotations
 
+from .backend import Backend, Event, EventType
 from .entity import Entity, SpriteEntity
 from .game import Game, GameConfig
 from .scene import Scene
@@ -29,4 +30,7 @@ __all__ = [
     "Entity",
     "SpriteEntity",
     "run_game",
+    "Backend",
+    "Event",
+    "EventType",
 ]

mini_arcade_core/backend.py

@@ -0,0 +1,75 @@
+"""
+Backend interface for rendering and input.
+This is the only part of the code that talks to SDL/pygame directly.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum, auto
+from typing import Iterable, Protocol
+
+
+class EventType(Enum):
+    """High-level event types understood by the core."""
+
+    UNKNOWN = auto()
+    QUIT = auto()
+    KEYDOWN = auto()
+    KEYUP = auto()
+
+
+@dataclass(frozen=True)
+class Event:
+    """
+    Core event type.
+
+    For now we only care about:
+    - type: what happened
+    - key: integer key code (e.g. ESC = 27), or None if not applicable
+
+    :ivar type (EventType): The type of event.
+    :ivar key (int | None): The key code associated with the event, if any.
+    """
+
+    type: EventType
+    key: int | None = None
+
+
+class Backend(Protocol):
+    """
+    Interface that any rendering/input backend must implement.
+
+    mini-arcade-core only talks to this protocol, never to SDL/pygame directly.
+    """
+
+    def init(self, width: int, height: int, title: str) -> None:
+        """
+        Initialize the backend and open a window.
+
+        Should be called once before the main loop.
+        """
+
+    def poll_events(self) -> Iterable[Event]:
+        """
+        Return all pending events since last call.
+
+        Concrete backends will translate their native events into core Event objects.
+        """
+
+    def begin_frame(self) -> None:
+        """
+        Prepare for drawing a new frame (e.g. clear screen).
+        """
+
+    def end_frame(self) -> None:
+        """
+        Present the frame to the user (swap buffers).
+        """
+
+    def draw_rect(self, x: int, y: int, w: int, h: int) -> None:
+        """
+        Draw a filled rectangle in some default color.
+
+        We'll keep this minimal for now; later we can extend with colors/sprites.
+        """

{mini_arcade_core-0.2.3.dist-info → mini_arcade_core-0.3.1.dist-info}/METADATA

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

mini_arcade_core-0.3.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+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.1.dist-info/METADATA,sha256=hvVLCE3cMyEOkcuNTrR-ytOj7SYFG8ATUeUiMbZZWKc,8296
+mini_arcade_core-0.3.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.3.1.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.3.1.dist-info/RECORD,,

mini_arcade_core-0.2.3.dist-info/RECORD

@@ -1,8 +0,0 @@
-mini_arcade_core/__init__.py,sha256=rtRWWmwC-yFNPHCLDI4C7P9i4ZYItDp7TP8i8cBUgmk,795
-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.2.3.dist-info/METADATA,sha256=bK_wXGKvvBIXY0E-KRDuGXK9_gtGoA74blCPZ7qJX-8,8296
-mini_arcade_core-0.2.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.2.3.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.2.3.dist-info/RECORD,,