dnd5e-engine 0.3.0__tar.gz → 0.3.1__tar.gz

{dnd5e_engine-0.3.0 → dnd5e_engine-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: dnd5e-engine
-Version: 0.3.0
+Version: 0.3.1
 Summary: Pure-Python D&D 5e SRD rules engine — combat, checks, effects. Host-agnostic, zero I/O.
 Author: Tapestria contributors
 License: MIT License

{dnd5e_engine-0.3.0 → dnd5e_engine-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dnd5e-engine"
-version = "0.3.0"
+version = "0.3.1"
 description = "Pure-Python D&D 5e SRD rules engine — combat, checks, effects. Host-agnostic, zero I/O."
 readme = "README.md"
 requires-python = ">=3.12"

{dnd5e_engine-0.3.0 → dnd5e_engine-0.3.1}/src/dnd5e_engine/__init__.py

@@ -13,7 +13,7 @@ Deferred for later phases:
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"
 
 from dnd5e_engine.build_party import build_party_member
 from dnd5e_engine.build_spec import (
@@ -24,6 +24,7 @@ from dnd5e_engine.build_spec import (
 )
 from dnd5e_engine.check import CheckKind, CheckResult, CheckSpec, resolve_check
 from dnd5e_engine.events import CombatEvent, IntentType
+from dnd5e_engine.lib_loader import configure_lib_loader
 from dnd5e_engine.orchestrator import (
     CombatHandle,
     LiveCombatView,
@@ -101,6 +102,7 @@ __all__ = [
     "advance_monster_turn",
     "build_party_member",
     "cell_id",
+    "configure_lib_loader",
     "end_combat",
     "get_actor_active_effects",
     "get_live",

{dnd5e_engine-0.3.0 → dnd5e_engine-0.3.1}/src/dnd5e_engine/lib_loader.py

@@ -25,7 +25,16 @@ def set_lib_loader_for_tests(loader: AssetLoader | None) -> None:
     _LIB_LOADER = loader
 
 
+def configure_lib_loader(loader: AssetLoader | None) -> None:
+    """Public host seam: install a custom AssetLoader (e.g. a homebrew
+    overlay). ``None`` reverts to the lazy bundled default. Hosts must
+    call this before start_combat; swapping mid-combat is unsupported."""
+    global _LIB_LOADER
+    _LIB_LOADER = loader
+
+
 __all__ = [
+    "configure_lib_loader",
     "get_lib_loader",
     "set_lib_loader_for_tests",
 ]

dnd5e_engine-0.3.1/tests/test_lib_loader_configure.py

@@ -0,0 +1,20 @@
+"""configure_lib_loader — public host seam for AssetLoader injection."""
+
+from dnd5e_srd_data.loader import BundledAssetLoader, MemoryAssetLoader
+
+import dnd5e_engine
+from dnd5e_engine.lib_loader import get_lib_loader
+
+
+def test_configure_lib_loader_is_public() -> None:
+    assert "configure_lib_loader" in dnd5e_engine.__all__
+
+
+def test_configure_installs_and_none_reverts() -> None:
+    custom = MemoryAssetLoader()
+    try:
+        dnd5e_engine.configure_lib_loader(custom)
+        assert get_lib_loader() is custom
+    finally:
+        dnd5e_engine.configure_lib_loader(None)
+    assert isinstance(get_lib_loader(), BundledAssetLoader)

{dnd5e_engine-0.3.0 → dnd5e_engine-0.3.1}/tests/test_public_api_surface.py

@@ -35,6 +35,7 @@ TOP_LEVEL = {
     "advance_monster_turn",
     "build_party_member",
     "cell_id",
+    "configure_lib_loader",
     "end_combat",
     "get_actor_active_effects",
     "get_live",