dnd5e-engine 0.1.0__tar.gz → 0.1.2__tar.gz

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2]
+
+### Added
+- `ActionType.USE_ITEM` parser-facing action member.
+
+## [0.1.1]
+
+### Added
+- `LiveCombatView` — public read-model projection of live combat state.
+- `get_live(handle) -> LiveCombatView` is now part of the public API (`__all__`);
+  it returns a point-in-time snapshot view instead of the private `_LiveCombat`.
+- `roll_dice_str` — the dice-expression evaluator is now a public test seam
+  (renamed from the private `_roll_dice_str`).
+
 ## [0.1.0]
 
 First public release.

dnd5e_engine-0.1.2/Makefile

@@ -0,0 +1,19 @@
+.PHONY: check lint format format-check type test coverage security smoke
+check: lint format-check type coverage security
+lint:
+	uv run ruff check .
+format:
+	uv run ruff format .
+format-check:
+	uv run ruff format --check .
+type:
+	uv run mypy src/
+test:
+	uv run pytest -q
+# Baseline-and-ratchet coverage gate (75% observed today; floor set 2pts under).
+coverage:
+	uv run pytest -q --cov=dnd5e_engine --cov-report=term-missing --cov-fail-under=73
+security:
+	uv run bandit -r src/ -c pyproject.toml -q
+smoke:
+	bash scripts/smoke_clean_install.sh

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dnd5e-engine
-Version: 0.1.0
+Version: 0.1.2
 Summary: Pure-Python D&D 5e SRD rules engine — combat, checks, effects. Host-agnostic, zero I/O.
 Author: Tapestria contributors
 License: MIT License
@@ -37,7 +37,9 @@ Requires-Dist: d20>=1.1.2
 Requires-Dist: dnd5e-srd-data>=0.1.0
 Requires-Dist: pydantic>=2.10.0
 Provides-Extra: dev
