mini-arcade-core 0.4.0__py3-none-any.whl → 0.5.2__py3-none-any.whl

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,38 @@ __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"
+
+
+try:
+    __version__ = get_version()
+# Justification: We want to ensure that any exception during version retrieval
+# results in a default version being set, rather than crashing the import.
+# pylint: disable=broad-exception-caught
+except Exception:
+    __version__ = "0.0.0"
+# pylint: enable=broad-exception-caught

{mini_arcade_core-0.4.0.dist-info → mini_arcade_core-0.5.2.dist-info}/METADATA

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

{mini_arcade_core-0.4.0.dist-info → mini_arcade_core-0.5.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
-mini_arcade_core/__init__.py,sha256=c66IkzZjiyUbTtjQRyf4XyiH6xPS79Ajxeb1OvnVPZA,887
+mini_arcade_core/__init__.py,sha256=xlePCq6tvPfIgHlhQ-WtESvEyX2sjkgu_aann-1QsZk,2041
 mini_arcade_core/backend.py,sha256=6_3-ni0EQJXfaSReavcrOeUOCNkdrjGctFn5q0D9nrw,1847
 mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
 mini_arcade_core/game.py,sha256=OkQIFkFLqFailZDPY1fAq6Tyi7IQ9EKxloW1UgDaHko,2123
 mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
-mini_arcade_core-0.4.0.dist-info/METADATA,sha256=-xzwRN08pD-G9PgpCH_Ld-KxFRNlRWC9bGtb-fA_lv8,8296
-mini_arcade_core-0.4.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.4.0.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.4.0.dist-info/RECORD,,
+mini_arcade_core-0.5.2.dist-info/METADATA,sha256=5ogfRfSrJtRHRqnSAGo2ZSNQWDMal3USAFZ3rCeJGtY,8296
+mini_arcade_core-0.5.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.5.2.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.5.2.dist-info/RECORD,,