mini-arcade-core 0.9.6__tar.gz → 0.9.7__tar.gz

{mini_arcade_core-0.9.6 → mini_arcade_core-0.9.7}/PKG-INFO

@@ -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 → mini_arcade_core-0.9.7}/pyproject.toml

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

{mini_arcade_core-0.9.6 → mini_arcade_core-0.9.7}/src/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()