coolguy 12b59211b2 Python 포맷팅과 pre-commit 설정
맥락:
- Python 코드만 대상으로 Ruff 기반 format/lint와 pre-commit hook을 도입한다.
- Cython game.pyx는 Ruff 대상에서 제외해 포맷터 충돌을 피한다.

변경:
- ruff와 pre-commit dev dependency 및 Ruff 설정을 추가했다.
- pre-commit config와 Python format/check 스크립트를 추가했다.
- Ruff format/check --fix 결과로 Python import 정렬과 포맷을 적용했다.

확인:
- uv sync --extra gui
- uv run pre-commit run --all-files
- scripts/check-python.sh
- uv run lost-cities-classic
2026-05-06 19:59:07 +09:00
2026-05-06 19:21:17 +09:00
2026-05-06 19:59:07 +09:00

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()

Rust sources live outside the Python package:

rust/lost-cities-core/
proto/lost_cities.proto

See classic port notes for the current direction.

S
Description
Lost Cities
Readme
7.7 MiB
Languages
Python 73.3%
Cython 21.7%
Julia 4.8%
Shell 0.2%