mini-arcade-core 0.4.0__tar.gz → 0.5.3__tar.gz

{mini_arcade_core-0.4.0 → mini_arcade_core-0.5.3}/PKG-INFO

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

{mini_arcade_core-0.4.0 → mini_arcade_core-0.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "mini-arcade-core"
-version = "0.4.0"
+version = "0.5.3"
 description = "Tiny scene-based game loop core for small arcade games."
 authors = [
     { name = "Santiago Rincon", email = "rincores@gmail.com" },
@@ -57,6 +57,8 @@ strict = false
 disable = [
     # Justification: Allow classes with few public methods for simplicity.
     "too-few-public-methods",
+    # Justification: f-strings are preferred for logging.
+    "logging-fstring-interpolation",
     # Justification: TODOs are acceptable during development.
     "fixme",
 ]

{mini_arcade_core-0.4.0 → mini_arcade_core-0.5.3}/src/mini_arcade_core/__init__.py

@@ -5,11 +5,16 @@ Provides access to core classes and a convenience function to run a game.
 
 from __future__ import annotations
 
+import logging
+from importlib.metadata import PackageNotFoundError, version
+
 from .backend import Backend, Event, EventType
 from .entity import Entity, SpriteEntity
 from .game import Game, GameConfig
 from .scene import Scene
 
+logger = logging.getLogger(__name__)
+
 
 def run_game(initial_scene_cls: type[Scene], config: GameConfig | None = None):
     """
@@ -34,3 +39,31 @@ __all__ = [
     "Event",
     "EventType",
 ]
+
+PACKAGE_NAME = "mini-arcade-core"  # or whatever is in your pyproject.toml
+
+
+def get_version() -> str:
+    """
+    Return the installed package version.
+
+    This is a thin helper around importlib.metadata.version so games can do:
+
+        from mini_arcade_core import get_version
+        print(get_version())
+
+    :return: The version string of the installed package.
+    :rtype: str
+
+    :raises PackageNotFoundError: If the package is not installed.
+    """
+    try:
+        return version(PACKAGE_NAME)
+    except PackageNotFoundError:  # if running from source / editable
+        logger.warning(
+            f"Package '{PACKAGE_NAME}' not found. Returning default version '0.0.0'."
+        )
+        return "0.0.0"
+
+
+__version__ = get_version()