magmacrunch-scandinavian-stud 0.1.0__tar.gz

magmacrunch_scandinavian_stud-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+# The link tools/link-shared.mjs makes to the website's arcade/shared/.
+/shared
+__pycache__/
+*.pyc
+.pytest_cache/
+node_modules/
+.DS_Store
+.ruff_cache/
+*.egg-info/

magmacrunch_scandinavian_stud-0.1.0/LICENSE

@@ -0,0 +1,75 @@
+Required Notice: Copyright 2026 magmacrunch media (https://magmacrunch.com)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

magmacrunch_scandinavian_stud-0.1.0/NOTICE

@@ -0,0 +1,34 @@
+scandinavian-stud
+Copyright 2026 magmacrunch media
+
+
+THE LICENCE
+
+Everything in this repository -- the browser client and the WebSocket server
+in web/, its terminal version in tui/, the tools, and the documentation -- is
+licensed under the PolyForm Noncommercial License 1.0.0, in the LICENSE file
+beside this one.
+
+Read it, learn from it, build on it, play with it. Any noncommercial purpose is
+permitted, and that includes personal projects, teaching and research. What is
+not permitted is commercial use: selling the game or a derivative of it,
+shipping it inside a product, or running it as part of a business.
+
+Scandinavian Stud is a traditional card game and nobody's property; this licence
+does not pretend otherwise. What is licensed is this implementation: the rules, the hand evaluator, the betting, the table renderer and the
+server.
+
+What is reserved: the magmacrunch name and marks and the visual design of the
+arcade. If you want to use any of it, ask.
+
+
+THIRD-PARTY COMPONENTS
+
+Fonts are loaded from Google Fonts under the SIL Open Font License 1.1 rather
+than shipped here as files.
+
+The client loads the adenosine cards, multiplayer and score bundles, the deck
+art and the arcade styles from the website's arcade/shared/, and the server
+imports server_base and card_constants from arcade/shared/multiplayer/. Those
+are part of the magmacrunch.com repository and adenosine, and are not copied
+here.

magmacrunch_scandinavian_stud-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.5
+Name: magmacrunch-scandinavian-stud
+Version: 0.1.0
+Summary: Sökö, Scandinavian stud poker, against three computers. Terminal version.
+Project-URL: Homepage, https://magmacrunch.com/arcade/scandinavian-stud/
+Author: magmacrunch media
+License-Expression: PolyForm-Noncommercial-1.0.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: arcade,cards,games,poker,stud,terminal,tui
+Requires-Python: >=3.10
+Requires-Dist: magmacrunch>=0.15.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: websockets>=14.0; extra == 'dev'
+Provides-Extra: online
+Requires-Dist: websockets>=14.0; extra == 'online'
+Description-Content-Type: text/markdown
+
+# Sökö (terminal)
+
+Sökö, Scandinavian stud poker, against the page's three computers, Mikko,
+Liisa and Jussi, in a terminal. It is the second version of the game, beside
+`web/`. It runs on the [magmacrunch](https://github.com/magmacrunch-media/magmacrunch)
+engine's terminal backend, either as a cabinet in the magmacrunch arcade or as
+its own command, and plays the same either way.
+
+```
+pipx install magmacrunch-scandinavian-stud
+soko                    # the title
+soko --play --seed 7    # straight to the table, the same shuffles every time
+soko --online           # PLAY ONLINE (needs the [online] extra)
+```
+
+PLAY ONLINE, a prototype, plays people instead, through the page's own
+server: `pipx install "magmacrunch-scandinavian-stud[online]"`.
+
+For working on it, from this folder, once the website's `shared/` is linked
+in beside `web/` (`node tools/link-shared.mjs` from the repository's root),
+which the oracle test needs:
+
+```
+pip install -e ".[dev]"
+python -m stud
+```
+
+## Keys
+
+| key | |
+|---|---|
+| `←` `→` | choose among the actions the page would offer |
+| `ENTER` | take it; at the end of a hand, deal the next |
+| `C` `R` `F` | check or call, raise, fold |
+| `N` | a new table |
+| `Esc` | the title (and from there, the arcade) |
+| `Q` | quit |
+
+The three computers sit above, you below. Your cards are all shown, your hole
+card first; theirs show their face-up cards and a `▓▓` for the hole card
+until a showdown. Each seat says its chips, its bet this round, and when it
+has folded or gone all-in; your hand is named as the page names it, Finnish
+and English. The labels are the page's own pairs: *Sekötä / check*, *Maksaa /
+call*, *Nostaa / raise*, *Luovuttaa / fold*. The computers keep the page's
+clock: one decides 0.8 seconds after its turn comes, and a finished round of
+betting deals the next street after 0.6.
+
+Win every chip the computers have and the table is yours, and it goes on
+the high-score table as the page scores it: your chips per hand it took,
+x100, so the faster the clear, the higher. A
+player with no chips sits every hand out after; when that is you, the table
+is lost and the next is a new one.
+
+Needs a 78x24 terminal.
+
+## It is the browser's game, and the browser's opponents
+
+`stud/rules.py` is `web/js/config.js`, `hand-eval.js` and `game.js`, with the
+deck and its shuffle from the website's `shared/adenosine-cards.js` and the
+turn-taking of `main.js`, function for function. The shuffle is the only
+random thing in the game: the computers decide by rule. Two tests hold the
+port to the page:
+
+- **`tests/test_oracle.py`.** `tools/js_oracle.mjs` loads those files
+  unmodified, with a seeded `Math.random`, and plays 40 tables of 80 hands
+  through `SokoGame`'s own API in `main.js`'s order: 3,200 hands, about 55,000
+  actions. Half have a random player in your seat, half a calling station. The
+  test shuffles the same decks through the port and requires the same state
+  after every action: every player's chips, cards, bet and hand, the pot, the
+  bet to match, the street, whose turn, the raises and who has acted, the
+  phase and the winner, and starts a new table where the page does. Moving
+  a style's mark, or dealing in a player with no chips again, fails it within
+  the first table.
+- **`tests/test_rules.py`.** It sets up by hand the cases worth pinning,
+  including the page's own rules below, so that fixing one shows as a change.
+
+## The page's rules
+
+The page's betting, side pots, ties and computers were fixed in
+scandinavian-stud#3, and the port with them. Two places where it is still not
+poker, kept because the oracle requires them:
+
+- **A tie is not split.** The pot goes to the tied player nearest the
+  dealer's left. Each pot is its own: an all-in player wins only the part
+  they matched, and the rest goes to the best hand among those who matched it.
+- **A conservative or moderate computer with nothing never calls.** High card
+  scores 0, under their call marks, so they check when they can and fold to
+  any bet. The aggressive one calls anything.
+
+## Online, a prototype
+
+PLAY ONLINE meets two to four people, in terminals or browsers, in a room on
+the arcade's own server, `web/server.py`, the one behind the page's
+Multiplayer button. One creates the room and says its four-letter code, the
+others join with it, and the host deals. `--server ws://host:8767` points at
+another server, a Pi on the same network say.
+
+The server keeps the game: it deals, says whose turn it is and what they may
+do, and sends the whole table after every action. `stud/online.py` keeps that
+latest table and sends the action chosen; `stud/online_scenes.py` draws it
+with the same table screen as the computers, you below and the others above
+in the server's order from you. Hand after hand anyone at the table deals the
+next with ENTER, until one player holds every chip.
+
+`tests/test_online.py` runs the real server in-process and plays real
+clients against it over real sockets. Three players take seeded random
+actions through a whole table to a table won, and after every
+action every client's table is the server's view for that player. Two terminal sessions also
+play a hand by keys. Making the client ignore the server's `hand_started`
+frames fails both. A terminal session has also played three hands against
+the page in Chromium through `web/server.py` run as the Pi runs it, the two
+agreeing on every chip.
+
+**Each player is sent only their own hole card.** The server builds the
+table again for each player as it sends a frame: their own hole card, and
+everyone's still in once a hand goes to a showdown; a hand won by a fold
+shows nobody's. A spectator sees what a player sees of the others. It used
+to send one frame to the whole room with every hole card and hand in it,
+which the page and this client drew face down but anyone reading the frames
+could see. `tests/test_online.py` searches every frame of a table played to
+showdowns and folds, by three players and a spectator, for anything else,
+and fails against the old server.
+
+The server plays the page's rules. A raise is always the street's step,
+whatever amount a client sends, and a player who resigns or leaves folds the
+hand and sits out every one after it while the rest play on.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0, as for the rest of this repository. See `LICENSE`
+and `NOTICE`.

magmacrunch_scandinavian_stud-0.1.0/README.md

@@ -0,0 +1,131 @@
+# Sökö (terminal)
+
+Sökö, Scandinavian stud poker, against the page's three computers, Mikko,
+Liisa and Jussi, in a terminal. It is the second version of the game, beside
+`web/`. It runs on the [magmacrunch](https://github.com/magmacrunch-media/magmacrunch)
+engine's terminal backend, either as a cabinet in the magmacrunch arcade or as
+its own command, and plays the same either way.
+
+```
+pipx install magmacrunch-scandinavian-stud
+soko                    # the title
+soko --play --seed 7    # straight to the table, the same shuffles every time
+soko --online           # PLAY ONLINE (needs the [online] extra)
+```
+
+PLAY ONLINE, a prototype, plays people instead, through the page's own
+server: `pipx install "magmacrunch-scandinavian-stud[online]"`.
+
+For working on it, from this folder, once the website's `shared/` is linked
+in beside `web/` (`node tools/link-shared.mjs` from the repository's root),
+which the oracle test needs:
+
+```
+pip install -e ".[dev]"
+python -m stud
+```
+
+## Keys
+
+| key | |
+|---|---|
+| `←` `→` | choose among the actions the page would offer |
+| `ENTER` | take it; at the end of a hand, deal the next |
+| `C` `R` `F` | check or call, raise, fold |
+| `N` | a new table |
+| `Esc` | the title (and from there, the arcade) |
+| `Q` | quit |
+
+The three computers sit above, you below. Your cards are all shown, your hole
+card first; theirs show their face-up cards and a `▓▓` for the hole card
+until a showdown. Each seat says its chips, its bet this round, and when it
+has folded or gone all-in; your hand is named as the page names it, Finnish
+and English. The labels are the page's own pairs: *Sekötä / check*, *Maksaa /
+call*, *Nostaa / raise*, *Luovuttaa / fold*. The computers keep the page's
+clock: one decides 0.8 seconds after its turn comes, and a finished round of
+betting deals the next street after 0.6.
+
+Win every chip the computers have and the table is yours, and it goes on
+the high-score table as the page scores it: your chips per hand it took,
+x100, so the faster the clear, the higher. A
+player with no chips sits every hand out after; when that is you, the table
+is lost and the next is a new one.
+
+Needs a 78x24 terminal.
+
+## It is the browser's game, and the browser's opponents
+
+`stud/rules.py` is `web/js/config.js`, `hand-eval.js` and `game.js`, with the
+deck and its shuffle from the website's `shared/adenosine-cards.js` and the
+turn-taking of `main.js`, function for function. The shuffle is the only
+random thing in the game: the computers decide by rule. Two tests hold the
+port to the page:
+
+- **`tests/test_oracle.py`.** `tools/js_oracle.mjs` loads those files
+  unmodified, with a seeded `Math.random`, and plays 40 tables of 80 hands
+  through `SokoGame`'s own API in `main.js`'s order: 3,200 hands, about 55,000
+  actions. Half have a random player in your seat, half a calling station. The
+  test shuffles the same decks through the port and requires the same state
+  after every action: every player's chips, cards, bet and hand, the pot, the
+  bet to match, the street, whose turn, the raises and who has acted, the
+  phase and the winner, and starts a new table where the page does. Moving
+  a style's mark, or dealing in a player with no chips again, fails it within
+  the first table.
+- **`tests/test_rules.py`.** It sets up by hand the cases worth pinning,
+  including the page's own rules below, so that fixing one shows as a change.
+
+## The page's rules
+
+The page's betting, side pots, ties and computers were fixed in
+scandinavian-stud#3, and the port with them. Two places where it is still not
+poker, kept because the oracle requires them:
+
+- **A tie is not split.** The pot goes to the tied player nearest the
+  dealer's left. Each pot is its own: an all-in player wins only the part
+  they matched, and the rest goes to the best hand among those who matched it.
+- **A conservative or moderate computer with nothing never calls.** High card
+  scores 0, under their call marks, so they check when they can and fold to
+  any bet. The aggressive one calls anything.
+
+## Online, a prototype
+
+PLAY ONLINE meets two to four people, in terminals or browsers, in a room on
+the arcade's own server, `web/server.py`, the one behind the page's
+Multiplayer button. One creates the room and says its four-letter code, the
+others join with it, and the host deals. `--server ws://host:8767` points at
+another server, a Pi on the same network say.
+
+The server keeps the game: it deals, says whose turn it is and what they may
+do, and sends the whole table after every action. `stud/online.py` keeps that
+latest table and sends the action chosen; `stud/online_scenes.py` draws it
+with the same table screen as the computers, you below and the others above
+in the server's order from you. Hand after hand anyone at the table deals the
+next with ENTER, until one player holds every chip.
+
+`tests/test_online.py` runs the real server in-process and plays real
+clients against it over real sockets. Three players take seeded random
+actions through a whole table to a table won, and after every
+action every client's table is the server's view for that player. Two terminal sessions also
+play a hand by keys. Making the client ignore the server's `hand_started`
+frames fails both. A terminal session has also played three hands against
+the page in Chromium through `web/server.py` run as the Pi runs it, the two
+agreeing on every chip.
+
+**Each player is sent only their own hole card.** The server builds the
+table again for each player as it sends a frame: their own hole card, and
+everyone's still in once a hand goes to a showdown; a hand won by a fold
+shows nobody's. A spectator sees what a player sees of the others. It used
+to send one frame to the whole room with every hole card and hand in it,
+which the page and this client drew face down but anyone reading the frames
+could see. `tests/test_online.py` searches every frame of a table played to
+showdowns and folds, by three players and a spectator, for anything else,
+and fails against the old server.
+
+The server plays the page's rules. A raise is always the street's step,
+whatever amount a client sends, and a player who resigns or leaves folds the
+hand and sits out every one after it while the rest play on.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0, as for the rest of this repository. See `LICENSE`
+and `NOTICE`.

magmacrunch_scandinavian_stud-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+# Prefixed like every other cabinet: PyPI cannot scope a family, so the prefix
+# claims it. The command is `soko`, the page's own name for the game; the
+# import package is `stud`.
+name = "magmacrunch-scandinavian-stud"
+version = "0.1.0"
+description = "Sökö, Scandinavian stud poker, against three computers. Terminal version."
+readme = "README.md"
+license = "PolyForm-Noncommercial-1.0.0"
+license-files = ["LICENSE", "NOTICE"]
+requires-python = ">=3.10"
+authors = [{ name = "magmacrunch media" }]
+keywords = ["arcade", "terminal", "tui", "games", "cards", "poker", "stud"]
+
+# The engine, with its terminal backend. stud/rules.py
+# imports neither and runs on a bare interpreter. 0.7.0 is where
+# magmacrunch.engine.ui.glyphs arrives, which run() imports.
+dependencies = ["magmacrunch>=0.15.0"]
+
+[project.optional-dependencies]
+# Only for PLAY ONLINE: the client imports websockets when it connects.
+online = ["websockets>=14.0"]
+# websockets for tests/test_online.py.
+dev = ["pytest>=7.0", "ruff>=0.6", "websockets>=14.0"]
+
+[project.scripts]
+soko = "stud.__main__:main"
+
+[project.entry-points."magmacrunch.games"]
+scandinavian-stud = "stud.arcade:GAME"
+
+[project.urls]
+Homepage = "https://magmacrunch.com/arcade/scandinavian-stud/"
+
+[tool.hatch.build.targets.wheel]
+packages = ["stud"]
+
+[tool.hatch.build.targets.sdist]
+exclude = ["tools"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

magmacrunch_scandinavian_stud-0.1.0/stud/__main__.py

@@ -0,0 +1,31 @@
+"""``python -m stud`` -- play Sökö, Scandinavian stud, against the computers or online."""
+
+from __future__ import annotations
+
+import argparse
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="soko", description="Sökö, Scandinavian stud poker.")
+    parser.add_argument("--play", action="store_true", help="skip the title screen")
+    parser.add_argument("--seed", type=int, default=None, help="the same shuffles every time")
+    parser.add_argument(
+        "--ascii", action="store_true", dest="ascii_only",
+        help="draw with plain ASCII instead of block and box glyphs. Detected "
+             "automatically from the terminal's encoding; this forces it. "
+             "MAGMACRUNCH_ASCII=1 says the same for every cabinet.",
+    )
+    parser.add_argument("--online", action="store_true",
+                        help="go straight to PLAY ONLINE (needs the [online] extra)")
+    parser.add_argument("--server", default=None,
+                        help="the multiplayer server for PLAY ONLINE, e.g. "
+                             "ws://192.168.1.16:8767 (default: the arcade's own)")
+    args = parser.parse_args()
+
+    from stud.app import run
+
+    run(args.seed, args.play, args.ascii_only, server=args.server, online=args.online)
+
+
+if __name__ == "__main__":
+    main()

magmacrunch_scandinavian_stud-0.1.0/stud/app.py

@@ -0,0 +1,106 @@
+"""Wiring -- what outlives one game, and how the screens reach it.
+
+Everything that draws lives in :mod:`stud.scenes`; everything that decides
+lives in :mod:`stud.rules`. **The terminal is not owned here**: it belongs
+to a ``TuiHost``, which is what lets this run as its own command or be seated
+by the arcade.
+"""
+
+from __future__ import annotations
+
+import random
+from typing import Any
+
+from magmacrunch.engine.scores import ScoreBook
+
+from stud.arcade import INFO
+from stud.scenes import GameScene, TitleScene
+
+
+class StudApp:
+    def __init__(self, host: Any, seed: int | None = None,
+                 scores: ScoreBook | None = None, server: str | None = None):
+        self.host = host
+        #: Where PLAY ONLINE connects; None for the arcade's public server.
+        self.server = server
+        #: Where each table's shuffles come from. Seeded, so ``--seed``
+        #: replays a whole session.
+        self.rng = random.Random(seed)
+        #: The board the browser posts to. The page saves only when you win
+        #: the table, your chips; so does this.
+        self.scores = scores or ScoreBook(INFO.scoreboard)
+        self.initials = "AAA"
+        self.last_rank: int | None = None
+        self.root_scene = TitleScene(self)
+
+    @property
+    def renderer(self):
+        return self.host.renderer
+
+    def new_rand(self):
+        return random.Random(self.rng.randrange(1 << 32)).random
+
+    def start_game(self) -> None:
+        self.host.push_scene(GameScene(self))
+
+    def play_online(self) -> None:
+        from stud.online import DEFAULT_SERVER
+        from stud.online_scenes import OnlineLobbyScene
+
+        self.host.push_scene(OnlineLobbyScene(self, self.server or DEFAULT_SERVER))
+
+    def show_scores(self) -> None:
+        from stud.scenes import ScoresScene
+
+        self.host.push_scene(ScoresScene(self))
+
+    def show_rules(self) -> None:
+        from stud.scenes import RulesScene
+
+        self.host.push_scene(RulesScene(self))
+
+    def enter_initials(self, score: int, extra: dict) -> None:
+        from stud.scenes import InitialsScene
+
+        self.host.push_scene(InitialsScene(self, score, extra))
+
+    def to_title(self) -> None:
+        self.host.pop_scene()
+
+    def leave(self) -> None:
+        self.host.pop_scene()
+
+    @property
+    def best(self) -> int:
+        return self.scores.best()
+
+    def qualifies(self, score: int) -> bool:
+        return score > 0 and self.scores.qualifies(score)
+
+    def record(self, score: int, initials: str | None = None,
+               extra: dict | None = None):
+        self.initials = initials or self.initials
+        result = self.scores.save(self.initials, score, **(extra or {}))
+        self.last_rank = result.rank
+        return result
+
+    @property
+    def scene(self):
+        return self.host.scene
+
+
+def run(seed: int | None = None, skip_title: bool = False,
+        ascii_only: bool = False, server: str | None = None, online: bool = False) -> None:
+    """Play Sökö as its own command."""
+    from magmacrunch.engine.core.tui_host import TuiHost
+    from magmacrunch.engine.ui.glyphs import Glyphs
+
+    host = TuiHost(title=INFO.title, fps=INFO.fps, hold_ms=INFO.hold_ms,
+                   glyphs=Glyphs.detect(ascii_only=ascii_only))
+    app = StudApp(host, seed, server=server)
+    host.push_scene(app.root_scene)
+    if online:
+        app.play_online()
+    elif skip_title:
+        host.push_scene(GameScene(app))
+    host.run()

magmacrunch_scandinavian_stud-0.1.0/stud/arcade.py

@@ -0,0 +1,39 @@
+"""What the arcade needs to know to launch this game. Kept tiny: a menu loads
+one of these per installed game just to draw a card."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from magmacrunch.engine.arcade import GameInfo
+
+from stud import theme
+
+INFO = GameInfo(
+    key="scandinavian-stud",
+    title="Sökö",
+    blurb="Scandinavian stud poker against three computers.",
+    # Turn-based: the frame rate paces the computers' bets and the cursor,
+    # nothing else. Edge input, so one arrow is one choice.
+    fps=20,
+    hold_ms=0,
+    min_cols=theme.MIN_COLS,
+    min_rows=theme.MIN_ROWS,
+    accent=theme.ACCENT,
+)
+
+
+class StudGame:
+    """Satisfies :class:`magmacrunch.engine.arcade.ArcadeGame`."""
+
+    info = INFO
+
+    def start(self, host: Any) -> Any:
+        from stud.app import StudApp
+
+        return StudApp(host).root_scene
+
+
+GAME = StudGame()
+
+__all__ = ["GAME", "INFO", "StudGame"]