magmacrunch 0.1.0__tar.gz

magmacrunch-0.1.0/.gitattributes

@@ -0,0 +1,10 @@
+# No eol pin for the tree at large: both this repo and its siblings normalise
+# to LF in the index, so what is committed is LF whatever a clone's
+# core.autocrlf does on disk.
+#
+# Pinned below are the files CRLF breaks outright on Linux rather than merely
+# making untidy: a trailing \r on a shebang gives "bad interpreter", and a
+# workflow's `run:` block is handed to a Linux shell verbatim.
+*.sh        text eol=lf
+*.yml       text eol=lf
+*.yaml      text eol=lf

magmacrunch-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+# The launcher's suite, run against fake cabinets on a GitHub-hosted runner.
+#
+# Deliberately installed WITHOUT the games it depends on. `ArcadeGame` is a
+# structural protocol, so the tests satisfy it with fakes — and a suite that
+# only passed when two unrelated packages happened to be installed would be a
+# worse suite. Running with nothing installed also exercises the empty-floor
+# case for free, and is what proves the launcher imports no game.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  # Lets CI be run against a branch without opening a pull request first.
+  workflow_dispatch:
+
+jobs:
+  tests:
+    name: tests (no cabinets)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # --no-deps because pyproject lists the cabinets, and installing them
+      # would defeat the point of the job.
+      - name: Install the launcher, without its cabinets
+        run: |
+          pip install "texastoast[tui]>=0.10.0" pytest ruff
+          pip install --no-deps -e .
+
+      - run: python -m pytest -q
+      - run: ruff check .
+
+      - name: An empty arcade still runs
+        run: magmacrunch --list