+Requires-Dist: bandit>=1.8.0; extra == 'dev'
 Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
 Requires-Dist: pytest>=8.3.0; extra == 'dev'
 Requires-Dist: ruff>=0.9.0; extra == 'dev'
 Description-Content-Type: text/markdown

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dnd5e-engine"
-version = "0.1.0"
+version = "0.1.2"
 description = "Pure-Python D&D 5e SRD rules engine — combat, checks, effects. Host-agnostic, zero I/O."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -30,8 +30,10 @@ dependencies = [
 [project.optional-dependencies]
 dev = [
     "pytest>=8.3.0",
+    "pytest-cov>=6.0.0",
     "ruff>=0.9.0",
     "mypy>=1.13.0",
+    "bandit>=1.8.0",
 ]
 
 [tool.uv.sources]
@@ -60,17 +62,42 @@ target-version = "py312"
 [tool.ruff.lint]
 select = [
     "E", "F", "I", "N", "UP", "B", "SIM", "T20", "BLE",
-    "ASYNC", "PT", "RUF", "TRY",
+    "C90", "ASYNC", "PT", "RUF", "TRY",
 ]
 ignore = [
     "TRY003",
     "RUF001", "RUF002", "RUF003",
 ]
 
+# Baseline-and-ratchet: set at the worst function observed today
+# (submit_player_intent=23, in orchestrator.py). Ratcheted down from 56
+# after extracting the orchestrator hotspots (_emit 49→12, start_combat
+# 34→3, _build_hydration_payload 36→6). A PR past this must justify it;
+# keep ratcheting DOWN.
+[tool.ruff.lint.mccabe]
+max-complexity = 23
+
 [tool.ruff.lint.per-file-ignores]
-"tests/**/*.py" = ["E501", "F841", "PT006", "PT011"]
+# Test bodies are allowed to be branchy/repetitive (C901) and print (T201).
+"tests/**/*.py" = ["E501", "F841", "PT006", "PT011", "C901"]
 # Smoke scripts print human-readable progress/result lines (T201) by design.
 "scripts/**/*.py" = ["T201"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["dnd5e_engine"]
+
+[tool.coverage.report]
+exclude_also = [
+    "if TYPE_CHECKING:",
+    "@overload",
+    "raise NotImplementedError",
+]
+
+# Recursive scan of src/ only; tests carry asserts (B101) and the engine
+# rolls dice with the stdlib RNG (B311) — neither is a security concern.
+[tool.bandit]
+exclude_dirs = ["tests"]
+skips = ["B101", "B311"]

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/scripts/_smoke_grid_combat.py

@@ -30,9 +30,7 @@ _BUNDLED_MONSTER_SLUG = "goblin-warrior"
 def _check_corpus() -> None:
     loader = get_lib_loader()  # BundledAssetLoader → reads bundled canonical/
     monster = loader.get_monster(_BUNDLED_MONSTER_SLUG)
-    assert monster is not None, (
-        f"bundled corpus did not resolve monster {_BUNDLED_MONSTER_SLUG!r}"
-    )
+    assert monster is not None, f"bundled corpus did not resolve monster {_BUNDLED_MONSTER_SLUG!r}"
 
 
 async def _run_grid_combat() -> None:
@@ -63,15 +61,15 @@ async def _run_grid_combat() -> None:
         grid_scene=GridScene(width=10, height=10),
         rng_seed=1,
     )
-    live = get_live(start.handle)
-    assert live.actor_zone["char:hero"] == "0,0"
+    assert get_live(start.handle).actor_zone["char:hero"] == "0,0"
     # One legal single-cell move proves the grid MOVE path resolves end-to-end.
     await submit_player_intent(
         start.handle,
         actor_id="char:hero",
         intent=PlayerIntent(intent_type="move", target_zone_id=cell_id(1, 1)),
     )
-    assert live.actor_zone["char:hero"] == "1,1", "grid move did not apply"
+    # get_live returns a point-in-time snapshot, so re-fetch after the move.
+    assert get_live(start.handle).actor_zone["char:hero"] == "1,1", "grid move did not apply"
     result = await end_combat(start.handle)
     assert result is not None
     print("SMOKE OK: corpus loaded + grid combat ran (hero moved 0,0 -> 1,1)")

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/src/dnd5e_engine/__init__.py

@@ -13,7 +13,7 @@ Deferred for later phases:
 
 from __future__ import annotations
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 from dnd5e_engine.build_party import build_party_member
 from dnd5e_engine.build_spec import (
@@ -26,10 +26,12 @@ from dnd5e_engine.check import CheckKind, CheckResult, CheckSpec, resolve_check
 from dnd5e_engine.events import CombatEvent, IntentType
 from dnd5e_engine.orchestrator import (
     CombatHandle,
+    LiveCombatView,
     PlayerIntent,
     advance_monster_turn,
     end_combat,
     get_actor_active_effects,
+    get_live,
     narration_events,
     start_combat,
     submit_player_intent,
@@ -40,6 +42,7 @@ from dnd5e_engine.outcome import (
     LootDrop,
 )
 from dnd5e_engine.results import EndCombatResult, StartCombatResult
+from dnd5e_engine.rules.effects import roll_dice_str
 from dnd5e_engine.spatial import cell_id, parse_cell
 from dnd5e_engine.specs import (
     EncounterMemberSpec,
@@ -74,6 +77,7 @@ __all__ = [
     "EndCombatResult",
     "GridScene",
     "IntentType",
+    "LiveCombatView",
     "LootDrop",
     "PartyMemberSpec",
     "PlayerIntent",
@@ -85,10 +89,12 @@ __all__ = [
     "cell_id",
     "end_combat",
     "get_actor_active_effects",
+    "get_live",
     "make_build_spec",
     "narration_events",
     "parse_cell",
     "resolve_check",
+    "roll_dice_str",
     "start_combat",
     "submit_player_intent",
 ]

{dnd5e_engine-0.1.0 → dnd5e_engine-0.1.2}/src/dnd5e_engine/activities/formula.py

@@ -123,9 +123,7 @@ def resolve_damage_block(
     return block.model_copy(update=updates) if updates else block
 
 
-def _resolve_token(
-    token: str, ctx: ActivityResolutionContext, ability: str | None
-) -> int | str:
+def _resolve_token(token: str, ctx: ActivityResolutionContext, ability: str | None) -> int | str:
     if token == _TOKEN_PROF:
         return ctx.caster_proficiency_bonus
     if token == _TOKEN_MOD: