cli-arcade 2026.2.0__py3-none-any.whl → 2026.2.1__py3-none-any.whl

{cli_arcade-2026.2.0.dist-info → cli_arcade-2026.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cli-arcade
-Version: 2026.2.0
+Version: 2026.2.1
 Summary: Collection of terminal CLI games
 Home-page: https://github.com/Bro-Code-Technologies/cli-arcade/tree/main/windows
 Author: Bro Code Technologies LLC
@@ -96,3 +96,6 @@ All notable changes to this project will be documented in this file.
 - Byte Bouncer & Star Ship: floor + off-screen right wall; left-column bug fixed.
 - `ptk`: default-attribute/color emission fix; add helper to exit alt screen.
 - Fixed 180 movement glitch in Star Ship.
+
+### 2026.2.1
+- Updated key mapping to work with Linux and macOS terminals.

{cli_arcade-2026.2.0.dist-info → cli_arcade-2026.2.1.dist-info}/RECORD

@@ -1,29 +1,37 @@
 cli.py,sha256=sf70SoYU89X2b5CENYvqC7z8KntRadlV3IQHJXrgkw0,19567
-cli_arcade-2026.2.0.dist-info/licenses/LICENSE,sha256=1PLSNFyGPi9COkVEeNYcUTuRLqGxzMLLTah05tByD4s,1099
+cli_arcade-2026.2.1.dist-info/licenses/LICENSE,sha256=1PLSNFyGPi9COkVEeNYcUTuRLqGxzMLLTah05tByD4s,1099
 game_classes/__init__.py,sha256=A0o4vBUktOiONToIJb0hACalszBnFS9ls9WXPn3-KH0,28
 game_classes/game_base.py,sha256=8OaMHwPE6KKhwRCbUoI0Kypf2CN6RVxze_zdqaw7HhE,3499
 game_classes/highscores.py,sha256=dDK-7lFXSMwIqExXGp6_-7QfQz6CIf12lJ22poeCdh4,4061
 game_classes/menu.py,sha256=wx-dITSozG1VCfyFeFKgooRXEijQygDCTBRvoKnd7-8,2798
-game_classes/ptk.py,sha256=CpbE7KJ3HXTRuaeMJSIMEfGzcwjmPMtURjyHPOFWVoY,8119
+game_classes/ptk.py,sha256=v7vXIJVaJUc5JdDtUSyD6QLDJnybXY_ueDEatRqAFuI,12977
 game_classes/tools.py,sha256=sZR4m8NSil4UhmZ2qDsl1iEi1hZMwUPVBFR5hSmiEBc,5106
+game_classes/__pycache__/__init__.cpython-312.pyc,sha256=R0jJUxI2JIcXR4r34VwLgaPHHUCRZBwegLXmlZ2n2LM,197
 game_classes/__pycache__/__init__.cpython-313.pyc,sha256=zSl9ESMUQn5Vo_XXAA8DD7lpFHOtOwBruGvCOJ5qeuo,192
+game_classes/__pycache__/game_base.cpython-312.pyc,sha256=oeqYvfMbSDgwzZ3x2-lnuOVHSo2QWZQgbbYU9j3A8qY,6765
 game_classes/__pycache__/game_base.cpython-313.pyc,sha256=NKAgCBXxM7nZ8mt6wFy1MxUW6DK7EBhqXiLr1sVmtiA,6977
+game_classes/__pycache__/highscores.cpython-312.pyc,sha256=uaBo2z_TbERpOR1V-7oiVyt9iNu2Q1-WtMRuUb5FTY8,6942
 game_classes/__pycache__/highscores.cpython-313.pyc,sha256=0rYMYs6NOzT-f00Me20F-46kUR_x8ZXk2jngO5amLy4,7080
+game_classes/__pycache__/menu.cpython-312.pyc,sha256=fQ-AFhkA97IM3aauTx1J8huAXEcwELuc8QzO589o7ms,4424
 game_classes/__pycache__/menu.cpython-313.pyc,sha256=urqSfGlJJdfTKI1kqXOT0oPXjo1Ny9MyYA8QroVQHzQ,4488
-game_classes/__pycache__/ptk.cpython-313.pyc,sha256=ZTwAGo3hlFRhk5rNbLiUBOMmR_odse9v_XTkHXdjxpw,14412
+game_classes/__pycache__/ptk.cpython-312.pyc,sha256=h5ShTY7g8zjU1d3bJZkbcdtJGN6CVvB1IIDL7WNozOk,18602
+game_classes/__pycache__/ptk.cpython-313.pyc,sha256=oSVDS5Cfugqn-cCsLjdoB7upFo6CgYSC5PwVaufS0hI,19240
 game_classes/__pycache__/ptk_curses.cpython-313.pyc,sha256=XqhJ78tqyT0HFd5UV_1_IrGl-W5PuW4WyJve5RiY3uo,13820
 game_classes/__pycache__/ptk_game_base.cpython-313.pyc,sha256=tRzGtoCErAHsUpoEWVjQN4PQ0Gw5N9RW3nJHJW2IT24,6915
 game_classes/__pycache__/ptk_menu.cpython-313.pyc,sha256=jyBSuLVxNm7ueGjAIKhd7D_ZEFpwLv9U1iim_ElClHk,2448
 game_classes/__pycache__/ptk_tools.cpython-313.pyc,sha256=Y-lBpAMlt8HfgQEio4isDGpwXclYUsyzs9wGoeGJkmE,5061
+game_classes/__pycache__/tools.cpython-312.pyc,sha256=X_qDsJLFe5_Y29l4MlH_RuM46dOxvunIUTyBsvYj85o,7273
 game_classes/__pycache__/tools.cpython-313.pyc,sha256=0MS9Cai_D0LaIQ6w6c6BLSJ45XvnUr4BjHSQdFYnQ7Y,7316
 games/__init__.py,sha256=Rg46lnLj_sezpnXaQTS1NXX5OaRhR_EWpNTyYUxycj4,21
 games/byte_bouncer/__init__.py,sha256=8hxIHRyUPB-X6vJXh1432ytKjOcfIzCbdpO5mmWA7iQ,33
 games/byte_bouncer/game.py,sha256=EpTzObLNF_cGfB-xRkUlqCwYt7A7IGk8nENkOdqoV3c,8877
 games/byte_bouncer/__pycache__/byte_bouncer.cpython-313.pyc,sha256=JSTB6-_KCukAAVaZz9TpJ3V4gif_M3n_L5X1KOviSJ8,24605
+games/byte_bouncer/__pycache__/game.cpython-312.pyc,sha256=ITr1oNdZ7TQiDAw_suY1bFHQaiydXB_I7-TMMJMN5h8,13709
 games/byte_bouncer/__pycache__/game.cpython-313.pyc,sha256=0H66QPFncbxvKVlMRPKEXjJDYtw1pPAw5I9sz3kWdIA,13965
 games/byte_bouncer/__pycache__/highscores.cpython-313.pyc,sha256=g3FozKpWGDVsTVETNpb6lRHcKA3ZIsQio8Kh7KCGVCI,3125
 games/star_ship/__init__.py,sha256=X8AdhoccmNVu6yl7MalsxIsMxuEsddRdlvEQmhZMD0A,30
 games/star_ship/game.py,sha256=aN3LVh-kaYppAy-J259Y6XROT5pvEAFDjGd1404oWBw,10992
+games/star_ship/__pycache__/game.cpython-312.pyc,sha256=lOScasiJ9VaNlCua45m_jejQPetUQGROhCxlV_aKi1I,15712
 games/star_ship/__pycache__/game.cpython-313.pyc,sha256=hWqwV12a1VF-_Lc8Uzd7ono4ZN3gNJ4RQ-gK69OayVw,15922
 games/star_ship/__pycache__/highscores.cpython-313.pyc,sha256=nHbEOTWeX0U9D47K2EP5S5uDPI0WW52Eg7h_NesG1OU,3148
 games/star_ship/__pycache__/nibbles.cpython-313.pyc,sha256=Yv2P-GwEc30zA24aO7k0hkk1AOja6K85AFvmjLIffqQ,20510
@@ -31,11 +39,12 @@ games/star_ship/__pycache__/snek.cpython-313.pyc,sha256=3Mwyy6vjGFRmNyAWSqV5JRil
 games/star_ship/__pycache__/star_ship.cpython-313.pyc,sha256=9gJt10MTzVTSwsc4I16TDZTaAXclfhfGTzgfYgZNOKo,28021
 games/terminal_tumble/__init__.py,sha256=axTd7hCgnLRNU8QS73NnQY3q5xjIb3ZYQORJ9Lz8l_E,36
 games/terminal_tumble/game.py,sha256=UbtrMS4wi5MiIMHfreP51VlrHHlfxEPJpFmsLgdUgWs,15633
+games/terminal_tumble/__pycache__/game.cpython-312.pyc,sha256=44n4iwM1rIjtMyeyITib1ewnGqOcI8p-npdpSErJQUs,23684
 games/terminal_tumble/__pycache__/game.cpython-313.pyc,sha256=DrjmLzJYY5QoYXghGh-ORn26Yax9Gmd6fSCZGdgYbRQ,24073
 games/terminal_tumble/__pycache__/highscores.cpython-313.pyc,sha256=UPnU9Zq88q2TZq1qXyo8e2Y_PdOgwvu5mncIkunFah8,3154
 games/terminal_tumble/__pycache__/terminal_tumble.cpython-313.pyc,sha256=7oLpmmkYjpLYRC0bjRoEkHbIUNq7FZVJToGoja94m0o,38016
-cli_arcade-2026.2.0.dist-info/METADATA,sha256=dBo3dzuaIBHOOOKkyi8NMZw7OacdGshIWdDEtMKZ5Ik,3229
-cli_arcade-2026.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cli_arcade-2026.2.0.dist-info/entry_points.txt,sha256=nNElhZv4nM_lrOYpvnOChtJn1XsWwQr8sI344flzzTQ,56
-cli_arcade-2026.2.0.dist-info/top_level.txt,sha256=gTfYlz7gHYgPY0ugfJivukCOkNzmOisNR6VuJjAXPF4,23
-cli_arcade-2026.2.0.dist-info/RECORD,,
+cli_arcade-2026.2.1.dist-info/METADATA,sha256=zD5GPdMYROphM5_bhvgOHKbA_kTOdBe65-l6UZWSQOg,3308
+cli_arcade-2026.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cli_arcade-2026.2.1.dist-info/entry_points.txt,sha256=nNElhZv4nM_lrOYpvnOChtJn1XsWwQr8sI344flzzTQ,56
+cli_arcade-2026.2.1.dist-info/top_level.txt,sha256=gTfYlz7gHYgPY0ugfJivukCOkNzmOisNR6VuJjAXPF4,23
+cli_arcade-2026.2.1.dist-info/RECORD,,

game_classes/ptk.py

@@ -5,8 +5,24 @@ import threading
 import queue
 import time
 
-from prompt_toolkit.input import create_input
-from prompt_toolkit.keys import Keys
+_HAS_PROMPT_TOOLKIT = True
+try:
+    from prompt_toolkit.input import create_input
+    from prompt_toolkit.keys import Keys
+except Exception:
+    create_input = None
+    Keys = None
+    _HAS_PROMPT_TOOLKIT = False
+import select
+
+_HAS_TERMIOS = True
+try:
+    import termios
+    import tty
+except Exception:
+    termios = None
+    tty = None
+    _HAS_TERMIOS = False
 
 # basic color constants (match curses style usage)
 COLOR_BLACK = 0
@@ -92,10 +108,29 @@ class _Screen:
         self._use_msvcrt = os.name == "nt"
         self._input = None
         self._thread = None
+        self._posix_fd = None
+        self._orig_term_attrs = None
         if not self._use_msvcrt:
-            self._input = create_input()
-            self._thread = threading.Thread(target=self._reader, daemon=True)
-            self._thread.start()
+            # Prefer a simple termios-based reader on POSIX for raw key capture
+            if _HAS_TERMIOS:
+                try:
+                    self._posix_fd = sys.stdin.fileno()
+                    self._orig_term_attrs = termios.tcgetattr(self._posix_fd)
+                    tty.setcbreak(self._posix_fd)
+                    self._thread = threading.Thread(target=self._posix_reader, daemon=True)
+                    self._thread.start()
+                except Exception:
+                    # fall back to prompt_toolkit if termios fails
+                    self._posix_fd = None
+                    self._orig_term_attrs = None
+            if self._posix_fd is None and _HAS_PROMPT_TOOLKIT and create_input is not None:
+                try:
+                    self._input = create_input()
+                    self._thread = threading.Thread(target=self._reader, daemon=True)
+                    self._thread.start()
+                except Exception as e:
+                    self._input = None
+                    sys.stderr.write(f"[ptk] create_input failed: {e}\n")
         self._timeout = 0.0
         self._buffer = []
         self._attrs = []
@@ -126,9 +161,81 @@ class _Screen:
                 try:
                     for key in self._input.read_keys():
                         self._queue.put(key)
-                except Exception:
+                except Exception as e:
+                    # log and continue — don't let the thread die silently
+                    sys.stderr.write(f"[ptk] reader exception: {e}\n")
                     time.sleep(0.01)
 
+    def _posix_reader(self):
+        if not _HAS_TERMIOS:
+            return
+        fd = self._posix_fd
+        buf = b""
+        while not self._stop.is_set():
+            try:
+                r, _, _ = select.select([fd], [], [], 0.1)
+                if not r:
+                    continue
+                chunk = os.read(fd, 32)
+                if not chunk:
+                    continue
+                buf += chunk
+                # process buffer for known sequences
+                while buf:
+                    # single-byte control checks
+                    if buf.startswith(b"\x1b"):
+                        # escape sequences: try to consume common sequences
+                        if buf.startswith(b"\x1b[A"):
+                            self._queue.put(KEY_UP)
+                            buf = buf[3:]
+                            continue
+                        if buf.startswith(b"\x1b[B"):
+                            self._queue.put(KEY_DOWN)
+                            buf = buf[3:]
+                            continue
+                        if buf.startswith(b"\x1b[C"):
+                            self._queue.put(KEY_RIGHT)
+                            buf = buf[3:]
+                            continue
+                        if buf.startswith(b"\x1b[D"):
+                            self._queue.put(KEY_LEFT)
+                            buf = buf[3:]
+                            continue
+                        # PageUp/PageDown common sequences
+                        if buf.startswith(b"\x1b[5~"):
+                            self._queue.put(KEY_PPAGE)
+                            buf = buf[4:]
+                            continue
+                        if buf.startswith(b"\x1b[6~"):
+                            self._queue.put(KEY_NPAGE)
+                            buf = buf[4:]
+                            continue
+                        # unknown escape: drop single ESC
+                        self._queue.put(27)
+                        buf = buf[1:]
+                        continue
+                    # newline / carriage return
+                    if buf[0] in (10, 13):
+                        self._queue.put(10)
+                        buf = buf[1:]
+                        continue
+                    # backspace (DEL or BS)
+                    if buf[0] in (8, 127):
+                        self._queue.put(KEY_BACKSPACE)
+                        buf = buf[1:]
+                        continue
+                    # regular printable character
+                    ch = buf[0]
+                    if 32 <= ch <= 126:
+                        self._queue.put(ch)
+                        buf = buf[1:]
+                        continue
+                    # unhandled byte: drop
+                    buf = buf[1:]
+            except Exception as e:
+                sys.stderr.write(f"[ptk] posix_reader exception: {e}\n")
+                time.sleep(0.01)
+
     def stop(self):
         self._stop.set()
         try:
@@ -136,6 +243,12 @@ class _Screen:
                 self._input.close()
         except Exception:
             pass
+        # restore termios attrs if we changed them
+        try:
+            if self._orig_term_attrs is not None and _HAS_TERMIOS:
+                termios.tcsetattr(self._posix_fd, termios.TCSANOW, self._orig_term_attrs)
+        except Exception:
+            pass
 
     def nodelay(self, _flag=True):
         return None
@@ -221,6 +334,9 @@ class _Screen:
             key = self._queue.get(timeout=self._timeout)
         except Exception:
             return -1
+        # key may be an int from posix reader or a keypress object from prompt_toolkit
+        if isinstance(key, int):
+            return key
         return _map_keypress(key)