Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
__init__.py	925 B	-rw-r--r--	2025-06-23 15:20
__main__.py	422 B	-rw-r--r--	2025-06-23 15:20
_minimal_curses.py	1.8 KB	-rw-r--r--	2025-06-23 15:20
_threading_handler.py	2.12 KB	-rw-r--r--	2025-06-23 15:20
base_eventqueue.py	3.75 KB	-rw-r--r--	2025-06-23 15:20
commands.py	11.9 KB	-rw-r--r--	2025-06-23 15:20
completing_reader.py	9.81 KB	-rw-r--r--	2025-06-23 15:20
console.py	6.71 KB	-rw-r--r--	2025-06-23 15:20
curses.py	1.21 KB	-rw-r--r--	2025-06-23 15:20
fancy_termios.py	2.11 KB	-rw-r--r--	2025-06-23 15:20
historical_reader.py	12.93 KB	-rw-r--r--	2025-06-23 15:20
input.py	3.69 KB	-rw-r--r--	2025-06-23 15:20
keymap.py	6.31 KB	-rw-r--r--	2025-06-23 15:20
main.py	1.89 KB	-rw-r--r--	2025-06-23 15:20
mypy.ini	870 B	-rw-r--r--	2025-06-11 15:36
pager.py	5.68 KB	-rw-r--r--	2025-06-23 15:20
reader.py	27.06 KB	-rw-r--r--	2025-06-23 15:20
readline.py	19.75 KB	-rw-r--r--	2025-06-23 15:20
simple_interact.py	5.63 KB	-rw-r--r--	2025-06-23 15:20
trace.py	433 B	-rw-r--r--	2025-06-23 15:20
types.py	354 B	-rw-r--r--	2025-06-23 15:20
unix_console.py	25.04 KB	-rw-r--r--	2025-06-23 15:20
unix_eventqueue.py	2.46 KB	-rw-r--r--	2025-06-23 15:20
utils.py	2.18 KB	-rw-r--r--	2025-06-23 15:20
windows_console.py	21.11 KB	-rw-r--r--	2025-06-23 15:20
windows_eventqueue.py	991 B	-rw-r--r--	2025-06-23 15:20

Rename

#   Copyright 2000-2008 Michael Hudson-Doyle <micahel@gmail.com>
#                       Armin Rigo
#
#                        All Rights Reserved
#
#
# Permission to use, copy, modify, and distribute this software and
# its documentation for any purpose is hereby granted without fee,
# provided that the above copyright notice appear in all copies and
# that both that copyright notice and this permission notice appear in
# supporting documentation.
#
# THE AUTHOR MICHAEL HUDSON DISCLAIMS ALL WARRANTIES WITH REGARD TO
# THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
# AND FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL,
# INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
# RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
# CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
# CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

from . import curses
from .trace import trace
from .base_eventqueue import BaseEventQueue
from termios import tcgetattr, VERASE
import os

# Mapping of human-readable key names to their terminal-specific codes
TERMINAL_KEYNAMES = {
    "delete": "kdch1",
    "down": "kcud1",
    "end": "kend",
    "enter": "kent",
    "home": "khome",
    "insert": "kich1",
    "left": "kcub1",
    "page down": "knp",
    "page up": "kpp",
    "right": "kcuf1",
    "up": "kcuu1",
}

# Function keys F1-F20 mapping
TERMINAL_KEYNAMES.update(("f%d" % i, "kf%d" % i) for i in range(1, 21))

# Known CTRL-arrow keycodes
CTRL_ARROW_KEYCODES= {
    # for xterm, gnome-terminal, xfce terminal, etc.
    b'\033[1;5D': 'ctrl left',
    b'\033[1;5C': 'ctrl right',
    # for rxvt
    b'\033Od': 'ctrl left',
    b'\033Oc': 'ctrl right',
}

def get_terminal_keycodes() -> dict[bytes, str]:
    """
    Generates a dictionary mapping terminal keycodes to human-readable names.
    """
    keycodes = {}
    for key, terminal_code in TERMINAL_KEYNAMES.items():
        keycode = curses.tigetstr(terminal_code)
        trace('key {key} tiname {terminal_code} keycode {keycode!r}', **locals())
        if keycode:
            keycodes[keycode] = key
    keycodes.update(CTRL_ARROW_KEYCODES)
    return keycodes

class EventQueue(BaseEventQueue):
    def __init__(self, fd: int, encoding: str) -> None:
        keycodes = get_terminal_keycodes()
        if os.isatty(fd):
            backspace = tcgetattr(fd)[6][VERASE]
            keycodes[backspace] = "backspace"
        BaseEventQueue.__init__(self, encoding, keycodes)