motioninput-tui 0.1.0__tar.gz

motioninput_tui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kieran Gee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

motioninput_tui-0.1.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: motioninput-tui
+Version: 0.1.0
+Summary: A terminal trainer for fighting game motion inputs, tuned per game.
+Author: Kieran Gee
+Author-email: Kieran Gee <kieran.lost.the.game@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment
+Requires-Dist: rich>=15.0.0
+Requires-Dist: textual>=8.2.8
+Requires-Dist: pygame-ce>=2.5.8
+Requires-Python: >=3.14.0, <4
+Project-URL: Repository, https://github.com/kism/motioninput-tui
+Project-URL: Documentation, https://motioninput-tui.readthedocs.io/
+Description-Content-Type: text/markdown
+
+# motioninput-tui
+
+[![Check](https://github.com/kism/motioninput-tui/actions/workflows/check.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/check.yml)
+[![CheckType](https://github.com/kism/motioninput-tui/actions/workflows/check_types.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/check_types.yml)
+[![Test](https://github.com/kism/motioninput-tui/actions/workflows/test.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/kism/motioninput-tui/graph/badge.svg?token=FPGDA0ODT7)](https://codecov.io/gh/kism/motioninput-tui)
+[![Docs](https://readthedocs.org/projects/motioninput-tui/badge/?version=latest)](https://motioninput-tui.readthedocs.io/en/latest/?badge=latest)
+
+A terminal trainer for fighting game motion inputs. Pick a game and a
+character, press inputs, and see which move the game would have given you.
+The input handling has been tuned per game: hold down and
+double tap forward in 3rd Strike and you get a dragon punch; do it in Super
+Turbo or Alpha 3 and you get nothing.
+
+Ships with Hyper Street Fighter II, Street Fighter Alpha 3, 3rd Strike, The
+King of Fighters '98 and 2001, and Samurai Shodown V Special.
+
+**Full documentation: <https://motioninput-tui.readthedocs.io/>**
+
+## Install and run
+
+```bash
+uv sync --all-groups   # omit --all-groups for a plain install
+uv run motioninput-tui
+```
+
+See the docs for the full command line reference, controls, settings and move
+notation.
+
+## Technical Information and AI Disclaimr
+
+### How it's created
+
+This is my first AI-heavy project, the workflow is
+
+- Get claude to add a game based on a gamefaqs guide
+  - sha256 of original guide is verified to avoid possibility of claude editing the reference data
+  - skill to make a briefing of each guide, each brief gets made in the game-brief skill
+  - claude writes a parser for each guide
+    - The moves from the guide are parsed with hard logic, not interpereted by claude
+    - The game logic is interpreted by claude based on the guide
+
+- The game engine has many control layouts and motion inputs that are applied per game
+
+### How I ensure code quality
+
+For each numberd release I do the following
+
+- Manually read all the changed code from the previous release
+
+- In this register of games/characters I personally test and re-verify
+  - This is not frame perfect, I just open 3SX/Mame/whatever and see if it feels the same.
+  - The tests that claude writes will reflect these, but absolutely needs to be checked by a human
+
+- Register (this will later be a separate file)
+  - SFA3
+    - Ken
+      - Shouryuu Ken feels too strict
+    - Sakura
+      - Shou'ou Ken feels too strict
+      - Sakura Otoshi punch timing is relaxed?
+  - SFIII
+    - Ken
+    - Elana
+    - Hugo
+      - I can't do Gigas Breaker
+  - USFIV
+    - Ken
+    - Sakura
+      - Sakura Otoshi timing is relaxed
+  - KOF2001
+    - Yuri Sakazaki
+
+## Contributing
+
+- [Adding a game](https://motioninput-tui.readthedocs.io/en/latest/adding-a-game.html)
+- [Development setup](https://motioninput-tui.readthedocs.io/en/latest/development.html)
+
+## Credit
+
+Move list guides by:
+
+- [Kao Megura / Chris MacDonald](https://gamefaqs.gamespot.com/community/Kao_Megura/contributions/faqs) [Rest In Peace](https://web.archive.org/web/20040520095719/http://cgfm2.emuviews.com/).
+- x_MJ_x (Hyper Street Fighter II)
+- THEMCD / Damon M. McDaniel (Ultimate Street Fighter IV)

motioninput_tui-0.1.0/README.md

@@ -0,0 +1,85 @@
+# motioninput-tui
+
+[![Check](https://github.com/kism/motioninput-tui/actions/workflows/check.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/check.yml)
+[![CheckType](https://github.com/kism/motioninput-tui/actions/workflows/check_types.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/check_types.yml)
+[![Test](https://github.com/kism/motioninput-tui/actions/workflows/test.yml/badge.svg)](https://github.com/kism/motioninput-tui/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/kism/motioninput-tui/graph/badge.svg?token=FPGDA0ODT7)](https://codecov.io/gh/kism/motioninput-tui)
+[![Docs](https://readthedocs.org/projects/motioninput-tui/badge/?version=latest)](https://motioninput-tui.readthedocs.io/en/latest/?badge=latest)
+
+A terminal trainer for fighting game motion inputs. Pick a game and a
+character, press inputs, and see which move the game would have given you.
+The input handling has been tuned per game: hold down and
+double tap forward in 3rd Strike and you get a dragon punch; do it in Super
+Turbo or Alpha 3 and you get nothing.
+
+Ships with Hyper Street Fighter II, Street Fighter Alpha 3, 3rd Strike, The
+King of Fighters '98 and 2001, and Samurai Shodown V Special.
+
+**Full documentation: <https://motioninput-tui.readthedocs.io/>**
+
+## Install and run
+
+```bash
+uv sync --all-groups   # omit --all-groups for a plain install
+uv run motioninput-tui
+```
+
+See the docs for the full command line reference, controls, settings and move
+notation.
+
+## Technical Information and AI Disclaimr
+
+### How it's created
+
+This is my first AI-heavy project, the workflow is
+
+- Get claude to add a game based on a gamefaqs guide
+  - sha256 of original guide is verified to avoid possibility of claude editing the reference data
+  - skill to make a briefing of each guide, each brief gets made in the game-brief skill
+  - claude writes a parser for each guide
+    - The moves from the guide are parsed with hard logic, not interpereted by claude
+    - The game logic is interpreted by claude based on the guide
+
+- The game engine has many control layouts and motion inputs that are applied per game
+
+### How I ensure code quality
+
+For each numberd release I do the following
+
+- Manually read all the changed code from the previous release
+
+- In this register of games/characters I personally test and re-verify
+  - This is not frame perfect, I just open 3SX/Mame/whatever and see if it feels the same.
+  - The tests that claude writes will reflect these, but absolutely needs to be checked by a human
+
+- Register (this will later be a separate file)
+  - SFA3
+    - Ken
+      - Shouryuu Ken feels too strict
+    - Sakura
+      - Shou'ou Ken feels too strict
+      - Sakura Otoshi punch timing is relaxed?
+  - SFIII
+    - Ken
+    - Elana
+    - Hugo
+      - I can't do Gigas Breaker
+  - USFIV
+    - Ken
+    - Sakura
+      - Sakura Otoshi timing is relaxed
+  - KOF2001
+    - Yuri Sakazaki
+
+## Contributing
+
+- [Adding a game](https://motioninput-tui.readthedocs.io/en/latest/adding-a-game.html)
+- [Development setup](https://motioninput-tui.readthedocs.io/en/latest/development.html)
+
+## Credit
+
+Move list guides by:
+
+- [Kao Megura / Chris MacDonald](https://gamefaqs.gamespot.com/community/Kao_Megura/contributions/faqs) [Rest In Peace](https://web.archive.org/web/20040520095719/http://cgfm2.emuviews.com/).
+- x_MJ_x (Hyper Street Fighter II)
+- THEMCD / Damon M. McDaniel (Ultimate Street Fighter IV)

motioninput_tui-0.1.0/pyproject.toml

@@ -0,0 +1,134 @@
+[project]
+name = "motioninput-tui"
+version = "0.1.0"
+description = "A terminal trainer for fighting game motion inputs, tuned per game."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14.0,<4"
+dependencies = [
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+    "pygame-ce>=2.5.8",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Games/Entertainment",
+]
+
+[[project.authors]]
+name = "Kieran Gee"
+email = "kieran.lost.the.game@gmail.com"
+
+[project.urls]
+Repository = "https://github.com/kism/motioninput-tui"
+Documentation = "https://motioninput-tui.readthedocs.io/"
+
+[project.scripts]
+motioninput-tui = "motioninput_tui.__main__:main"
+motioninput-tui-probe = "motioninput_tui.gamepad_probe:main"
+
+[dependency-groups]
+type = ["ty>=0.0.69"]
+lint = ["ruff>=0.16.2"]
+test = [
+    "pytest>=9.1.1",
+    "coverage>=7.15.4",
+]
+docs = [
+    "sphinx>=8.1.0",
+    "myst-parser>=4.0.0",
+    "sphinx-rtd-theme>=3.0.0",
+]
+guides = [
+    "curl-cffi>=0.7.0",
+    "beautifulsoup4>=4.12.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+cache-dir = "~/.cache/ruff"
+line-length = 120
+
+[tool.ruff.lint]
+preview = true
+select = ["ALL"]
+ignore = [
+    "DJ",
+    "AIR",
+    "FAST",
+    "DTZ",
+    "missing-todo-author",
+    "missing-todo-link",
+    "single-line-implicit-string-concatenation",
+    "missing-trailing-comma",
+    "D",
+    "DOC",
+    "missing-copyright-notice",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = [
+    "ARG",
+    "FBT",
+    "ANN",
+    "D",
+    "DOC",
+    "TC",
+    "no-self-use",
+    "assert",
+    "private-member-access",
+    "implicit-namespace-package",
+    "pytest-missing-fixture-name-underscore",
+    "suspicious-non-cryptographic-random-usage",
+    "hardcoded-password-string",
+    "too-many-arguments",
+    "blind-except",
+    "suspicious-non-cryptographic-random-usage",
+    "import-private-name",
+]
+"tests/test_notation_styles.py" = ["ambiguous-unicode-character-string"]
+"src/motioninput_tui/notation_styles.py" = ["ambiguous-unicode-character-string"]
+"scripts/*.py" = [
+    "print",
+    "implicit-namespace-package",
+]
+".claude/skills/**/*.py" = [
+    "print",
+    "implicit-namespace-package",
+]
+"docs/conf.py" = ["implicit-namespace-package"]
+
+[tool.ruff.lint.flake8-pytest-style]
+fixture-parentheses = false
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+docstring-code-line-length = 40
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+command_line = ".venv/bin/pytest -q"
+source = ["motioninput_tui"]
+context = "test"
+
+[tool.coverage.report]
+show_missing = false
+format = "text"
+sort = "-Miss"
+
+[tool.coverage.html]
+show_contexts = true

motioninput_tui-0.1.0/pyproject.toml.orig

@@ -0,0 +1,142 @@
+[project]
+name = "motioninput-tui"
+version = "0.1.0"
+description = "A terminal trainer for fighting game motion inputs, tuned per game."
+authors = [{ name = "Kieran Gee", email = "kieran.lost.the.game@gmail.com" }]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14.0,<4"
+dependencies = [
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+    "pygame-ce>=2.5.8",  # Gamepad support, imported only when the gamepad layout is selected.
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Games/Entertainment",
+]
+
+[dependency-groups]
+# Development only; none of these are published as PyPI extras.
+type = ["ty>=0.0.69"]
+lint = ["ruff>=0.16.2"]
+test = ["pytest>=9.1.1", "coverage>=7.15.4"]
+
+# Building the docs/ site. Never imported by the trainer itself.
+docs = ["sphinx>=8.1.0", "myst-parser>=4.0.0", "sphinx-rtd-theme>=3.0.0"]
+
+# Only for fetching reference guides, never imported by the trainer itself.
+guides = ["curl-cffi>=0.7.0", "beautifulsoup4>=4.12.0"]
+
+[project.urls]
+Repository = "https://github.com/kism/motioninput-tui"
+Documentation = "https://motioninput-tui.readthedocs.io/"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"
+
+[project.scripts]
+motioninput-tui = "motioninput_tui.__main__:main"
+motioninput-tui-probe = "motioninput_tui.gamepad_probe:main"
+
+[tool.ruff]
+cache-dir = "~/.cache/ruff"
+line-length = 120
+
+[tool.ruff.lint]
+preview = true # Optional, these can be unstable, many of these rules exist.
+select = ["ALL"] # Include absolutely all of Ruff's rules.
+ignore = [
+    # Modules
+    "DJ",   # Django not required
+    "AIR",  # Airflow not required
+    "FAST", # FastAPI not required
+    "DTZ",  # no need to specify timezone for time objects
+
+    # Specific rules
+    "missing-todo-author",  # Verbose TODO, only I work on this project
+    "missing-todo-link",  # Verbose TODO, only I work on this project
+    "single-line-implicit-string-concatenation", # conflict in the formatter
+    "missing-trailing-comma", # conflict in the formatter
+    "D",      # Don't care about docstrings
+    "DOC",    # Don't care about docstrings
+    "missing-copyright-notice", # Copyright lives in pyproject.toml
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = [
+    # Modules
+    "ARG", # Unused function args -> fixtures nevertheless are functionally relevant
+    "FBT", # Don't care about booleans as positional arguments in tests, e.g. via @pytest.mark.parametrize()
+    "ANN", # Don't care about annotations in tests
+    "D",   # Don't care about docstrings in tests
+    "DOC", # Don't care about docstrings in tests
+    "TC",  # Test doubles are used at runtime; no need to guard their imports
+
+    # Specific rules
+    "no-self-use", # Test doubles mirror a real API, even when a method ignores self
+    "assert",    # asserts allowed in tests.
+    "private-member-access",  # Accessing private members is needed for testing.
+    "implicit-namespace-package",  # __init__.py not needed for PyTest.
+    "pytest-missing-fixture-name-underscore",   # monkeypatch doesn't return.
+    "suspicious-non-cryptographic-random-usage",    # I'll assume no real crypto will be done in PyTest.
+    "hardcoded-password-string",    # Hardcoded fake passwords are fine in tests.
+    "too-many-arguments", # Tests can have as many arguments as they want.
+    "blind-except",  # Tests can use BaseException.
+    "suspicious-non-cryptographic-random-usage",    # Regular RNG is fine in tests.
+    "import-private-name", # Tests can import private members.
+]
+"tests/test_notation_styles.py" = [
+    "ambiguous-unicode-character-string",  # The glyphs are what it is testing.
+]
+"src/motioninput_tui/notation_styles.py" = [
+    # A module of glyphs to pick between: ⋃ really is meant to be a cup, not a U,
+    # and ×2 is the multiplication sign the guides use.
+    "ambiguous-unicode-character-string",
+]
+"scripts/*.py" = [
+    "print",  # Command line tools; printing is how they report.
+    "implicit-namespace-package",  # Standalone scripts, not a package.
+]
+".claude/skills/**/*.py" = [
+    "print",  # Skill scripts are command line tools; printing is how they report.
+    "implicit-namespace-package",  # Standalone scripts, not a package.
+]
+"docs/conf.py" = [
+    "implicit-namespace-package",  # Sphinx config, not part of the motioninput_tui package.
+]
+
+
+[tool.ruff.lint.flake8-pytest-style]
+fixture-parentheses = false
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+docstring-code-line-length = 40
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+command_line = ".venv/bin/pytest -q"
+source = ["motioninput_tui"]
+context = "test"
+
+[tool.coverage.report]
+show_missing = false
+format = "text"
+sort = "-Miss"
+
+[tool.coverage.html]
+show_contexts = true

motioninput_tui-0.1.0/src/motioninput_tui/__init__.py

@@ -0,0 +1,9 @@
+"""Python App motioninput-tui."""
+
+from .constants import PROGRAM_NAME, PROGRAM_REPO_URL, PROGRAM_VERSION
+
+__all__ = [
+    "PROGRAM_NAME",
+    "PROGRAM_REPO_URL",
+    "PROGRAM_VERSION",
+]

motioninput_tui-0.1.0/src/motioninput_tui/__main__.py

@@ -0,0 +1,179 @@
+"""Main entrypoint."""
+
+import argparse
+import sys
+from pathlib import Path
+
+from rich import traceback
+
+from .config import Config, config_path
+from .constants import PROGRAM_NAME, PROGRAM_NAME_WITH_FULL_VERSION, PROGRAM_NAME_WITH_VERSION
+from .controls.layouts import DEFAULT_LAYOUT, available_layouts
+from .engine.recognizer import BufferPolicy
+from .games.loader import GameDataMissingError, available_games, load_game
+from .games.rulesets import GAME_SPECS
+from .terminal import detect, query_support
+from .utils.logger import get_logger, setup_logger_cli
+
+traceback.install(extra_lines=2)
+logger = get_logger(__name__)
+
+
+def _get_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(prog=PROGRAM_NAME, description="Fighting game motion input trainer.")
+    parser.add_argument("--game", choices=sorted(GAME_SPECS), help="Skip the game picker.")
+    parser.add_argument("--character", help="Skip the character picker. Needs --game.")
+    parser.add_argument(
+        "--layout",
+        choices=sorted(layout.key for layout in available_layouts()),
+        default=None,
+        help=f"Control layout (default: last used, or {DEFAULT_LAYOUT}).",
+    )
+    parser.add_argument(
+        "--no-key-release",
+        action="store_true",
+        help="Do not ask the terminal for key release reporting; infer holds from auto-repeat instead.",
+    )
+    parser.add_argument(
+        "--loose-buffer",
+        action=argparse.BooleanOptionalAction,
+        default=None,
+        help="Do not spend inputs when a move comes out, so one motion can feed several moves. "
+        "Not how the games behave; it is also in the trainer's settings, ctrl+b. Default: last used.",
+    )
+    parser.add_argument(
+        "--config",
+        type=Path,
+        default=None,
+        help=f"Config file holding the last used selection (default: {config_path()}).",
+    )
+    parser.add_argument("--list", action="store_true", help="List games and characters, then exit.")
+    parser.add_argument("--check-terminal", action="store_true", help="Report terminal suitability, then exit.")
+    parser.add_argument("--version", action="version", version=PROGRAM_NAME_WITH_FULL_VERSION)
+    parser.add_argument("-v", action="count", default=0, help="Increase verbosity (can be used multiple times).")
+    return parser.parse_args()
+
+
+def _print_terminal() -> int:
+    info = detect()
+    logger.info("Terminal: %s (%s, %s)", info.name, info.speed, info.detail)
+    if info.warning():
+        logger.warning("%s", info.warning())
+    else:
+        logger.info("Should be fast enough for accurate input timing.")
+
+    releases = query_support()
+    if releases is None:
+        logger.info("Key releases: could not ask, no terminal attached.")
+    elif releases:
+        logger.info("Key releases: supported. Holds will be tracked exactly.")
+    else:
+        logger.warning(
+            "Key releases: not supported. Holds will be inferred from auto-repeat, "
+            "so charge moves depend on your keyboard repeat delay. "
+            "Terminals that do support this: Ghostty, Alacritty, WezTerm, kitty, foot, Contour, Rio."
+        )
+    return 0
+
+
+def _print_roster() -> int:
+    for game in available_games():
+        logger.info("%s - %s", game.key, game.name)
+        for character in game.characters:
+            # The input display's "characters" are button sets, with no moves
+            # to count, so they say what they are instead.
+            if character.moves:
+                logger.info("    %-22s %d trainable moves", character.key, len(character.trainable_moves))
+            else:
+                logger.info("    %-22s %s", character.key, character.name)
+    return 0
+
+
+def main() -> int:
+    """Main entrypoint."""
+    args = _get_args()
+    setup_logger_cli(args.v)
+    logger.debug("%s", PROGRAM_NAME_WITH_VERSION)
+
+    if args.check_terminal:
+        return _print_terminal()
+    if args.list:
+        return _print_roster()
+
+    if args.character and not args.game:
+        logger.error("--character needs --game as well")
+        return 2
+
+    config = Config.load(args.config)
+    _apply_overrides(config, args)
+
+    if not _resolve_selection(config, from_cli=bool(args.character)):
+        return 1
+
+    info = detect()
+    if info.should_warn:
+        logger.warning("%s", info.warning())
+
+    # Ask before the interface takes over the terminal, so holds are tracked
+    # exactly from the very first keystroke rather than from the first release.
+    key_release = False if args.no_key_release else bool(query_support())
+    if key_release:
+        logger.debug("Terminal reports key releases; holds will be tracked exactly")
+    else:
+        logger.info("Terminal does not report key releases; holds will be inferred from auto-repeat")
+
+    from .tui import MotionInputApp  # ruff: ignore[import-outside-top-level] - importing textual is slow, only do it when running the app
+
+    MotionInputApp(
+        config,
+        key_release=key_release,
+        skip_setup=bool(args.game and args.character),
+    ).run()
+    return 0
+
+
+def _resolve_selection(config: Config, *, from_cli: bool) -> bool:
+    """Check the selection against the rosters. False means do not start.
+
+    A remembered character can simply be gone: rosters are regenerated, and a
+    name override in ``motioninput_tui_datagen/names.py`` renames the key with the character.
+    That is no reason to refuse to start, so the selection is dropped and the
+    picker opens on it instead. A character named on the command line is
+    different, and still gets an error.
+    """
+    if not config.game:
+        return True
+    try:
+        game = load_game(config.game)
+    except GameDataMissingError as exc:
+        logger.error("%s", exc)  # ruff: ignore[error-instead-of-exception] - a traceback helps nobody here
+        return False
+    if not config.character:
+        return True
+    try:
+        config.character = game.character(config.character).key
+    except KeyError as exc:
+        if from_cli:
+            logger.error("%s", exc)  # ruff: ignore[error-instead-of-exception] - a traceback helps nobody here
+            return False
+        logger.info("Forgetting the saved character, it is not in the roster any more: %s", exc)
+        config.character = None
+    return True
+
+
+def _apply_overrides(config: Config, args: argparse.Namespace) -> None:
+    """Let command line arguments win over what was remembered."""
+    if args.game:
+        config.game = args.game
+        # Not the character from whatever game was being played last: whoever
+        # was last trained on this one. --character always wins, and cannot be
+        # given without --game.
+        config.character = args.character or config.characters.get(args.game)
+    if args.layout:
+        config.layout = args.layout
+    if args.loose_buffer is not None:
+        config.buffer_policy = BufferPolicy.LOOSE if args.loose_buffer else BufferPolicy.CONSUME
+
+
+if __name__ == "__main__":
+    sys.exit(main())  # pragma: no cover