클래식 공개 API 정리

맥락:
- GUI 이식 전에 classic 패키지 루트에서 노출할 API 범위를 정리했다.
- Claude Opus 4.7 xhigh 자문에서 root export 축소와 backend builder 이름 단일화를 우선 권장했다.

변경:
- classic package root export를 GameState, config, env, backend, bot registry 중심으로 줄였다.
- backend factory 이름을 build_backend로 단일화하고 README 사용 예시를 갱신했다.
- public API smoke test를 추가하고 pyproject description 및 Cython build failure 처리를 정리했다.

확인:
- uv run pytest tests/games/classic
- uv run lost-cities-classic
This commit is contained in:
2026-05-06 19:21:17 +09:00
parent 7df6e42904
commit 361420df7a
7 changed files with 94 additions and 25 deletions
+24
View File
@@ -0,0 +1,24 @@
from __future__ import annotations
import coolrl_lost_cities.games.classic as classic
def test_classic_package_exports_common_game_api() -> None:
config = classic.classic_config(seed=1)
state = classic.GameState.new_game(config)
bot = classic.build_bot("random", seed=1)
action = bot.act(state)
assert state.unified_legal_mask()[state.to_unified_action(action)]
assert state.config.deck_size == 60
def test_classic_package_exports_backend_alias() -> None:
backend = classic.build_backend("python", classic.classic_config(), seed=1)
assert isinstance(backend.snapshot(), classic.Snapshot)
def test_classic_package_exports_bot_registry_helpers() -> None:
assert "random" in classic.available_bot_names()
assert isinstance(classic.build_bot("random", seed=1), classic.LostCitiesBot)