coolguy
73fe7e2c94
맥락: - pygame GUI 이식 전에 core 설치와 GUI 의존성을 분리하고 asset 로딩 경로를 고정한다. 변경: - pyproject에 gui extra로 pygame과 pygame-gui를 추가했다. - classic resource helper를 추가해 packaged asset 경로를 importlib.resources 기반으로 읽게 했다. - theme asset resource 테스트와 README 설치 안내를 추가했다. 확인: - uv sync --extra gui - uv run pytest tests/games/classic - uv run lost-cities-classic
1.3 KiB
1.3 KiB
coolrl-lost-cities
Focused Lost Cities extraction from the legacy coolrl repository.
The current implementation starts with the classic two-player card game:
- classic 5-expedition rules by default
- Python/Cython game engine
- Rust core parity checks
- env wrapper
- random, passive-discard, and safe-heuristic bots
- core rule, scoring, mask, env, canonical-state, bot, and Rust parity tests
Training code, Deep CFR, learned-policy evaluation, GUI, and web client are intentionally outside the first port.
Development
uv run pytest tests/games/classic
uv run lost-cities-classic
For future GUI work, install the optional GUI dependencies:
uv sync --extra gui
Basic Usage
from coolrl_lost_cities.games.classic import GameState, build_bot, classic_config
state = GameState.new_game(classic_config(seed=1))
bot = build_bot("random", seed=1)
while not state.terminal:
state.apply_action(bot.act(state))
print(state.total_score(0), state.total_score(1))
Backends use the same snapshot/apply/undo interface:
from coolrl_lost_cities.games.classic import build_backend, classic_config
backend = build_backend("python", classic_config(), seed=1)
snapshot = backend.snapshot()
See classic port notes for the current direction.