woggioni
8f0e974842
CI / Build and push docker image (push) Successful in 3m16s
An ace played when no equal rank is on the table sweeps the whole table; the sweep never scores a scopa, and an ace already on the table still forces the mandatory equal-rank capture. The rule is off by default, selectable per match via the schema-driven creation form, and announced in the game view.
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# tavolo-scopone
|
|
|
|
Scopone scientifico — the four-player, fixed-partnership Italian card
|
|
game — as a [`tavolo-platform`](../tavolo-platform/README.md) game
|
|
implementation.
|
|
|
|
## Contents
|
|
|
|
- `state.py` — `ScoponeState` (pure game data: phases, players, hands,
|
|
table, scores, deadlines), `PlayerState`, `Card`, `Move`, with JSON
|
|
(de)serialization. No session envelope, no transport, no I/O.
|
|
- `engine.py` — the pure rules engine: deck, legal captures, plays,
|
|
auto-play, hand scoring (carte, denara, settebello, primiera, scope,
|
|
napola), the optional asso pigliatutto sweep, hand-end
|
|
acknowledgements. Deterministic and I/O-free apart from logging, so the
|
|
whole rule set is unit-testable.
|
|
- `errors.py` — scopone-specific errors (`CardNotInHand`); every other
|
|
failure mode is a shared `tavolo.platform.errors` subclass.
|
|
- `plugin.py` — `ScoponeEngine(GameEngine)`: the platform-facing adapter.
|
|
It translates create/join/websocket actions/deadlines into rules-engine
|
|
calls and back, validates the `target_score`/`napola`/`asso_pigliatutto`
|
|
creation options, and extracts the `MatchResult` (teams, winner,
|
|
per-player scores and the match summary persisted as the match's JSON
|
|
`result`).
|
|
|
|
Timeouts are constructor arguments (`turn_timeout_seconds`,
|
|
`hand_ack_timeout_seconds`), wired from the environment by the
|
|
application composition root.
|
|
|
|
## Development (from `server/`)
|
|
|
|
```sh
|
|
.venv/bin/python -m unittest discover -s packages/tavolo-scopone/tests
|
|
.venv/bin/python -m mypy -p tavolo.scopone
|
|
```
|
|
|
|
`test_engine.py` covers the pure rules; `test_plugin.py` covers the
|
|
platform contract (actions, deadlines, serialization, results).
|