mini-arcade-core 0.9.6__py3-none-any.whl → 0.9.7__py3-none-any.whl

mini_arcade_core/__init__.py

@@ -1,41 +1,13 @@
 """
 Entry point for the mini_arcade_core package.
 Provides access to core classes and a convenience function to run a game.
-
-mini_arcade_core/
-|-- __init__.py # main entry point
-|-- game.py # core game loop and management
-|-- entity.py # base entity classes
-|-- backend/ # backend abstraction layer
-|   |-- __init__.py
-|   |-- backend.py # abstract Backend class
-|   |-- events.py # event definitions
-|   |-- types.py # common types like Color
-|-- keymaps/ # key mapping utilities
-|   |-- __init__.py
-|   |-- keys.py # key definitions and keymaps
-|   |-- sdl.py # SDL keycode mappings
-|-- scenes/ # scene management
-|   |-- __init__.py
-|   |-- autoreg.py # automatic scene registration
-|   |-- registry.py # SceneRegistry class
-|   |-- scene.py # base Scene class
-|-- two_d/ # 2D utilities and types
-|   |-- __init__.py
-|   |-- boundaries2d.py # boundary behaviors
-|   |-- collision2d.py # collision detection
-|   |-- geometry2d.py # geometric types like Position2D, Size2D
-|   |-- kinematics2d.py # kinematic data structures
-|   |-- physics2d.py # physics-related types like Velocity2D
-|-- ui/ # user interface components
-|   |-- __init__.py
-|   |-- menu.py # menu components
 """
 
 from __future__ import annotations
 
 import logging
 from importlib.metadata import PackageNotFoundError, version
+from typing import Callable, Type, Union
 
 from mini_arcade_core.backend import Backend, Event, EventType
 from mini_arcade_core.entity import Entity, KinematicEntity, SpriteEntity
@@ -55,19 +27,27 @@ from mini_arcade_core.two_d import (
     VerticalWrap,
 )
 
+SceneFactoryLike = Union[Type[Scene], Callable[[Game], Scene]]
+
 logger = logging.getLogger(__name__)
 
 
 def run_game(
-    initial_scene_cls: type[Scene],
+    scene: SceneFactoryLike | None = None,
     config: GameConfig | None = None,
     registry: SceneRegistry | None = None,
+    initial_scene: str = "main",
 ):
     """
     Convenience helper to bootstrap and run a game with a single scene.
 
-    :param initial_scene_cls: The Scene subclass to instantiate as the initial scene.
-    :type initial_scene_cls: type[Scene]
+    Supports both:
+      - run_game(SceneClass, cfg)            # legacy
+      - run_game(config=cfg, initial_scene="main", registry=...)  # registry-based
+      - run_game(cfg)                       # config-only
+
+    :param initial_scene: The Scene ID to start the game with.
+    :type initial_scene: str
 
     :param config: Optional GameConfig to customize game settings.
     :type config: GameConfig | None
@@ -77,14 +57,27 @@ def run_game(
 
     :raises ValueError: If the provided config does not have a valid Backend.
     """
+    # Handle run_game(cfg) where the first arg is actually a GameConfig
+    if isinstance(scene, GameConfig) and config is None:
+        config = scene
+        scene = None
+
     cfg = config or GameConfig()
-    if config.backend is None:
+    if cfg.backend is None:
         raise ValueError(
             "GameConfig.backend must be set to a Backend instance"
         )
+
+    # If user provided a Scene factory/class, ensure it's registered
+    if scene is not None:
+        if registry is None:
+            registry = SceneRegistry(_factories={})
+        registry.register(
+            initial_scene, scene
+        )  # Scene class is callable(game) -> Scene
+
     game = Game(cfg, registry=registry)
-    scene = initial_scene_cls(game)
-    game.run(scene)
+    game.run(initial_scene)
 
 
 __all__ = [
@@ -141,6 +134,3 @@ def get_version() -> str:
 
 
 __version__ = get_version()
-__version__ = get_version()
-__version__ = get_version()
-__version__ = get_version()

{mini_arcade_core-0.9.6.dist-info → mini_arcade_core-0.9.7.dist-info}/METADATA

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

{mini_arcade_core-0.9.6.dist-info → mini_arcade_core-0.9.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mini_arcade_core/__init__.py,sha256=yAtLsSrBZD3778nStf0XQjKn5hTP-daYkddk7_dAGe4,4029
+mini_arcade_core/__init__.py,sha256=Q6N1eJe5W8r3i_G88-WZ90B71P6eFuH-Zk5xw3p7SBs,3650
 mini_arcade_core/backend/__init__.py,sha256=w-6QTUngdIYZuvEU3B8zL-vXyKbyLDVucbt7yKZdLlc,379
 mini_arcade_core/backend/backend.py,sha256=dLXTtLn5qURftWOWOVQd2ouuZmJpbiOl11KMIDRk2us,4026
 mini_arcade_core/backend/events.py,sha256=usn2HTk5-5ZiaU2IjbrNRpEj_4uoaiqfY3qufQLYy0w,2929
@@ -20,7 +20,7 @@ mini_arcade_core/two_d/kinematics2d.py,sha256=NFMiIzDYqDquyg_EhD7EQBJ_Sz4RncmkEj
 mini_arcade_core/two_d/physics2d.py,sha256=qIq86qWVuvcnLIMEPH6xx7XQO4tQhfiMZY6FseuVOR8,1636
 mini_arcade_core/ui/__init__.py,sha256=RmcZXfBFFmL09j_Bo1LHagRjiKYajuySPilIUNjc3KQ,248
 mini_arcade_core/ui/menu.py,sha256=J3hYY46xOHLN65WSet4-cnQU7L5pu48scjLJUW9IkEM,13681
-mini_arcade_core-0.9.6.dist-info/METADATA,sha256=TXCP-kgqZegagNZ6_Zoa_lLU0nhNiC6yVGnHpv4iRjM,8188
-mini_arcade_core-0.9.6.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.9.6.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.9.6.dist-info/RECORD,,
+mini_arcade_core-0.9.7.dist-info/METADATA,sha256=ghW7JHVtzj3xDdaQHOvhHmo0JjtLM5Rqpk0K-05RqOI,8188
+mini_arcade_core-0.9.7.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.9.7.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.9.7.dist-info/RECORD,,