magmacrunch-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+# Publishes the launcher to PyPI as `magmacrunch`.
+#
+# One package built from the repo root, so the tag is a plain `v0.1.0` — the
+# games prefix theirs with `tui-` because their repos hold three versions and
+# a tag there has to say which one it releases. This repo holds one thing.
+#
+# Trusted Publishing: GitHub mints a short-lived identity token that PyPI
+# verifies against a publisher configured for this repo. No API token, no
+# repository secret, nothing to rotate. The publisher has to exist on PyPI
+# before the first run — for a project that does not exist yet that means a
+# "pending publisher" (pypi.org → Your account → Publishing), naming this
+# repository and this workflow file.
+#
+# Release this one LAST. It depends on both cabinets, so a `pip install
+# magmacrunch` before they are on PyPI is an unresolvable dependency.
+
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # A tag that disagrees with the packaged version publishes something
+      # nobody can find again. Cheaper to fail here than to yank a release.
+      - name: Verify the tag matches the package version
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG=$(python -c "import tomllib,pathlib; print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
+          if [ "$TAG" != "$PKG" ]; then
+            echo "Tag $TAG does not match pyproject version $PKG"
+            exit 1
+          fi
+
+      # Deliberately installed WITHOUT its game dependencies. The suite runs
+      # against fake cabinets, and an arcade with nothing installed is a case
+      # it has to handle anyway — so this doubles as proof that the launcher
+      # imports no game, which is the rule the whole design rests on.
+      - name: Test, with no cabinets on the machine
+        run: |
+          pip install "texastoast[tui]>=0.10.0" pytest ruff
+          pip install --no-deps -e .
+          python -m pytest -q
+          ruff check .
+
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+      - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create ${{ github.ref_name }} --generate-notes

magmacrunch-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.venv/
+venv/
+dist/
+build/

magmacrunch-0.1.0/AGENTS.md

@@ -0,0 +1,56 @@
+# magmacrunch — agent brief
+
+The terminal arcade: the `magmacrunch` command, a menu of every installed
+cabinet, and the wiring that seats one on the terminal it is already holding.
+
+The engine is [texastoast](https://pypi.org/project/texastoast/) and its `[tui]`
+backend. `texastoast.arcade` defines the seam this consumes — `GameInfo`,
+`Host`, `ArcadeGame`, `discover` — and `texastoast.core.tui_host.TuiHost` is the
+host that owns the terminal. Neither is reimplemented here.
+
+## AI Attribution
+
+**No AI attribution.** Do not append `Co-Authored-By: Claude …`, "Generated with
+…", or any similar trailer to commit messages, PR bodies, or release notes. If
+your tooling adds such a line by default, remove it before committing.
+
+## Games are never vendored here, and this package imports none of them
+
+Each game lives in its own repo with its `web/`, `wii/` and `tui/` versions
+together, and publishes its own wheel built from `tui/`. This repo holds the
+launcher and nothing else.
+
+The relationship runs in two directions that must not be confused:
+
+- **Distribution:** `pyproject.toml` lists the games as dependencies, so
+  `pip install magmacrunch` installs an arcade with cabinets in it.
+- **Runtime:** games are found by enumerating the `magmacrunch.games` entry
+  point group. `magmacrunch` never imports `boole`, `lavadome`, or any other
+  game module.
+
+There is therefore no import edge in either direction, which is what makes an
+arcade with its games uninstalled a working program that says the floor is
+empty rather than an `ImportError`. `tests/test_cabinet.py` guards this.
+
+It is also what lets a game published later appear in the menu without a
+`magmacrunch` release — install it and it is there, uninstall it and it is gone.
+
+## Adding a cabinet
+
+Nothing changes here except the dependency list. A game declares:
+
+```toml
+[project.entry-points."magmacrunch.games"]
+george-boole = "boole.arcade:GAME"
+```
+
+pointing at an object with `info: GameInfo` and `start(host) -> scene`. See
+`texastoast.arcade` for the contract and `george-boole/tui/boole/arcade.py` for
+a worked example. `magmacrunch --list` says what was found and why anything was
+skipped.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0, because it depends on Noncommercial games. The
+engine underneath stays Apache-2.0; a permissive dependency under a restrictive
+package is fine, the reverse would not be.

magmacrunch-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-0.1.0/NOTICE

@@ -0,0 +1,33 @@
+magmacrunch — the terminal arcade
+Copyright 2026 magmacrunch media
+
+
+THE LICENCE
+
+Everything in this repository -- the launcher, the tests, the build files 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 it or a derivative of it, shipping it
+inside a product, or running it as part of a business.
+
+It is Noncommercial because the games it seats are. This package contains no
+game code -- it finds installed games by entry point and never imports one --
+but it depends on them, and a package cannot be more permissive than what it
+depends on.
+
+
+WHAT THIS DEPENDS ON
+
+texastoast, the engine, with its terminal backend. Apache License 2.0,
+copyright 2026 magmacrunch media. https://pypi.org/project/texastoast/
+
+texastoast's terminal backend depends in turn on Textual, and through it on
+Rich (MIT, copyright Will McGugan). Both carry their own licences in the
+installed distributions.
+
+The cabinets -- magmacrunch-george-boole, magmacrunch-thld -- are each
+PolyForm Noncommercial 1.0.0, copyright 2026 magmacrunch media, and carry
+their own NOTICE files.

magmacrunch-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.5
+Name: magmacrunch
+Version: 0.1.0
+Summary: The magmacrunch terminal arcade - a menu of every installed cabinet
+Project-URL: Homepage, https://magmacrunch.com/arcade/
+Author: magmacrunch media
+License-Expression: PolyForm-Noncommercial-1.0.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: arcade,games,launcher,terminal,tui
+Requires-Python: >=3.10
+Requires-Dist: magmacrunch-george-boole>=0.1.0
+Requires-Dist: magmacrunch-moonlight-drift>=0.1.0
+Requires-Dist: magmacrunch-thld>=0.1.0
+Requires-Dist: texastoast[tui]>=0.10.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# magmacrunch
+
+The terminal arcade. One command, a menu of every cabinet installed on the
+machine, and a way into one.
+
+```
+pip install magmacrunch
+magmacrunch
+```
+
+```
+                                                             __
+ .--------.---.-.-----.--------.---.-.----.----.--.--.-----.----.|  |--.
+ |        |  _  |  _  |        |  _  |  __|   _|  |  |     |  __||     |
+ |__|__|__|___._|___  |__|__|__|___._|____|__| |_____|__|__|____||__|__|
+                |_____|
+                   EVERY CABINET ON THIS MACHINE
+                            INSERT COIN
+
+
+┌──────────────────────────────┐  ┌──────────────────────────────┐
+│ George Boole Has Entered The │  │ Texas Hold'Em Lava Dome      │
+│ Chat                         │  │                              │
+│                              │  │ Solo hold'em against a       │
+│ 2048 played with logic gates │  │ threshold that climbs every  │
+│ — merge, invert, overflow.   │  │ round.                       │
+│                              │  │                              │
+│ ▶ ENTER_                     │  │ ▶ ENTER                      │
+└──────────────────────────────┘  └──────────────────────────────┘
+
+                ↑↓←→ CHOOSE    ENTER PLAY    Q QUIT
+           © 2026 magmacrunch media  ·  magmacrunch.com
+```
+
+It is `magmacrunch.com/arcade` in a shell — the same palette, the same card
+grid, the same blinking cursor on the card you are about to start. The one
+thing that could not come across is the typography: `arcade.css` sets
+`Press Start 2P` on nearly every string, and a terminal program does not
+choose its font. Pixel lettering has to be *drawn*, out of block glyphs, which
+is what the narrow title variant does — and what the web page's own title art
+does too, in Courier Prime rather than Press Start 2P, for the same reason.
+
+The title art stands down as the window grows or shrinks, and always before
+the cabinets have to — which is what keeps the floor as low as it is:
+
+| window | banner |
+|---|---|
+| 121×34 and up | the full site wordmark, MAGMACRUNCH over ARCADE, 119×19 |
+| ~73×30 | the same two words in 71 columns instead of 119 |
+| **80×24** | **MAGMACRUNCH alone, 71×5** |
+| ~62–72 cols | the ARCADE wordmark alone, 60×8 |
+| ~50 cols | a block-glyph MAGMACRUNCH, 48×2 |
+| 36 cols | spaced capitals |
+
+Art is measured rather than declared, so the 119-column piece can sit at the
+top of the list without ever bothering someone on an ordinary terminal — it
+is simply never the one that fits. Adding your own is one entry in `VARIANTS`
+in [`banner.py`](magmacrunch/banner.py) and nothing else.
+
+Choosing a cabinet starts it on the terminal the arcade is already holding.
+Leaving the game brings you back here. Every game is also its own command
+(`george-boole`, `lava-dome`, `moonlight-drift`) and plays identically either way — the arcade is
+not a wrapper around them, it is the same host they run on.
+
+## What is installed
+
+```
+magmacrunch --list
+```
+
+Prints every cabinet found, what terminal size it wants, and how it wants
+input. If a game you installed is not in the menu, this says why — a game that
+fails to load is reported rather than silently skipped.
+
+## How games get here
+
+Games are **not** bundled. Each one lives in its own repo alongside its browser
+and Wii versions, publishes its own wheel, and declares an entry point:
+
+```toml
+[project.entry-points."magmacrunch.games"]
+george-boole = "boole.arcade:GAME"
+```
+
+pointing at an object with `info: GameInfo` and `start(host) -> scene`. The
+launcher enumerates that group at startup. **Installing a game makes it appear
+here; uninstalling makes it vanish; neither needs a release of the arcade.**
+
+Nothing in this package imports a game, so the arcade runs with none installed
+and tells you how to get one. The contract lives in
+[`texastoast.arcade`](https://pypi.org/project/texastoast/); the two cabinets
+above are worked examples of it.
+
+## Cabinets
+
+| | |
+|---|---|
+| `magmacrunch-george-boole` | 2048 played with logic gates |
+| `magmacrunch-thld` | Solo hold'em against a climbing threshold |
+| `magmacrunch-moonlight-drift` | Thread the columns; hold to climb |
+
+Installing `magmacrunch` installs all three.
+
+## Requires
+
+Python 3.10+, and a terminal at least 36×17. Individual cabinets ask for more
+(around 59×22); below that their card greys out, says the size it wants, and
+cannot be started. The arcade's own floor is deliberately lower than any
+game's, so getting to the floor is never the thing that fails.
+
+Two cards sit side by side from 70 columns and stack into one below that. More
+cabinets than fit are paged, not scrolled.
+
+Truecolor helps but is not required.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
+Noncommercial because the games it seats are. The engine underneath,
+[texastoast](https://pypi.org/project/texastoast/), stays Apache-2.0.

magmacrunch-0.1.0/README.md

@@ -0,0 +1,120 @@
+# magmacrunch
+
+The terminal arcade. One command, a menu of every cabinet installed on the
+machine, and a way into one.
+
+```
+pip install magmacrunch
+magmacrunch
+```
+
+```
+                                                             __
+ .--------.---.-.-----.--------.---.-.----.----.--.--.-----.----.|  |--.
+ |        |  _  |  _  |        |  _  |  __|   _|  |  |     |  __||     |
+ |__|__|__|___._|___  |__|__|__|___._|____|__| |_____|__|__|____||__|__|
+                |_____|
+                   EVERY CABINET ON THIS MACHINE
+                            INSERT COIN
+
+
+┌──────────────────────────────┐  ┌──────────────────────────────┐
+│ George Boole Has Entered The │  │ Texas Hold'Em Lava Dome      │
+│ Chat                         │  │                              │
+│                              │  │ Solo hold'em against a       │
+│ 2048 played with logic gates │  │ threshold that climbs every  │
+│ — merge, invert, overflow.   │  │ round.                       │
+│                              │  │                              │
+│ ▶ ENTER_                     │  │ ▶ ENTER                      │
+└──────────────────────────────┘  └──────────────────────────────┘
+
+                ↑↓←→ CHOOSE    ENTER PLAY    Q QUIT
+           © 2026 magmacrunch media  ·  magmacrunch.com
+```
+
+It is `magmacrunch.com/arcade` in a shell — the same palette, the same card
+grid, the same blinking cursor on the card you are about to start. The one
+thing that could not come across is the typography: `arcade.css` sets
+`Press Start 2P` on nearly every string, and a terminal program does not
+choose its font. Pixel lettering has to be *drawn*, out of block glyphs, which
+is what the narrow title variant does — and what the web page's own title art
+does too, in Courier Prime rather than Press Start 2P, for the same reason.
+
+The title art stands down as the window grows or shrinks, and always before
+the cabinets have to — which is what keeps the floor as low as it is:
+
+| window | banner |
+|---|---|
+| 121×34 and up | the full site wordmark, MAGMACRUNCH over ARCADE, 119×19 |
+| ~73×30 | the same two words in 71 columns instead of 119 |
+| **80×24** | **MAGMACRUNCH alone, 71×5** |
+| ~62–72 cols | the ARCADE wordmark alone, 60×8 |
+| ~50 cols | a block-glyph MAGMACRUNCH, 48×2 |
+| 36 cols | spaced capitals |
+
+Art is measured rather than declared, so the 119-column piece can sit at the
+top of the list without ever bothering someone on an ordinary terminal — it
+is simply never the one that fits. Adding your own is one entry in `VARIANTS`
+in [`banner.py`](magmacrunch/banner.py) and nothing else.
+
+Choosing a cabinet starts it on the terminal the arcade is already holding.
+Leaving the game brings you back here. Every game is also its own command
+(`george-boole`, `lava-dome`, `moonlight-drift`) and plays identically either way — the arcade is
+not a wrapper around them, it is the same host they run on.
+
+## What is installed
+
+```
+magmacrunch --list
+```
+
+Prints every cabinet found, what terminal size it wants, and how it wants
+input. If a game you installed is not in the menu, this says why — a game that
+fails to load is reported rather than silently skipped.
+
+## How games get here
+
+Games are **not** bundled. Each one lives in its own repo alongside its browser
+and Wii versions, publishes its own wheel, and declares an entry point:
+
+```toml
+[project.entry-points."magmacrunch.games"]
+george-boole = "boole.arcade:GAME"
+```
+
+pointing at an object with `info: GameInfo` and `start(host) -> scene`. The
+launcher enumerates that group at startup. **Installing a game makes it appear
+here; uninstalling makes it vanish; neither needs a release of the arcade.**
+
+Nothing in this package imports a game, so the arcade runs with none installed
+and tells you how to get one. The contract lives in
+[`texastoast.arcade`](https://pypi.org/project/texastoast/); the two cabinets
+above are worked examples of it.
+
+## Cabinets
+
+| | |
+|---|---|
+| `magmacrunch-george-boole` | 2048 played with logic gates |
+| `magmacrunch-thld` | Solo hold'em against a climbing threshold |
+| `magmacrunch-moonlight-drift` | Thread the columns; hold to climb |
+
+Installing `magmacrunch` installs all three.
+
+## Requires
+
+Python 3.10+, and a terminal at least 36×17. Individual cabinets ask for more
+(around 59×22); below that their card greys out, says the size it wants, and
+cannot be started. The arcade's own floor is deliberately lower than any
+game's, so getting to the floor is never the thing that fails.
+
+Two cards sit side by side from 70 columns and stack into one below that. More
+cabinets than fit are paged, not scrolled.
+
+Truecolor helps but is not required.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
+Noncommercial because the games it seats are. The engine underneath,
+[texastoast](https://pypi.org/project/texastoast/), stays Apache-2.0.

magmacrunch-0.1.0/magmacrunch/__init__.py

@@ -0,0 +1,20 @@
+"""The magmacrunch terminal arcade.
+
+A menu of every installed cabinet, and the wiring that seats one on the
+terminal it is already holding.
+
+Games are found by enumerating the ``magmacrunch.games`` entry point group -
+see :mod:`texastoast.arcade` for the contract. **Nothing in this package
+imports a game.** Installing one makes it appear here; uninstalling makes it
+vanish; neither needs a release of the arcade.
+
+Imports are kept out of this module so that ``import magmacrunch`` costs
+nothing: the launcher's own screens pull in the engine's terminal backend, and
+``magmacrunch --help`` should not pay for it.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]