mirror of
https://github.com/kovidgoyal/kitty.git
synced 2026-05-13 16:37:27 +00:00
887 lines
47 KiB
Python
887 lines
47 KiB
Python
#!/usr/bin/env python
|
||
# License: GPL v3 Copyright: 2016, Kovid Goyal <kovid at kovidgoyal.net>
|
||
|
||
from functools import partial
|
||
|
||
import kitty.fast_data_types as defines
|
||
from kitty.key_encoding import EventType, KeyEvent, decode_key_event, encode_key_event
|
||
from kitty.keys import Mappings
|
||
from kitty.options.utils import KeyFallbackType
|
||
|
||
from . import BaseTest
|
||
|
||
|
||
class TestKeys(BaseTest):
|
||
|
||
def test_encode_key_event(self):
|
||
enc = defines.encode_key_for_tty
|
||
ae = self.assertEqual
|
||
shift, alt, ctrl, super, hyper, meta = defines.GLFW_MOD_SHIFT, defines.GLFW_MOD_ALT, defines.GLFW_MOD_CONTROL, defines.GLFW_MOD_SUPER, defines.GLFW_MOD_HYPER, defines.GLFW_MOD_META # noqa
|
||
num_lock, caps_lock = defines.GLFW_MOD_NUM_LOCK, defines.GLFW_MOD_CAPS_LOCK
|
||
press, repeat, release = defines.GLFW_PRESS, defines.GLFW_REPEAT, defines.GLFW_RELEASE # noqa
|
||
|
||
def csi(mods=0, num=1, action=1, shifted_key=0, alternate_key=0, text=None, trailer='u'):
|
||
ans = '\033['
|
||
if isinstance(num, str):
|
||
num = ord(num)
|
||
if num != 1 or mods or shifted_key or alternate_key or text:
|
||
ans += f'{num}'
|
||
if shifted_key or alternate_key:
|
||
if isinstance(shifted_key, str):
|
||
shifted_key = ord(shifted_key)
|
||
ans += ':' + (f'{shifted_key}' if shifted_key else '')
|
||
if alternate_key:
|
||
if isinstance(alternate_key, str):
|
||
alternate_key = ord(alternate_key)
|
||
ans += f':{alternate_key}'
|
||
if mods or action > 1 or text:
|
||
m = 0
|
||
if mods & shift:
|
||
m |= 1
|
||
if mods & alt:
|
||
m |= 2
|
||
if mods & ctrl:
|
||
m |= 4
|
||
if mods & super:
|
||
m |= 8
|
||
if mods & hyper:
|
||
m |= 16
|
||
if mods & meta:
|
||
m |= 32
|
||
if action > 1 or m:
|
||
ans += f';{m+1}'
|
||
if action > 1:
|
||
ans += f':{action}'
|
||
elif text:
|
||
ans += ';'
|
||
if text:
|
||
ans += ';' + ':'.join(map(str, map(ord, text)))
|
||
return ans + trailer
|
||
|
||
def mods_test(key, plain=None, shift=None, ctrl=None, alt=None, calt=None, cshift=None, ashift=None, csi_num=None, trailer='u'):
|
||
c = partial(csi, num=csi_num or key, trailer=trailer)
|
||
e = partial(enc, key=key)
|
||
|
||
def a(a, b):
|
||
ae(a, b, f"{a.encode('ascii')} != {b.encode('ascii')}")
|
||
|
||
def w(a, b):
|
||
return c(b) if a is None else a
|
||
|
||
a(e(), plain or c())
|
||
a(e(mods=defines.GLFW_MOD_SHIFT), w(shift, defines.GLFW_MOD_SHIFT))
|
||
a(e(mods=defines.GLFW_MOD_CONTROL), w(ctrl, defines.GLFW_MOD_CONTROL))
|
||
a(e(mods=defines.GLFW_MOD_ALT | defines.GLFW_MOD_CONTROL), w(calt, defines.GLFW_MOD_ALT | defines.GLFW_MOD_CONTROL))
|
||
a(e(mods=defines.GLFW_MOD_SHIFT | defines.GLFW_MOD_CONTROL), w(cshift, defines.GLFW_MOD_CONTROL | defines.GLFW_MOD_SHIFT))
|
||
a(e(mods=defines.GLFW_MOD_SHIFT | defines.GLFW_MOD_ALT), w(ashift, defines.GLFW_MOD_ALT | defines.GLFW_MOD_SHIFT))
|
||
|
||
def mkp(name, *a, **kw):
|
||
for x in (f'GLFW_FKEY_{name}', f'GLFW_FKEY_KP_{name}'):
|
||
k = getattr(defines, x)
|
||
mods_test(k, *a, **kw)
|
||
|
||
mkp('ENTER', '\x0d', alt='\033\x0d', ctrl='\x0d', shift='\x0d', ashift='\033\x0d', calt='\033\x0d', cshift='\x0d')
|
||
mods_test(defines.GLFW_FKEY_ESCAPE, '\x1b', alt='\033\033', ctrl='\x1b', shift='\x1b', calt='\x1b\x1b', cshift='\x1b', ashift='\x1b\x1b')
|
||
mods_test(defines.GLFW_FKEY_BACKSPACE, '\x7f', alt='\033\x7f', ctrl='\x08', shift='\x7f', ashift='\033\x7f', cshift='\x08', calt='\x1b\x08')
|
||
mods_test(defines.GLFW_FKEY_TAB, '\t', alt='\033\t', shift='\x1b[Z', ctrl='\t', ashift='\x1b\x1b[Z', cshift='\x1b[Z', calt='\x1b\t')
|
||
mkp('INSERT', csi_num=2, trailer='~')
|
||
mkp('DELETE', csi_num=3, trailer='~')
|
||
mkp('PAGE_UP', csi_num=5, trailer='~')
|
||
mkp('PAGE_DOWN', csi_num=6, trailer='~')
|
||
mkp('HOME', csi_num=1, trailer='H')
|
||
mkp('END', csi_num=1, trailer='F')
|
||
mods_test(defines.GLFW_FKEY_F1, '\x1bOP', csi_num=1, trailer='P')
|
||
mods_test(defines.GLFW_FKEY_F2, '\x1bOQ', csi_num=1, trailer='Q')
|
||
mods_test(defines.GLFW_FKEY_F3, '\x1bOR', csi_num=13, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F4, '\x1bOS', csi_num=1, trailer='S')
|
||
mods_test(defines.GLFW_FKEY_F5, csi_num=15, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F6, csi_num=17, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F7, csi_num=18, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F8, csi_num=19, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F9, csi_num=20, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F10, csi_num=21, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F11, csi_num=23, trailer='~')
|
||
mods_test(defines.GLFW_FKEY_F12, csi_num=24, trailer='~')
|
||
mkp('UP', csi_num=1, trailer='A')
|
||
mkp('DOWN', csi_num=1, trailer='B')
|
||
mkp('RIGHT', csi_num=1, trailer='C')
|
||
mkp('LEFT', csi_num=1, trailer='D')
|
||
|
||
# legacy key tests {{{
|
||
# start legacy letter tests (auto generated by gen-key-constants.py do not edit)
|
||
ae(enc(ord('`'), shifted_key=ord('~')), '`')
|
||
ae(enc(ord('`'), shifted_key=ord('~'), mods=shift), '~')
|
||
ae(enc(ord('`'), shifted_key=ord('~'), mods=alt), "\x1b" + '`')
|
||
ae(enc(ord('`'), shifted_key=ord('~'), mods=shift | alt), "\x1b" + '~')
|
||
ae(enc(ord('`'), shifted_key=ord('~'), mods=ctrl), '`')
|
||
ae(enc(ord('`'), shifted_key=ord('~'), mods=ctrl | alt), "\x1b" + '`')
|
||
ae(enc(ord('1'), shifted_key=ord('!')), '1')
|
||
ae(enc(ord('1'), shifted_key=ord('!'), mods=shift), '!')
|
||
ae(enc(ord('1'), shifted_key=ord('!'), mods=alt), "\x1b" + '1')
|
||
ae(enc(ord('1'), shifted_key=ord('!'), mods=shift | alt), "\x1b" + '!')
|
||
ae(enc(ord('1'), shifted_key=ord('!'), mods=ctrl), '1')
|
||
ae(enc(ord('1'), shifted_key=ord('!'), mods=ctrl | alt), "\x1b" + '1')
|
||
ae(enc(ord('2'), shifted_key=ord('@')), '2')
|
||
ae(enc(ord('2'), shifted_key=ord('@'), mods=shift), '@')
|
||
ae(enc(ord('2'), shifted_key=ord('@'), mods=alt), "\x1b" + '2')
|
||
ae(enc(ord('2'), shifted_key=ord('@'), mods=shift | alt), "\x1b" + '@')
|
||
ae(enc(ord('2'), shifted_key=ord('@'), mods=ctrl), '\x00')
|
||
ae(enc(ord('2'), shifted_key=ord('@'), mods=ctrl | alt), "\x1b" + '\x00')
|
||
ae(enc(ord('3'), shifted_key=ord('#')), '3')
|
||
ae(enc(ord('3'), shifted_key=ord('#'), mods=shift), '#')
|
||
ae(enc(ord('3'), shifted_key=ord('#'), mods=alt), "\x1b" + '3')
|
||
ae(enc(ord('3'), shifted_key=ord('#'), mods=shift | alt), "\x1b" + '#')
|
||
ae(enc(ord('3'), shifted_key=ord('#'), mods=ctrl), '\x1b')
|
||
ae(enc(ord('3'), shifted_key=ord('#'), mods=ctrl | alt), "\x1b" + '\x1b')
|
||
ae(enc(ord('4'), shifted_key=ord('$')), '4')
|
||
ae(enc(ord('4'), shifted_key=ord('$'), mods=shift), '$')
|
||
ae(enc(ord('4'), shifted_key=ord('$'), mods=alt), "\x1b" + '4')
|
||
ae(enc(ord('4'), shifted_key=ord('$'), mods=shift | alt), "\x1b" + '$')
|
||
ae(enc(ord('4'), shifted_key=ord('$'), mods=ctrl), '\x1c')
|
||
ae(enc(ord('4'), shifted_key=ord('$'), mods=ctrl | alt), "\x1b" + '\x1c')
|
||
ae(enc(ord('5'), shifted_key=ord('%')), '5')
|
||
ae(enc(ord('5'), shifted_key=ord('%'), mods=shift), '%')
|
||
ae(enc(ord('5'), shifted_key=ord('%'), mods=alt), "\x1b" + '5')
|
||
ae(enc(ord('5'), shifted_key=ord('%'), mods=shift | alt), "\x1b" + '%')
|
||
ae(enc(ord('5'), shifted_key=ord('%'), mods=ctrl), '\x1d')
|
||
ae(enc(ord('5'), shifted_key=ord('%'), mods=ctrl | alt), "\x1b" + '\x1d')
|
||
ae(enc(ord('6'), shifted_key=ord('^')), '6')
|
||
ae(enc(ord('6'), shifted_key=ord('^'), mods=shift), '^')
|
||
ae(enc(ord('6'), shifted_key=ord('^'), mods=alt), "\x1b" + '6')
|
||
ae(enc(ord('6'), shifted_key=ord('^'), mods=shift | alt), "\x1b" + '^')
|
||
ae(enc(ord('6'), shifted_key=ord('^'), mods=ctrl), '\x1e')
|
||
ae(enc(ord('6'), shifted_key=ord('^'), mods=ctrl | alt), "\x1b" + '\x1e')
|
||
ae(enc(ord('7'), shifted_key=ord('&')), '7')
|
||
ae(enc(ord('7'), shifted_key=ord('&'), mods=shift), '&')
|
||
ae(enc(ord('7'), shifted_key=ord('&'), mods=alt), "\x1b" + '7')
|
||
ae(enc(ord('7'), shifted_key=ord('&'), mods=shift | alt), "\x1b" + '&')
|
||
ae(enc(ord('7'), shifted_key=ord('&'), mods=ctrl), '\x1f')
|
||
ae(enc(ord('7'), shifted_key=ord('&'), mods=ctrl | alt), "\x1b" + '\x1f')
|
||
ae(enc(ord('8'), shifted_key=ord('*')), '8')
|
||
ae(enc(ord('8'), shifted_key=ord('*'), mods=shift), '*')
|
||
ae(enc(ord('8'), shifted_key=ord('*'), mods=alt), "\x1b" + '8')
|
||
ae(enc(ord('8'), shifted_key=ord('*'), mods=shift | alt), "\x1b" + '*')
|
||
ae(enc(ord('8'), shifted_key=ord('*'), mods=ctrl), '\x7f')
|
||
ae(enc(ord('8'), shifted_key=ord('*'), mods=ctrl | alt), "\x1b" + '\x7f')
|
||
ae(enc(ord('9'), shifted_key=ord('(')), '9')
|
||
ae(enc(ord('9'), shifted_key=ord('('), mods=shift), '(')
|
||
ae(enc(ord('9'), shifted_key=ord('('), mods=alt), "\x1b" + '9')
|
||
ae(enc(ord('9'), shifted_key=ord('('), mods=shift | alt), "\x1b" + '(')
|
||
ae(enc(ord('9'), shifted_key=ord('('), mods=ctrl), '9')
|
||
ae(enc(ord('9'), shifted_key=ord('('), mods=ctrl | alt), "\x1b" + '9')
|
||
ae(enc(ord('0'), shifted_key=ord(')')), '0')
|
||
ae(enc(ord('0'), shifted_key=ord(')'), mods=shift), ')')
|
||
ae(enc(ord('0'), shifted_key=ord(')'), mods=alt), "\x1b" + '0')
|
||
ae(enc(ord('0'), shifted_key=ord(')'), mods=shift | alt), "\x1b" + ')')
|
||
ae(enc(ord('0'), shifted_key=ord(')'), mods=ctrl), '0')
|
||
ae(enc(ord('0'), shifted_key=ord(')'), mods=ctrl | alt), "\x1b" + '0')
|
||
ae(enc(ord('-'), shifted_key=ord('_')), '-')
|
||
ae(enc(ord('-'), shifted_key=ord('_'), mods=shift), '_')
|
||
ae(enc(ord('-'), shifted_key=ord('_'), mods=alt), "\x1b" + '-')
|
||
ae(enc(ord('-'), shifted_key=ord('_'), mods=shift | alt), "\x1b" + '_')
|
||
ae(enc(ord('-'), shifted_key=ord('_'), mods=ctrl), '-')
|
||
ae(enc(ord('-'), shifted_key=ord('_'), mods=ctrl | alt), "\x1b" + '-')
|
||
ae(enc(ord('='), shifted_key=ord('+')), '=')
|
||
ae(enc(ord('='), shifted_key=ord('+'), mods=shift), '+')
|
||
ae(enc(ord('='), shifted_key=ord('+'), mods=alt), "\x1b" + '=')
|
||
ae(enc(ord('='), shifted_key=ord('+'), mods=shift | alt), "\x1b" + '+')
|
||
ae(enc(ord('='), shifted_key=ord('+'), mods=ctrl), '=')
|
||
ae(enc(ord('='), shifted_key=ord('+'), mods=ctrl | alt), "\x1b" + '=')
|
||
ae(enc(ord('['), shifted_key=ord('{')), '[')
|
||
ae(enc(ord('['), shifted_key=ord('{'), mods=shift), '{')
|
||
ae(enc(ord('['), shifted_key=ord('{'), mods=alt), "\x1b" + '[')
|
||
ae(enc(ord('['), shifted_key=ord('{'), mods=shift | alt), "\x1b" + '{')
|
||
ae(enc(ord('['), shifted_key=ord('{'), mods=ctrl), '\x1b')
|
||
ae(enc(ord('['), shifted_key=ord('{'), mods=ctrl | alt), "\x1b" + '\x1b')
|
||
ae(enc(ord(']'), shifted_key=ord('}')), ']')
|
||
ae(enc(ord(']'), shifted_key=ord('}'), mods=shift), '}')
|
||
ae(enc(ord(']'), shifted_key=ord('}'), mods=alt), "\x1b" + ']')
|
||
ae(enc(ord(']'), shifted_key=ord('}'), mods=shift | alt), "\x1b" + '}')
|
||
ae(enc(ord(']'), shifted_key=ord('}'), mods=ctrl), '\x1d')
|
||
ae(enc(ord(']'), shifted_key=ord('}'), mods=ctrl | alt), "\x1b" + '\x1d')
|
||
ae(enc(ord('\\'), shifted_key=ord('|')), '\\')
|
||
ae(enc(ord('\\'), shifted_key=ord('|'), mods=shift), '|')
|
||
ae(enc(ord('\\'), shifted_key=ord('|'), mods=alt), "\x1b" + '\\')
|
||
ae(enc(ord('\\'), shifted_key=ord('|'), mods=shift | alt), "\x1b" + '|')
|
||
ae(enc(ord('\\'), shifted_key=ord('|'), mods=ctrl), '\x1c')
|
||
ae(enc(ord('\\'), shifted_key=ord('|'), mods=ctrl | alt), "\x1b" + '\x1c')
|
||
ae(enc(ord(';'), shifted_key=ord(':')), ';')
|
||
ae(enc(ord(';'), shifted_key=ord(':'), mods=shift), ':')
|
||
ae(enc(ord(';'), shifted_key=ord(':'), mods=alt), "\x1b" + ';')
|
||
ae(enc(ord(';'), shifted_key=ord(':'), mods=shift | alt), "\x1b" + ':')
|
||
ae(enc(ord(';'), shifted_key=ord(':'), mods=ctrl), ';')
|
||
ae(enc(ord(';'), shifted_key=ord(':'), mods=ctrl | alt), "\x1b" + ';')
|
||
ae(enc(ord("'"), shifted_key=ord('"')), "'")
|
||
ae(enc(ord("'"), shifted_key=ord('"'), mods=shift), '"')
|
||
ae(enc(ord("'"), shifted_key=ord('"'), mods=alt), "\x1b" + "'")
|
||
ae(enc(ord("'"), shifted_key=ord('"'), mods=shift | alt), "\x1b" + '"')
|
||
ae(enc(ord("'"), shifted_key=ord('"'), mods=ctrl), "'")
|
||
ae(enc(ord("'"), shifted_key=ord('"'), mods=ctrl | alt), "\x1b" + "'")
|
||
ae(enc(ord(','), shifted_key=ord('<')), ',')
|
||
ae(enc(ord(','), shifted_key=ord('<'), mods=shift), '<')
|
||
ae(enc(ord(','), shifted_key=ord('<'), mods=alt), "\x1b" + ',')
|
||
ae(enc(ord(','), shifted_key=ord('<'), mods=shift | alt), "\x1b" + '<')
|
||
ae(enc(ord(','), shifted_key=ord('<'), mods=ctrl), ',')
|
||
ae(enc(ord(','), shifted_key=ord('<'), mods=ctrl | alt), "\x1b" + ',')
|
||
ae(enc(ord('.'), shifted_key=ord('>')), '.')
|
||
ae(enc(ord('.'), shifted_key=ord('>'), mods=shift), '>')
|
||
ae(enc(ord('.'), shifted_key=ord('>'), mods=alt), "\x1b" + '.')
|
||
ae(enc(ord('.'), shifted_key=ord('>'), mods=shift | alt), "\x1b" + '>')
|
||
ae(enc(ord('.'), shifted_key=ord('>'), mods=ctrl), '.')
|
||
ae(enc(ord('.'), shifted_key=ord('>'), mods=ctrl | alt), "\x1b" + '.')
|
||
ae(enc(ord('/'), shifted_key=ord('?')), '/')
|
||
ae(enc(ord('/'), shifted_key=ord('?'), mods=shift), '?')
|
||
ae(enc(ord('/'), shifted_key=ord('?'), mods=alt), "\x1b" + '/')
|
||
ae(enc(ord('/'), shifted_key=ord('?'), mods=shift | alt), "\x1b" + '?')
|
||
ae(enc(ord('/'), shifted_key=ord('?'), mods=ctrl), '\x1f')
|
||
ae(enc(ord('/'), shifted_key=ord('?'), mods=ctrl | alt), "\x1b" + '\x1f')
|
||
ae(enc(ord('a'), shifted_key=ord('A')), 'a')
|
||
ae(enc(ord('a'), shifted_key=ord('A'), mods=shift), 'A')
|
||
ae(enc(ord('a'), shifted_key=ord('A'), mods=alt), "\x1b" + 'a')
|
||
ae(enc(ord('a'), shifted_key=ord('A'), mods=shift | alt), "\x1b" + 'A')
|
||
ae(enc(ord('a'), shifted_key=ord('A'), mods=ctrl), '\x01')
|
||
ae(enc(ord('a'), shifted_key=ord('A'), mods=ctrl | alt), "\x1b" + '\x01')
|
||
ae(enc(ord('b'), shifted_key=ord('B')), 'b')
|
||
ae(enc(ord('b'), shifted_key=ord('B'), mods=shift), 'B')
|
||
ae(enc(ord('b'), shifted_key=ord('B'), mods=alt), "\x1b" + 'b')
|
||
ae(enc(ord('b'), shifted_key=ord('B'), mods=shift | alt), "\x1b" + 'B')
|
||
ae(enc(ord('b'), shifted_key=ord('B'), mods=ctrl), '\x02')
|
||
ae(enc(ord('b'), shifted_key=ord('B'), mods=ctrl | alt), "\x1b" + '\x02')
|
||
ae(enc(ord('c'), shifted_key=ord('C')), 'c')
|
||
ae(enc(ord('c'), shifted_key=ord('C'), mods=shift), 'C')
|
||
ae(enc(ord('c'), shifted_key=ord('C'), mods=alt), "\x1b" + 'c')
|
||
ae(enc(ord('c'), shifted_key=ord('C'), mods=shift | alt), "\x1b" + 'C')
|
||
ae(enc(ord('c'), shifted_key=ord('C'), mods=ctrl), '\x03')
|
||
ae(enc(ord('c'), shifted_key=ord('C'), mods=ctrl | alt), "\x1b" + '\x03')
|
||
ae(enc(ord('d'), shifted_key=ord('D')), 'd')
|
||
ae(enc(ord('d'), shifted_key=ord('D'), mods=shift), 'D')
|
||
ae(enc(ord('d'), shifted_key=ord('D'), mods=alt), "\x1b" + 'd')
|
||
ae(enc(ord('d'), shifted_key=ord('D'), mods=shift | alt), "\x1b" + 'D')
|
||
ae(enc(ord('d'), shifted_key=ord('D'), mods=ctrl), '\x04')
|
||
ae(enc(ord('d'), shifted_key=ord('D'), mods=ctrl | alt), "\x1b" + '\x04')
|
||
ae(enc(ord('e'), shifted_key=ord('E')), 'e')
|
||
ae(enc(ord('e'), shifted_key=ord('E'), mods=shift), 'E')
|
||
ae(enc(ord('e'), shifted_key=ord('E'), mods=alt), "\x1b" + 'e')
|
||
ae(enc(ord('e'), shifted_key=ord('E'), mods=shift | alt), "\x1b" + 'E')
|
||
ae(enc(ord('e'), shifted_key=ord('E'), mods=ctrl), '\x05')
|
||
ae(enc(ord('e'), shifted_key=ord('E'), mods=ctrl | alt), "\x1b" + '\x05')
|
||
ae(enc(ord('f'), shifted_key=ord('F')), 'f')
|
||
ae(enc(ord('f'), shifted_key=ord('F'), mods=shift), 'F')
|
||
ae(enc(ord('f'), shifted_key=ord('F'), mods=alt), "\x1b" + 'f')
|
||
ae(enc(ord('f'), shifted_key=ord('F'), mods=shift | alt), "\x1b" + 'F')
|
||
ae(enc(ord('f'), shifted_key=ord('F'), mods=ctrl), '\x06')
|
||
ae(enc(ord('f'), shifted_key=ord('F'), mods=ctrl | alt), "\x1b" + '\x06')
|
||
ae(enc(ord('g'), shifted_key=ord('G')), 'g')
|
||
ae(enc(ord('g'), shifted_key=ord('G'), mods=shift), 'G')
|
||
ae(enc(ord('g'), shifted_key=ord('G'), mods=alt), "\x1b" + 'g')
|
||
ae(enc(ord('g'), shifted_key=ord('G'), mods=shift | alt), "\x1b" + 'G')
|
||
ae(enc(ord('g'), shifted_key=ord('G'), mods=ctrl), '\x07')
|
||
ae(enc(ord('g'), shifted_key=ord('G'), mods=ctrl | alt), "\x1b" + '\x07')
|
||
ae(enc(ord('h'), shifted_key=ord('H')), 'h')
|
||
ae(enc(ord('h'), shifted_key=ord('H'), mods=shift), 'H')
|
||
ae(enc(ord('h'), shifted_key=ord('H'), mods=alt), "\x1b" + 'h')
|
||
ae(enc(ord('h'), shifted_key=ord('H'), mods=shift | alt), "\x1b" + 'H')
|
||
ae(enc(ord('h'), shifted_key=ord('H'), mods=ctrl), '\x08')
|
||
ae(enc(ord('h'), shifted_key=ord('H'), mods=ctrl | alt), "\x1b" + '\x08')
|
||
ae(enc(ord('i'), shifted_key=ord('I')), 'i')
|
||
ae(enc(ord('i'), shifted_key=ord('I'), mods=shift), 'I')
|
||
ae(enc(ord('i'), shifted_key=ord('I'), mods=alt), "\x1b" + 'i')
|
||
ae(enc(ord('i'), shifted_key=ord('I'), mods=shift | alt), "\x1b" + 'I')
|
||
ae(enc(ord('i'), shifted_key=ord('I'), mods=ctrl), '\t')
|
||
ae(enc(ord('i'), shifted_key=ord('I'), mods=ctrl | alt), "\x1b" + '\t')
|
||
ae(enc(ord('j'), shifted_key=ord('J')), 'j')
|
||
ae(enc(ord('j'), shifted_key=ord('J'), mods=shift), 'J')
|
||
ae(enc(ord('j'), shifted_key=ord('J'), mods=alt), "\x1b" + 'j')
|
||
ae(enc(ord('j'), shifted_key=ord('J'), mods=shift | alt), "\x1b" + 'J')
|
||
ae(enc(ord('j'), shifted_key=ord('J'), mods=ctrl), '\n')
|
||
ae(enc(ord('j'), shifted_key=ord('J'), mods=ctrl | alt), "\x1b" + '\n')
|
||
ae(enc(ord('k'), shifted_key=ord('K')), 'k')
|
||
ae(enc(ord('k'), shifted_key=ord('K'), mods=shift), 'K')
|
||
ae(enc(ord('k'), shifted_key=ord('K'), mods=alt), "\x1b" + 'k')
|
||
ae(enc(ord('k'), shifted_key=ord('K'), mods=shift | alt), "\x1b" + 'K')
|
||
ae(enc(ord('k'), shifted_key=ord('K'), mods=ctrl), '\x0b')
|
||
ae(enc(ord('k'), shifted_key=ord('K'), mods=ctrl | alt), "\x1b" + '\x0b')
|
||
ae(enc(ord('l'), shifted_key=ord('L')), 'l')
|
||
ae(enc(ord('l'), shifted_key=ord('L'), mods=shift), 'L')
|
||
ae(enc(ord('l'), shifted_key=ord('L'), mods=alt), "\x1b" + 'l')
|
||
ae(enc(ord('l'), shifted_key=ord('L'), mods=shift | alt), "\x1b" + 'L')
|
||
ae(enc(ord('l'), shifted_key=ord('L'), mods=ctrl), '\x0c')
|
||
ae(enc(ord('l'), shifted_key=ord('L'), mods=ctrl | alt), "\x1b" + '\x0c')
|
||
ae(enc(ord('m'), shifted_key=ord('M')), 'm')
|
||
ae(enc(ord('m'), shifted_key=ord('M'), mods=shift), 'M')
|
||
ae(enc(ord('m'), shifted_key=ord('M'), mods=alt), "\x1b" + 'm')
|
||
ae(enc(ord('m'), shifted_key=ord('M'), mods=shift | alt), "\x1b" + 'M')
|
||
ae(enc(ord('m'), shifted_key=ord('M'), mods=ctrl), '\r')
|
||
ae(enc(ord('m'), shifted_key=ord('M'), mods=ctrl | alt), "\x1b" + '\r')
|
||
ae(enc(ord('n'), shifted_key=ord('N')), 'n')
|
||
ae(enc(ord('n'), shifted_key=ord('N'), mods=shift), 'N')
|
||
ae(enc(ord('n'), shifted_key=ord('N'), mods=alt), "\x1b" + 'n')
|
||
ae(enc(ord('n'), shifted_key=ord('N'), mods=shift | alt), "\x1b" + 'N')
|
||
ae(enc(ord('n'), shifted_key=ord('N'), mods=ctrl), '\x0e')
|
||
ae(enc(ord('n'), shifted_key=ord('N'), mods=ctrl | alt), "\x1b" + '\x0e')
|
||
ae(enc(ord('o'), shifted_key=ord('O')), 'o')
|
||
ae(enc(ord('o'), shifted_key=ord('O'), mods=shift), 'O')
|
||
ae(enc(ord('o'), shifted_key=ord('O'), mods=alt), "\x1b" + 'o')
|
||
ae(enc(ord('o'), shifted_key=ord('O'), mods=shift | alt), "\x1b" + 'O')
|
||
ae(enc(ord('o'), shifted_key=ord('O'), mods=ctrl), '\x0f')
|
||
ae(enc(ord('o'), shifted_key=ord('O'), mods=ctrl | alt), "\x1b" + '\x0f')
|
||
ae(enc(ord('p'), shifted_key=ord('P')), 'p')
|
||
ae(enc(ord('p'), shifted_key=ord('P'), mods=shift), 'P')
|
||
ae(enc(ord('p'), shifted_key=ord('P'), mods=alt), "\x1b" + 'p')
|
||
ae(enc(ord('p'), shifted_key=ord('P'), mods=shift | alt), "\x1b" + 'P')
|
||
ae(enc(ord('p'), shifted_key=ord('P'), mods=ctrl), '\x10')
|
||
ae(enc(ord('p'), shifted_key=ord('P'), mods=ctrl | alt), "\x1b" + '\x10')
|
||
ae(enc(ord('q'), shifted_key=ord('Q')), 'q')
|
||
ae(enc(ord('q'), shifted_key=ord('Q'), mods=shift), 'Q')
|
||
ae(enc(ord('q'), shifted_key=ord('Q'), mods=alt), "\x1b" + 'q')
|
||
ae(enc(ord('q'), shifted_key=ord('Q'), mods=shift | alt), "\x1b" + 'Q')
|
||
ae(enc(ord('q'), shifted_key=ord('Q'), mods=ctrl), '\x11')
|
||
ae(enc(ord('q'), shifted_key=ord('Q'), mods=ctrl | alt), "\x1b" + '\x11')
|
||
ae(enc(ord('r'), shifted_key=ord('R')), 'r')
|
||
ae(enc(ord('r'), shifted_key=ord('R'), mods=shift), 'R')
|
||
ae(enc(ord('r'), shifted_key=ord('R'), mods=alt), "\x1b" + 'r')
|
||
ae(enc(ord('r'), shifted_key=ord('R'), mods=shift | alt), "\x1b" + 'R')
|
||
ae(enc(ord('r'), shifted_key=ord('R'), mods=ctrl), '\x12')
|
||
ae(enc(ord('r'), shifted_key=ord('R'), mods=ctrl | alt), "\x1b" + '\x12')
|
||
ae(enc(ord('s'), shifted_key=ord('S')), 's')
|
||
ae(enc(ord('s'), shifted_key=ord('S'), mods=shift), 'S')
|
||
ae(enc(ord('s'), shifted_key=ord('S'), mods=alt), "\x1b" + 's')
|
||
ae(enc(ord('s'), shifted_key=ord('S'), mods=shift | alt), "\x1b" + 'S')
|
||
ae(enc(ord('s'), shifted_key=ord('S'), mods=ctrl), '\x13')
|
||
ae(enc(ord('s'), shifted_key=ord('S'), mods=ctrl | alt), "\x1b" + '\x13')
|
||
ae(enc(ord('t'), shifted_key=ord('T')), 't')
|
||
ae(enc(ord('t'), shifted_key=ord('T'), mods=shift), 'T')
|
||
ae(enc(ord('t'), shifted_key=ord('T'), mods=alt), "\x1b" + 't')
|
||
ae(enc(ord('t'), shifted_key=ord('T'), mods=shift | alt), "\x1b" + 'T')
|
||
ae(enc(ord('t'), shifted_key=ord('T'), mods=ctrl), '\x14')
|
||
ae(enc(ord('t'), shifted_key=ord('T'), mods=ctrl | alt), "\x1b" + '\x14')
|
||
ae(enc(ord('u'), shifted_key=ord('U')), 'u')
|
||
ae(enc(ord('u'), shifted_key=ord('U'), mods=shift), 'U')
|
||
ae(enc(ord('u'), shifted_key=ord('U'), mods=alt), "\x1b" + 'u')
|
||
ae(enc(ord('u'), shifted_key=ord('U'), mods=shift | alt), "\x1b" + 'U')
|
||
ae(enc(ord('u'), shifted_key=ord('U'), mods=ctrl), '\x15')
|
||
ae(enc(ord('u'), shifted_key=ord('U'), mods=ctrl | alt), "\x1b" + '\x15')
|
||
ae(enc(ord('v'), shifted_key=ord('V')), 'v')
|
||
ae(enc(ord('v'), shifted_key=ord('V'), mods=shift), 'V')
|
||
ae(enc(ord('v'), shifted_key=ord('V'), mods=alt), "\x1b" + 'v')
|
||
ae(enc(ord('v'), shifted_key=ord('V'), mods=shift | alt), "\x1b" + 'V')
|
||
ae(enc(ord('v'), shifted_key=ord('V'), mods=ctrl), '\x16')
|
||
ae(enc(ord('v'), shifted_key=ord('V'), mods=ctrl | alt), "\x1b" + '\x16')
|
||
ae(enc(ord('w'), shifted_key=ord('W')), 'w')
|
||
ae(enc(ord('w'), shifted_key=ord('W'), mods=shift), 'W')
|
||
ae(enc(ord('w'), shifted_key=ord('W'), mods=alt), "\x1b" + 'w')
|
||
ae(enc(ord('w'), shifted_key=ord('W'), mods=shift | alt), "\x1b" + 'W')
|
||
ae(enc(ord('w'), shifted_key=ord('W'), mods=ctrl), '\x17')
|
||
ae(enc(ord('w'), shifted_key=ord('W'), mods=ctrl | alt), "\x1b" + '\x17')
|
||
ae(enc(ord('x'), shifted_key=ord('X')), 'x')
|
||
ae(enc(ord('x'), shifted_key=ord('X'), mods=shift), 'X')
|
||
ae(enc(ord('x'), shifted_key=ord('X'), mods=alt), "\x1b" + 'x')
|
||
ae(enc(ord('x'), shifted_key=ord('X'), mods=shift | alt), "\x1b" + 'X')
|
||
ae(enc(ord('x'), shifted_key=ord('X'), mods=ctrl), '\x18')
|
||
ae(enc(ord('x'), shifted_key=ord('X'), mods=ctrl | alt), "\x1b" + '\x18')
|
||
ae(enc(ord('y'), shifted_key=ord('Y')), 'y')
|
||
ae(enc(ord('y'), shifted_key=ord('Y'), mods=shift), 'Y')
|
||
ae(enc(ord('y'), shifted_key=ord('Y'), mods=alt), "\x1b" + 'y')
|
||
ae(enc(ord('y'), shifted_key=ord('Y'), mods=shift | alt), "\x1b" + 'Y')
|
||
ae(enc(ord('y'), shifted_key=ord('Y'), mods=ctrl), '\x19')
|
||
ae(enc(ord('y'), shifted_key=ord('Y'), mods=ctrl | alt), "\x1b" + '\x19')
|
||
ae(enc(ord('z'), shifted_key=ord('Z')), 'z')
|
||
ae(enc(ord('z'), shifted_key=ord('Z'), mods=shift), 'Z')
|
||
ae(enc(ord('z'), shifted_key=ord('Z'), mods=alt), "\x1b" + 'z')
|
||
ae(enc(ord('z'), shifted_key=ord('Z'), mods=shift | alt), "\x1b" + 'Z')
|
||
ae(enc(ord('z'), shifted_key=ord('Z'), mods=ctrl), '\x1a')
|
||
ae(enc(ord('z'), shifted_key=ord('Z'), mods=ctrl | alt), "\x1b" + '\x1a')
|
||
# end legacy letter tests
|
||
# }}}
|
||
|
||
ae(enc(key=ord(':'), shifted_key=ord('/'), mods=shift | alt), '\x1b/')
|
||
for key in '~!@#$%^&*()_+{}|:"<>?':
|
||
ae(enc(key=ord(key), mods=alt), '\x1b' + key)
|
||
ae(enc(key=ord(' ')), ' ')
|
||
ae(enc(key=ord(' '), mods=ctrl | num_lock | caps_lock), '\0')
|
||
ae(enc(key=ord(' '), mods=ctrl), '\0')
|
||
ae(enc(key=ord(' '), mods=alt), '\x1b ')
|
||
ae(enc(key=ord(' '), mods=shift), ' ')
|
||
ae(enc(key=ord(' '), mods=ctrl | alt), '\x1b\0')
|
||
ae(enc(key=ord(' '), mods=ctrl | shift), '\0')
|
||
ae(enc(key=ord(' '), mods=alt | shift), '\x1b ')
|
||
ae(enc(key=ord('i'), mods=ctrl | shift), csi(ctrl | shift, ord('i')))
|
||
ae(enc(key=defines.GLFW_FKEY_LEFT_SHIFT), '')
|
||
ae(enc(key=defines.GLFW_FKEY_CAPS_LOCK), '')
|
||
|
||
q = partial(enc, key=ord('a'))
|
||
ae(q(), 'a')
|
||
ae(q(text='a'), 'a')
|
||
ae(q(action=repeat), 'a')
|
||
ae(q(action=release), '')
|
||
|
||
# test disambiguate
|
||
dq = partial(enc, key_encoding_flags=0b1)
|
||
ae(dq(ord('a')), 'a')
|
||
ae(dq(defines.GLFW_FKEY_ESCAPE), csi(num=27))
|
||
ae(dq(defines.GLFW_FKEY_ENTER), '\r')
|
||
ae(dq(defines.GLFW_FKEY_ENTER, mods=shift), csi(shift, 13))
|
||
ae(dq(defines.GLFW_FKEY_TAB), '\t')
|
||
ae(dq(defines.GLFW_FKEY_BACKSPACE), '\x7f')
|
||
ae(dq(defines.GLFW_FKEY_TAB, mods=shift), csi(shift, 9))
|
||
for mods in (ctrl, alt, ctrl | shift, alt | shift):
|
||
ae(dq(ord('a'), mods=mods), csi(mods, ord('a')))
|
||
ae(dq(ord(' '), mods=ctrl), csi(ctrl, ord(' ')))
|
||
for k in (defines.GLFW_FKEY_KP_PAGE_UP, defines.GLFW_FKEY_KP_0):
|
||
ae(dq(k), csi(num=k))
|
||
ae(dq(k, mods=ctrl), csi(ctrl, num=k))
|
||
ae(dq(defines.GLFW_FKEY_UP), '\x1b[A')
|
||
ae(dq(defines.GLFW_FKEY_UP, mods=ctrl), csi(ctrl, 1, trailer='A'))
|
||
|
||
# test event type reporting
|
||
tq = partial(enc, key_encoding_flags=0b10)
|
||
ae(tq(ord('a')), 'a')
|
||
ae(tq(ord('a'), action=defines.GLFW_REPEAT), csi(num='a', action=2))
|
||
ae(tq(ord('a'), action=defines.GLFW_RELEASE), csi(num='a', action=3))
|
||
ae(tq(ord('a'), action=defines.GLFW_RELEASE, mods=shift), csi(shift, num='a', action=3))
|
||
tq = partial(enc, key_encoding_flags=0b11)
|
||
ae(tq(defines.GLFW_FKEY_BACKSPACE), '\x7f')
|
||
ae(tq(defines.GLFW_FKEY_BACKSPACE, action=release), '')
|
||
tq = partial(enc, key_encoding_flags=0b11, mods=num_lock|caps_lock)
|
||
ae(tq(defines.GLFW_FKEY_ENTER), '\r')
|
||
ae(tq(defines.GLFW_FKEY_ENTER, action=release), '')
|
||
|
||
# test alternate key reporting
|
||
aq = partial(enc, key_encoding_flags=0b100)
|
||
ae(aq(ord('a')), 'a')
|
||
ae(aq(ord('a'), shifted_key=ord('A')), 'a')
|
||
ae(aq(ord('a'), mods=shift, shifted_key=ord('A')), csi(shift, 'a', shifted_key='A'))
|
||
ae(aq(ord('a'), alternate_key=ord('A')), csi(num='a', alternate_key='A'))
|
||
ae(aq(ord('a'), mods=shift, shifted_key=ord('A'), alternate_key=ord('b')), csi(shift, 'a', shifted_key='A', alternate_key='b'))
|
||
|
||
# test report all keys
|
||
kq = partial(enc, key_encoding_flags=0b1000)
|
||
ae(kq(ord('a')), csi(num='a'))
|
||
ae(kq(ord('a'), action=defines.GLFW_REPEAT), csi(num='a'))
|
||
ae(kq(ord('a'), mods=ctrl), csi(ctrl, num='a'))
|
||
ae(kq(defines.GLFW_FKEY_UP), '\x1b[A')
|
||
ae(kq(defines.GLFW_FKEY_LEFT_SHIFT), csi(num=defines.GLFW_FKEY_LEFT_SHIFT))
|
||
ae(kq(defines.GLFW_FKEY_ENTER), '\x1b[13u')
|
||
ae(kq(defines.GLFW_FKEY_ENTER, mods=ctrl), '\x1b[13;5u')
|
||
ae(kq(defines.GLFW_FKEY_TAB), '\x1b[9u')
|
||
ae(kq(defines.GLFW_FKEY_BACKSPACE), '\x1b[127u')
|
||
|
||
# test embed text
|
||
eq = partial(enc, key_encoding_flags=0b11000)
|
||
ae(eq(ord('a'), text='a'), csi(num='a', text='a'))
|
||
ae(eq(ord('a'), mods=shift, text='A'), csi(shift, num='a', text='A'))
|
||
ae(eq(ord('a'), mods=shift, text='AB'), csi(shift, num='a', text='AB'))
|
||
|
||
# test roundtripping via KeyEvent
|
||
for mods in range(64):
|
||
for action in EventType:
|
||
for key in ('ENTER', 'a', 'TAB', 'F3'):
|
||
for shifted_key in ('', 'X'):
|
||
for alternate_key in ('', 'Y'):
|
||
for text in ('', 'moose'):
|
||
ev = KeyEvent(
|
||
type=action, mods=mods, key=key, text=text, shifted_key=shifted_key, alternate_key=alternate_key,
|
||
shift=bool(mods & 1), alt=bool(mods & 2), ctrl=bool(mods & 4), super=bool(mods & 8),
|
||
hyper=bool(mods & 16), meta=bool(mods & 32)
|
||
)
|
||
ec = encode_key_event(ev)
|
||
q = decode_key_event(ec[2:-1], ec[-1])
|
||
self.ae(ev, q)
|
||
|
||
def test_encode_mouse_event(self):
|
||
NORMAL_PROTOCOL, UTF8_PROTOCOL, SGR_PROTOCOL, URXVT_PROTOCOL = range(4)
|
||
L, M, R = 1, 2, 3
|
||
protocol = SGR_PROTOCOL
|
||
|
||
def enc(button=L, action=defines.PRESS, mods=0, x=1, y=1):
|
||
return defines.test_encode_mouse(x, y, protocol, button, action, mods)
|
||
|
||
self.ae(enc(), '<0;1;1M')
|
||
self.ae(enc(action=defines.RELEASE), '<0;1;1m')
|
||
self.ae(enc(action=defines.MOVE, button=0), '<35;1;1M')
|
||
self.ae(enc(action=defines.DRAG), '<32;1;1M')
|
||
|
||
self.ae(enc(R), '<2;1;1M')
|
||
self.ae(enc(R, action=defines.RELEASE), '<2;1;1m')
|
||
self.ae(enc(R, action=defines.DRAG), '<34;1;1M')
|
||
|
||
self.ae(enc(M), '<1;1;1M')
|
||
self.ae(enc(M, action=defines.RELEASE), '<1;1;1m')
|
||
self.ae(enc(M, action=defines.DRAG), '<33;1;1M')
|
||
|
||
self.ae(enc(x=1234, y=5678), '<0;1234;5678M')
|
||
self.ae(enc(mods=defines.GLFW_MOD_SHIFT), '<4;1;1M')
|
||
self.ae(enc(mods=defines.GLFW_MOD_ALT), '<8;1;1M')
|
||
self.ae(enc(mods=defines.GLFW_MOD_CONTROL), '<16;1;1M')
|
||
|
||
def test_mapping(self):
|
||
from kitty.config import load_config
|
||
from kitty.options.utils import parse_shortcut
|
||
af = self.assertFalse
|
||
|
||
class Window:
|
||
def __init__(self, id=1):
|
||
self.key_seqs = []
|
||
self.id = id
|
||
|
||
def send_key_sequence(self, *s):
|
||
self.key_seqs.extend(s)
|
||
|
||
class TM(Mappings):
|
||
|
||
def __init__(self, *lines, active_window = Window()):
|
||
self.active_window = active_window
|
||
self.windows = [active_window]
|
||
bad_lines = []
|
||
self.options = load_config(overrides=lines, accumulate_bad_lines=bad_lines)
|
||
af(bad_lines)
|
||
self.ignore_os_keyboard_processing = False
|
||
super().__init__()
|
||
|
||
def get_active_window(self):
|
||
return self.active_window
|
||
|
||
def match_windows(self, expr: str):
|
||
for w in self.windows:
|
||
if str(w.id) == expr:
|
||
yield w
|
||
|
||
def show_error(self, title: str, msg: str) -> None:
|
||
pass
|
||
|
||
def ring_bell(self) -> None:
|
||
pass
|
||
|
||
def debug_print(self, *args, end: str = '\n') -> None:
|
||
pass
|
||
|
||
def combine(self, action_definition: str) -> bool:
|
||
self.actions.append(action_definition)
|
||
if action_definition.startswith('push_keyboard_mode '):
|
||
self.push_keyboard_mode(action_definition.partition(' ')[2])
|
||
elif action_definition == 'pop_keyboard_mode':
|
||
self.pop_keyboard_mode()
|
||
return bool(action_definition)
|
||
|
||
def set_ignore_os_keyboard_processing(self, on: bool) -> None:
|
||
self.ignore_os_keyboard_processing = on
|
||
|
||
def set_cocoa_global_shortcuts(self, opts):
|
||
return {}
|
||
|
||
def get_options(self):
|
||
return self.options
|
||
|
||
def __call__(self, *keys: str):
|
||
self.actions = []
|
||
self.active_window.key_seqs = []
|
||
consumed = []
|
||
for key in keys:
|
||
sk = parse_shortcut(key)
|
||
ev = defines.KeyEvent(sk.key, 0, 0, sk.mods)
|
||
consumed.append(self.dispatch_possible_special_key(ev))
|
||
return consumed
|
||
|
||
tm = TM('map ctrl+a new_window_with_cwd')
|
||
self.ae(tm('ctrl+a'), [True])
|
||
self.ae(tm.actions, ['new_window_with_cwd'])
|
||
|
||
tm = TM('map ctrl+f>2 set_font_size 20')
|
||
self.ae(tm('ctrl+f', '2'), [True, True])
|
||
self.ae(tm.actions, ['set_font_size 20'])
|
||
af(tm.active_window.key_seqs)
|
||
# unmatched multi key mapping should send all keys to child
|
||
self.ae(tm('ctrl+f', '1'), [True, False])
|
||
af(tm.actions)
|
||
self.ae(len(tm.active_window.key_seqs), 1) # ctrl+f should have been sent to the window
|
||
# multi-key mapping that is unmapped should send all keys to child
|
||
tm = TM('map kitty_mod+p>f')
|
||
self.ae(tm('ctrl+shift+p', 'f'), [True, False])
|
||
self.ae(len(tm.active_window.key_seqs), 1)
|
||
|
||
# unmap
|
||
tm = TM('map kitty_mod+enter')
|
||
self.ae(tm('ctrl+shift+enter'), [False])
|
||
|
||
# single key mapping overrides previous all multi-key mappings with same prefix
|
||
tm = TM('map kitty_mod+p new_window')
|
||
self.ae(tm('ctrl+shift+p', 'f'), [True, False])
|
||
self.ae(tm.actions, ['new_window'])
|
||
# multi-key mapping overrides previous single key mapping with same prefix
|
||
tm = TM('map kitty_mod+s>p new_window')
|
||
self.ae(tm('ctrl+shift+s', 'p'), [True, True])
|
||
self.ae(tm.actions, ['new_window'])
|
||
# mix of single and multi-key mappings with same prefix
|
||
tm = TM('map alt+p>1 multi1', 'map alt+p single1', 'map alt+p>2 multi2')
|
||
self.ae(tm('alt+p', '2'), [True, True])
|
||
self.ae(tm.actions, ['multi2'])
|
||
self.ae(tm('alt+p', '1'), [True, False])
|
||
af(tm.actions)
|
||
self.ae(len(tm.active_window.key_seqs), 1)
|
||
|
||
# a single multi-key mapping should not prematurely match
|
||
tm = TM('map alt+1>2>3 new_window')
|
||
self.ae(tm('alt+1', '2'), [True, True])
|
||
af(tm.actions)
|
||
tm = TM('map alt+1>2>3 new_window')
|
||
self.ae(tm('alt+1', '2', '3'), [True, True, True])
|
||
self.ae(tm.actions, ['new_window'])
|
||
|
||
# changing a multi key mapping
|
||
tm = TM('map kitty_mod+p>f new_window')
|
||
self.ae(tm('ctrl+shift+p', 'f'), [True, True])
|
||
self.ae(tm.actions, ['new_window'])
|
||
|
||
# different behavior with focus selection
|
||
tm = TM('map --when-focus-on 2 kitty_mod+t')
|
||
tm.windows.append(Window(2))
|
||
self.ae(tm('ctrl+shift+t'), [True])
|
||
tm.active_window = tm.windows[1]
|
||
self.ae(tm('ctrl+shift+t'), [False])
|
||
|
||
# modal mappings
|
||
tm = TM('map --new-mode mw --on-unknown end kitty_mod+f7', 'map --mode mw left neighboring_window left', 'map --mode mw right neighboring_window right')
|
||
self.ae(tm('ctrl+shift+f7'), [True])
|
||
self.ae(tm.actions, ['push_keyboard_mode mw'])
|
||
self.ae(tm('right'), [True])
|
||
self.ae(tm.actions, ['neighboring_window right'])
|
||
self.ae(tm('left'), [True])
|
||
self.ae(tm.actions, ['neighboring_window left'])
|
||
self.ae(tm('x'), [True])
|
||
af(tm.keyboard_mode_stack)
|
||
|
||
# modal mapping with --on-action=end must restore OS keyboard processing
|
||
tm = TM('map --new-mode mw --on-action end m', 'map --mode mw a new_window')
|
||
self.ae(tm('m', 'a'), [True, True])
|
||
self.ae(tm.actions, ['push_keyboard_mode mw', 'new_window'])
|
||
af(tm.ignore_os_keyboard_processing)
|
||
|
||
def test_match_physical_keys_removed(self):
|
||
# match_physical_keys global option has been removed in favor of per-mapping --allow-fallback
|
||
# Verify that get_shortcut does NOT match via alternate_key without per-mapping allow_fallback='ascii'
|
||
from kitty.keys import get_shortcut
|
||
from kitty.options.utils import KeyDefinition
|
||
|
||
ctrl = defines.GLFW_MOD_CONTROL
|
||
cyrillic_s = 0x441 # Cyrillic 'с'
|
||
latin_c = ord('c')
|
||
|
||
kd = KeyDefinition(definition='copy_to_clipboard') # default allow_fallback='shifted'
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd]}
|
||
|
||
# alternate_key should NOT match since default allow_fallback='shifted' (no 'ascii')
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# direct key match still works
|
||
ev = defines.KeyEvent(latin_c, 0, latin_c, ctrl)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertIsNotNone(result)
|
||
self.assertIs(result[0], kd)
|
||
|
||
def test_get_shortcut_per_mapping_fallback(self):
|
||
from kitty.keys import get_shortcut
|
||
from kitty.options.utils import KeyDefinition, KeyMapOptions, _convert_allow_fallback
|
||
|
||
ctrl = defines.GLFW_MOD_CONTROL
|
||
shift = defines.GLFW_MOD_SHIFT
|
||
cyrillic_s = 0x441 # Cyrillic 'с' (on physical 'c' key in Russian layout)
|
||
latin_c = ord('c')
|
||
|
||
def make_kd(definition='test_action', allow_fallback='shifted'):
|
||
opts = KeyMapOptions(allow_fallback=_convert_allow_fallback(allow_fallback))
|
||
return KeyDefinition(definition=definition, options=opts)
|
||
|
||
# non-ASCII key + alternate_key + allow_fallback includes ascii → match
|
||
kd_ascii = make_kd('copy', allow_fallback='ascii,shifted')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_ascii]}
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertIsNotNone(result)
|
||
self.assertIs(result[0], kd_ascii)
|
||
|
||
# sorting by fallback order
|
||
kd1 = make_kd('ascii', allow_fallback='ascii,shifted')
|
||
kd2 = make_kd('shifted', allow_fallback='shifted,ascii')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd1, kd2]}
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertEqual(result, [kd1, kd2])
|
||
keymap = {defines.SingleKey(0, False, latin_c): [kd1, kd2]}
|
||
ev = defines.KeyEvent(ord('C'), latin_c, 0, shift)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertEqual(result, [kd2, kd1])
|
||
|
||
# non-ASCII key + alternate_key + allow_fallback='shifted' (no ascii) → no ascii match
|
||
kd_shifted_only = make_kd('copy', allow_fallback='shifted')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_shifted_only]}
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# shifted_key + allow_fallback='shifted' → match
|
||
# When Shift+key pressed: key='C'(67), shifted_key='c'(99), lookup SingleKey(0, False, 'c')
|
||
kd_shifted = make_kd('zoom', allow_fallback='shifted')
|
||
keymap = {defines.SingleKey(0, False, latin_c): [kd_shifted]}
|
||
ev = defines.KeyEvent(ord('C'), latin_c, 0, shift)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertIsNotNone(result)
|
||
self.assertIs(result[0], kd_shifted)
|
||
|
||
# shifted_key + allow_fallback='ascii' (no shifted) → no shifted match
|
||
kd_ascii_only = make_kd('zoom', allow_fallback='ascii')
|
||
keymap = {defines.SingleKey(0, False, latin_c): [kd_ascii_only]}
|
||
ev = defines.KeyEvent(ord('C'), latin_c, 0, shift)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# allow_fallback='' (empty) → no fallback at all
|
||
kd_none = make_kd('copy', allow_fallback='')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_none]}
|
||
# ascii fallback blocked
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
# shifted fallback blocked
|
||
ev = defines.KeyEvent(ord('C'), latin_c, 0, ctrl | shift)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# ASCII key (Dvorak) + alternate_key → no fallback (non-ASCII guard: key must be > 127)
|
||
kd_dvorak = make_kd('test', allow_fallback='ascii,shifted')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_dvorak]}
|
||
ev = defines.KeyEvent(ord('k'), 0, latin_c, ctrl) # key='k' is ASCII
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# functional key (PUA range 0xE000+) + alternate_key → no fallback (functional keys excluded)
|
||
kd_functional = make_kd('escape_action', allow_fallback='ascii,shifted')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_functional]}
|
||
ev = defines.KeyEvent(0xE000, 0, latin_c, ctrl) # ESCAPE key (functional, PUA range)
|
||
self.assertIsNone(get_shortcut(keymap, ev))
|
||
|
||
# boundary: 0xDFFF (last codepoint before PUA) → should match via ascii fallback
|
||
kd_boundary = make_kd('boundary_action', allow_fallback='ascii,shifted')
|
||
keymap = {defines.SingleKey(ctrl, False, latin_c): [kd_boundary]}
|
||
ev = defines.KeyEvent(0xDFFF, 0, latin_c, ctrl)
|
||
self.assertIsNotNone(get_shortcut(keymap, ev))
|
||
|
||
# boundary: 128 (first non-ASCII codepoint) → should match via ascii fallback
|
||
ev = defines.KeyEvent(128, 0, latin_c, ctrl)
|
||
self.assertIsNotNone(get_shortcut(keymap, ev))
|
||
|
||
# direct key match takes priority over alternate_key fallback
|
||
kd_direct = make_kd('direct_action', allow_fallback='ascii,shifted')
|
||
kd_alt = make_kd('alt_action', allow_fallback='ascii,shifted')
|
||
keymap = {
|
||
defines.SingleKey(ctrl, False, cyrillic_s): [kd_direct],
|
||
defines.SingleKey(ctrl, False, latin_c): [kd_alt],
|
||
}
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
result = get_shortcut(keymap, ev)
|
||
self.assertIs(result[0], kd_direct) # direct match, not ascii fallback
|
||
|
||
def test_shortcut_matches_alternate_key(self):
|
||
from kitty.keys import shortcut_matches
|
||
|
||
ctrl = defines.GLFW_MOD_CONTROL
|
||
cyrillic_s = 0x441 # Cyrillic 'с'
|
||
latin_c = ord('c')
|
||
|
||
s = defines.SingleKey(ctrl, False, latin_c)
|
||
|
||
# non-ASCII key + alternate_key → match (unconditional with non-ASCII guard)
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, ctrl)
|
||
self.assertTrue(shortcut_matches(s, ev))
|
||
|
||
# ASCII key + alternate_key → no match (non-ASCII guard blocks it)
|
||
ev = defines.KeyEvent(ord('k'), 0, latin_c, ctrl)
|
||
self.assertFalse(shortcut_matches(s, ev))
|
||
|
||
# direct key match still works
|
||
ev = defines.KeyEvent(latin_c, 0, 0, ctrl)
|
||
self.assertTrue(shortcut_matches(s, ev))
|
||
|
||
# no alternate_key → no match
|
||
ev = defines.KeyEvent(cyrillic_s, 0, 0, ctrl)
|
||
self.assertFalse(shortcut_matches(s, ev))
|
||
|
||
# mods mismatch → no match even with alternate_key
|
||
ev = defines.KeyEvent(cyrillic_s, 0, latin_c, defines.GLFW_MOD_ALT)
|
||
self.assertFalse(shortcut_matches(s, ev))
|
||
|
||
# functional key (PUA range 0xE000+) + alternate_key → no match
|
||
ev = defines.KeyEvent(0xE000, 0, latin_c, ctrl) # ESCAPE key (functional)
|
||
self.assertFalse(shortcut_matches(s, ev))
|
||
|
||
def test_key_event_matches_alternate_key(self):
|
||
from kitty.key_encoding import EventType, KeyEvent
|
||
|
||
ctrl = 0x4 # CTRL modifier in kitty protocol encoding
|
||
|
||
# non-ASCII key + alternate_key → match via alternate_key fallback
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='\u0441', alternate_key='c', ctrl=True) # Cyrillic 'с'
|
||
self.assertTrue(ev.matches('ctrl+c'))
|
||
|
||
# direct key match still works
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='c', ctrl=True)
|
||
self.assertTrue(ev.matches('ctrl+c'))
|
||
|
||
# ASCII key + alternate_key → no match (non-ASCII guard: key must be non-ASCII)
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='k', alternate_key='c', ctrl=True)
|
||
self.assertFalse(ev.matches('ctrl+c'))
|
||
|
||
# no alternate_key → no match for non-ASCII key
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='\u0441', ctrl=True) # Cyrillic 'с', no alternate_key
|
||
self.assertFalse(ev.matches('ctrl+c'))
|
||
|
||
# mods mismatch → no match even with alternate_key
|
||
ev = KeyEvent(type=EventType.PRESS, mods=0x2, key='\u0441', alternate_key='c', alt=True) # ALT, not CTRL
|
||
self.assertFalse(ev.matches('ctrl+c'))
|
||
|
||
# shifted_key still works alongside alternate_key
|
||
ev = KeyEvent(type=EventType.PRESS, mods=0x1, key='C', shifted_key='c', shift=True)
|
||
self.assertTrue(ev.matches('c'))
|
||
|
||
# functional key name (multi-char key like "ENTER") → no alternate_key fallback (guard blocks it)
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='ENTER', alternate_key='c', ctrl=True)
|
||
self.assertFalse(ev.matches('ctrl+c'))
|
||
|
||
# functional key (single-char PUA 0xE000+) → no alternate_key fallback
|
||
ev = KeyEvent(type=EventType.PRESS, mods=ctrl, key='\ue000', alternate_key='c', ctrl=True)
|
||
self.assertFalse(ev.matches('ctrl+c'))
|
||
|
||
def test_allow_fallback_parsing(self):
|
||
from kitty.options.utils import parse_map
|
||
|
||
def first_kd(val):
|
||
return next(iter(parse_map(val)))
|
||
|
||
# default: no --allow-fallback → allow_fallback='shifted'
|
||
kd = first_kd('ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, (KeyFallbackType.shifted,))
|
||
|
||
# --allow-fallback=shifted,ascii
|
||
kd = first_kd('--allow-fallback=shifted,ascii ctrl+c copy_to_clipboard')
|
||
self.assertIn(KeyFallbackType.shifted, kd.options.allow_fallback)
|
||
self.assertIn(KeyFallbackType.alternate, kd.options.allow_fallback)
|
||
|
||
# --allow-fallback=ascii (only ascii, no shifted)
|
||
kd = first_kd('--allow-fallback=ascii ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, (KeyFallbackType.alternate,))
|
||
self.assertNotIn(KeyFallbackType.shifted, kd.options.allow_fallback)
|
||
|
||
# --allow-fallback=shifted (explicit, same as default)
|
||
kd = first_kd('--allow-fallback=shifted ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, (KeyFallbackType.shifted,))
|
||
|
||
# invalid value raises
|
||
self.assertRaises(ValueError, first_kd, '--allow-fallback=bogus ctrl+c copy_to_clipboard')
|
||
|
||
# order normalization: ascii,shifted → sorted as ascii,shifted
|
||
kd = first_kd('--allow-fallback=ascii,shifted ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, (KeyFallbackType.alternate, KeyFallbackType.shifted))
|
||
|
||
# --allow-fallback=none → empty string (no fallback)
|
||
kd = first_kd('--allow-fallback=none ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, ())
|
||
|
||
# combined with other options
|
||
kd = first_kd('--when-focus-on 1 --allow-fallback=ascii ctrl+c copy_to_clipboard')
|
||
self.ae(kd.options.allow_fallback, (KeyFallbackType.alternate,))
|
||
self.ae(kd.options.when_focus_on, '1')
|