Merge PR #10723: Respect mouse mappings for link hover feedback

This commit is contained in:
Kovid Goyal 2026-10-23 10:57:39 +05:30
commit 4db8bdab70
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
11 changed files with 276 additions and 21 deletions

View file

@ -235,6 +235,11 @@ Detailed list of changes
status bars, file trees, etc. Create them with :code:`launch --type=window-dock`
or :code:`launch --type=tab-dock`, see :ref:`docks`
- Show the hand pointer and hover highlighting over links only when the pressed
modifiers match a configured mouse action for opening the link with a single
click. Update both immediately when modifiers are pressed or released, even
without moving the mouse.
- A new option :opt:`restore_session_after_logout` to save the state of
every kitty instance, including the scrollback of every window, when logging
out, restarting or shutting down the computer and restore it the next time

View file

@ -12,7 +12,7 @@ from .conf.utils import BadLine, parse_config_base
from .conf.utils import load_config as _load_config
from .constants import cache_dir, defconf
from .options.types import Options, defaults, option_names
from .options.utils import KeyboardMode, KeyboardModeMap, KeyDefinition, MouseMap, MouseMapping, build_action_aliases
from .options.utils import KeyboardMode, KeyboardModeMap, KeyDefinition, MapType, MouseMap, MouseMapping, build_action_aliases
from .typing_compat import TypedDict
from .utils import log_error
@ -121,6 +121,9 @@ def finalize_keys(opts: Options, accumulate_bad_lines: list[BadLine] | None = No
def finalize_mouse_mappings(opts: Options, accumulate_bad_lines: list[BadLine] | None = None) -> None:
from .fast_data_types import GLFW_MOUSE_BUTTON_LAST
from .keys import mod_mask
defns: list[MouseMapping] = []
for d in opts.mouse_map:
if d is None: # clear_all_mouse_actions
@ -141,6 +144,17 @@ def finalize_mouse_mappings(opts: Options, accumulate_bad_lines: list[BadLine] |
else:
mousemap.pop(defn.trigger, None)
opts.mousemap = mousemap
opts.url_mappings = {False: 0, True: 0}
for event, definition in mousemap.items():
if not 0 <= event.button <= GLFW_MOUSE_BUTTON_LAST or event.mods & ~mod_mask or event.repeat_count not in (-2, -1, 1):
continue
try:
actions = opts.alias_map.resolve_aliases(definition, MapType.MOUSE_MAP)
except Exception as err:
log_error(f'Ignoring mouse_map with invalid action: {definition}. Error: {err}')
continue
if any(a.func in ('mouse_click_url', 'mouse_click_url_or_select') or (a.func == 'mouse_handle_click' and 'link' in a.args) for a in actions):
opts.url_mappings[event.grabbed] |= 1 << event.mods
def parse_config(

View file

@ -601,11 +601,15 @@ key_callback(GLFWwindow *w, GLFWkeyevent *ev) {
#ifndef __APPLE__
if (key_modifier != -1) update_modifier_state_on_modifier_key_event(ev, key_modifier, is_left);
#endif
const int old_mods = global_state.mods_at_last_key_or_button_event;
global_state.mods_at_last_key_or_button_event = ev->mods;
global_state.callback_os_window->cursor_blink_zero_time = monotonic();
global_state.callback_os_window->user_is_idle = false;
global_state.callback_os_window->shader_anim_event_registry |= (1u << SHADER_ANIM_EVENT_USER_ACTIVITY);
if (is_window_ready_for_callbacks() && !ev->fake_event_on_focus_change) on_key_input(ev);
if (is_window_ready_for_callbacks()) {
update_link_hover_for_modifiers(old_mods, ev->mods);
if (!ev->fake_event_on_focus_change) on_key_input(ev);
}
global_state.callback_os_window = NULL;
request_tick_callback();
}
@ -1611,7 +1615,8 @@ set_glfw_mouse_pointer_shape_in_window(GLFWwindow *w, MouseShape type) {
void
set_mouse_cursor(MouseShape type) {
if (global_state.callback_os_window) {
// Headless mock OS windows have no native cursor.
if (global_state.callback_os_window && global_state.callback_os_window->handle) {
GLFWwindow *w = (GLFWwindow *)global_state.callback_os_window->handle;
set_glfw_mouse_pointer_shape_in_window(w, type);
}

View file

@ -19,6 +19,8 @@ extern PyTypeObject Screen_Type;
static MouseShape mouse_cursor_shape = TEXT_POINTER;
typedef enum MouseActions { PRESS, RELEASE, DRAG, MOVE, LEAVE } MouseAction;
#define debug debug_input
#define MOUSE_MAPPING_MODS_MASK (GLFW_MOD_SHIFT | GLFW_MOD_ALT | GLFW_MOD_CONTROL | GLFW_MOD_SUPER | GLFW_MOD_HYPER | GLFW_MOD_META)
static_assert(MOUSE_MAPPING_MODS_MASK < 64, "mouse mapping modifiers must fit in a uint64_t bitmap");
static void
finish_scroll_animation(Screen *screen) {
@ -432,18 +434,23 @@ handle_mouse_movement_in_kitty(Window *w, int button, bool mouse_cell_changed) {
}
static void
detect_url(Screen *screen, unsigned int x, unsigned int y) {
detect_url(Screen *screen, unsigned int x, unsigned int y, int modifiers) {
int hid = screen_detect_url(screen, x, y);
zero_at_ptr(&screen->current_hyperlink_under_mouse);
set_mouse_cursor_for_screen(screen);
if (hid != 0) {
mouse_cursor_shape = POINTER_POINTER;
if (OPT(url_mappings)[screen->modes.mouse_tracking_mode != NO_TRACKING] & (1ull << (modifiers & MOUSE_MAPPING_MODS_MASK))) {
mouse_cursor_shape = POINTER_POINTER;
} else {
screen_mark_url(screen, 0, 0, 0, 0);
}
screen->current_hyperlink_under_mouse.has_detected_url = hid < 0;
if (hid > 0) {
screen->current_hyperlink_under_mouse.id = (hyperlink_id_type)hid;
screen->current_hyperlink_under_mouse.x = x;
screen->current_hyperlink_under_mouse.y = y;
}
} else set_mouse_cursor_for_screen(screen);
}
}
static bool
@ -721,7 +728,7 @@ HANDLER(handle_move_event) {
return;
}
Screen *screen = w->render_data.screen;
if (OPT(detect_urls)) detect_url(screen, w->mouse_pos.cell_x, w->mouse_pos.cell_y);
if (OPT(detect_urls)) detect_url(screen, w->mouse_pos.cell_x, w->mouse_pos.cell_y, modifiers);
if (should_handle_in_kitty(w, screen, button)) {
handle_mouse_movement_in_kitty(w, button, mouse_cell_changed | cell_half_changed);
} else {
@ -798,7 +805,8 @@ add_press(Window *w, int button, int modifiers) {
bool
mouse_open_url(Window *w) {
Screen *screen = w->render_data.screen;
detect_url(screen, w->mouse_pos.cell_x, w->mouse_pos.cell_y);
// Opening a URL must work even when hover highlighting is disabled.
screen_detect_url(screen, w->mouse_pos.cell_x, w->mouse_pos.cell_y);
return screen_open_url(screen, "open_url");
}
@ -1178,7 +1186,6 @@ update_mouse_pointer_shape(void) {
if (handle_scrollbar_mouse(r.window, -1, MOVE, 0)) {
mouse_cursor_shape = scrollbar_drag_mouse_cursor;
} else if (r.window->render_data.screen) {
screen_mark_url(r.window->render_data.screen, 0, 0, 0, 0);
set_mouse_cursor_for_screen(r.window->render_data.screen);
}
}
@ -1191,6 +1198,30 @@ leave_event(int modifiers) {
set_currently_hovered_window(0, modifiers, false);
}
bool
update_link_hover_for_modifiers(int old_mods, int new_mods) {
old_mods &= MOUSE_MAPPING_MODS_MASK;
new_mods &= MOUSE_MAPPING_MODS_MASK;
OSWindow *osw = global_state.callback_os_window;
if (old_mods == new_mods || !OPT(detect_urls) || !osw || !osw->num_tabs || !global_state.mouse_hover_in_window || global_state.redirect_mouse_handling ||
global_state.active_drag_in_window || global_state.tracked_drag_in_window || global_state.tab_being_dragged.id ||
global_state.window_being_dragged.id || global_state.active_drag_resize)
return false;
Tab *tab = osw->tabs + osw->active_tab;
for (unsigned i = 0; i < tab->num_windows; i++) {
Window *w = tab->windows + i;
if (w->id != global_state.mouse_hover_in_window) continue;
Screen *screen = w->render_data.screen;
if (!w->visible || !screen || w->scrollbar.is_hovering || w->scrollbar.is_dragging) return false;
const uint64_t mappings = OPT(url_mappings)[screen->modes.mouse_tracking_mode != NO_TRACKING];
if (((mappings >> old_mods) & 1) == ((mappings >> new_mods) & 1)) return false;
detect_url(screen, w->mouse_pos.cell_x, w->mouse_pos.cell_y, new_mods);
set_mouse_cursor(mouse_cursor_shape);
return true;
}
return false;
}
void
enter_event(int modifiers, bool cursor_moved) {
#ifdef __APPLE__
@ -1595,9 +1626,6 @@ mapped_scroll_steps(GLFWOffsetType offset_type, double offset, double *pending,
// Bit i of wheel_mappings[button - MOUSE_WHEEL_UP][grabbed] is set when the wheel is mapped
// with the modifiers i, so that unmapped scrolling never calls into Python.
#define WHEEL_MAPPING_MODS_MASK (GLFW_MOD_SHIFT | GLFW_MOD_ALT | GLFW_MOD_CONTROL | GLFW_MOD_SUPER | GLFW_MOD_HYPER | GLFW_MOD_META)
static_assert(WHEEL_MAPPING_MODS_MASK < 64, "wheel mapping modifiers must fit in a uint64_t bitmap");
bool
set_wheel_mappings(PyObject *py_opts, Options *opts) {
memset(opts->wheel_mappings, 0, sizeof(opts->wheel_mappings));
@ -1618,7 +1646,7 @@ set_wheel_mappings(PyObject *py_opts, Options *opts) {
const long button = PyLong_AsLong(PyTuple_GET_ITEM(key, 0)), mods = PyLong_AsLong(PyTuple_GET_ITEM(key, 1));
if (PyErr_Occurred()) return false;
// modifiers outside the mask are stripped from events, so such a mapping can never match
if (button < MOUSE_WHEEL_UP || button > MOUSE_WHEEL_RIGHT || (mods & ~WHEEL_MAPPING_MODS_MASK)) continue;
if (button < MOUSE_WHEEL_UP || button > MOUSE_WHEEL_RIGHT || (mods & ~MOUSE_MAPPING_MODS_MASK)) continue;
const int grabbed = PyObject_IsTrue(PyTuple_GET_ITEM(key, 3));
if (grabbed < 0) return false;
opts->wheel_mappings[button - MOUSE_WHEEL_UP][grabbed] |= 1ull << mods;
@ -1746,7 +1774,7 @@ scroll_event_in_window(OSWindow *osw, Window *w, const GLFWScrollEvent *ev, unsi
}
if (ev->momentum_type == GLFW_NO_MOMENTUM_DATA) {
const bool grabbed = screen->modes.mouse_tracking_mode != NO_TRACKING;
const int mods = ev->keyboard_modifiers & WHEEL_MAPPING_MODS_MASK;
const int mods = ev->keyboard_modifiers & MOUSE_MAPPING_MODS_MASK;
if (dispatch_mapped_scroll(osw, w, ev, mods, grabbed)) osw->scroll.mapped_gesture = true;
else if (osw->scroll.mapped_gesture) {
osw->scroll.mapped_gesture = continues_mapped_gesture(osw, w, ev, mods, grabbed);
@ -1937,7 +1965,7 @@ send_mock_mouse_event_to_window(PyObject *self UNUSED, PyObject *args) {
if (button == -2) do_drag_scroll(w, true);
else if (button == -3) do_drag_scroll(w, false);
else {
if (OPT(detect_urls)) detect_url(w->render_data.screen, x, y);
if (OPT(detect_urls)) detect_url(w->render_data.screen, x, y, modifiers);
handle_mouse_movement_in_kitty(w, last_button_pressed, mouse_cell_changed);
handle_potential_drag(w, last_button_pressed);
}
@ -1954,7 +1982,65 @@ send_mock_mouse_event_to_window(PyObject *self UNUSED, PyObject *args) {
}
}
}
Py_RETURN_NONE;
return PyLong_FromLong(mouse_cursor_shape);
}
static PyObject *
update_mock_pointer(PyObject *self UNUSED, PyObject *args) {
PyObject *capsule;
int old_mods, new_mods, inside = 1;
unsigned drag = 0, border = 0;
const char *pointer_shape = NULL;
if (!PyArg_ParseTuple(args, "O!ii|pIIs", &PyCapsule_Type, &capsule, &old_mods, &new_mods, &inside, &drag, &border, &pointer_shape)) return NULL;
Window *w = PyCapsule_GetPointer(capsule, "Window");
if (!w) return NULL;
Screen *screen = w->render_data.screen;
GlobalState saved = global_state;
MouseShape saved_shape = mouse_cursor_shape;
Window windows[] = {*w, *w};
windows[1].id++;
windows[0].render_data.geometry = (WindowGeometry){.right = screen->columns * 10, .bottom = screen->lines * 20};
windows[1].render_data.geometry = windows[0].render_data.geometry;
BorderRect rect = {.border_type = (int)w->id, .horizontal = border == 2};
rect.px.left = (unsigned)w->mouse_pos.global_x;
rect.px.right = rect.px.left + 1;
rect.px.top = (unsigned)w->mouse_pos.global_y;
rect.px.bottom = rect.px.top + 1;
Tab tab = {.windows = windows, .num_windows = border ? 2 : 1};
tab.border_rects.rect_buf = &rect;
tab.border_rects.num_border_rects = border ? 1 : 0;
struct {
FONTS_DATA_HEAD
} fonts = {.logical_dpi_x = 72, .logical_dpi_y = 72, .fcm = {.cell_width = 10, .cell_height = 20}};
OSWindow osw = {
.tabs = &tab,
.num_tabs = 1,
.has_too_few_tabs = true,
.fonts_data = (FONTS_DATA_HANDLE)&fonts,
.viewport_width = screen->columns * 10,
.viewport_height = screen->lines * 20,
.mouse_x = w->mouse_pos.global_x,
.mouse_y = w->mouse_pos.global_y};
global_state.callback_os_window = &osw;
global_state.mouse_hover_in_window = global_state.active_drag_in_window = global_state.tracked_drag_in_window = global_state.active_drag_resize = 0;
global_state.tab_being_dragged.id = global_state.window_being_dragged.id = 0;
global_state.redirect_mouse_handling = false;
global_state.mods_at_last_key_or_button_event = old_mods;
mouse_event(-1, old_mods, -1);
if (!inside) leave_event(old_mods);
if (drag == 1) global_state.active_drag_in_window = w->id;
else if (drag == 2) global_state.tracked_drag_in_window = w->id;
global_state.mods_at_last_key_or_button_event = new_mods;
bool updated = false;
if (pointer_shape) {
RAII_PyObject(ret, PyObject_CallMethod((PyObject *)screen, "change_pointer_shape", "ss", "=", pointer_shape));
if (ret) update_mouse_pointer_shape();
} else updated = update_link_hover_for_modifiers(old_mods, new_mods);
MouseShape result = mouse_cursor_shape;
global_state = saved;
mouse_cursor_shape = saved_shape;
if (PyErr_Occurred()) return NULL;
return Py_BuildValue("(iO)", result, updated ? Py_True : Py_False);
}
static PyObject *
@ -2031,6 +2117,7 @@ static PyMethodDef module_methods[] = {
METHODB(test_scale_scroll, METH_VARARGS),
METHODB(test_mapped_scroll_steps, METH_VARARGS),
METHODB(send_mock_mouse_event_to_window, METH_VARARGS),
METHODB(update_mock_pointer, METH_VARARGS),
METHODB(send_mock_scroll_event_to_window, METH_VARARGS),
METHODB(mock_mouse_selection, METH_VARARGS),
{NULL, NULL, 0, NULL} /* Sentinel */

View file

@ -17,7 +17,7 @@ definition = Definition(
{'keyboard_modes': 'KeyboardModeMap', 'alias_map': 'AliasMap'},
['KeyDefinition', 'KeyMapOptions', 'kitty.fast_data_types.SingleKey'],
),
Action('mouse_map', 'parse_mouse_map', {'mousemap': 'MouseMap'}, ['MouseMapping']),
Action('mouse_map', 'parse_mouse_map', {'mousemap': 'MouseMap', 'url_mappings': 'URLMappings'}, ['MouseMapping']),
has_color_table=True,
)
definition.add_deprecation('deprecated_hide_window_decorations_aliases', 'x11_hide_window_decorations', 'macos_hide_titlebar')
@ -1283,6 +1283,12 @@ grabbed by the program running in the terminal, or not. The values are
mouse events. Note that the click and double click events have a delay of
:opt:`click_interval` to disambiguate from double and triple presses.
The mouse pointer changes to a hand and links are highlighted on hover only when
the current keyboard modifiers and grabbed/ungrabbed mode match a mouse mapping
that opens the link on a single :code:`press`, :code:`release` or :code:`click`.
Both update when modifiers are pressed or released, even if the mouse does not
move. Mappings that require a double or triple click do not enable hover feedback.
You can run kitty with the :option:`kitty --debug-input` command line option
to see mouse events. See the builtin actions below to get a sense of what is
possible.

View file

@ -12,7 +12,7 @@ from kitty.fonts import FontSpec
import kitty.fonts
from kitty.options.utils import (
AliasMap, KeyDefinition, KeyFallbackType, KeyMapOptions, KeyboardModeMap, MouseHideWait, MouseMap,
MouseMapping, NotifyOnCmdFinish, TabBarMarginHeight
MouseMapping, NotifyOnCmdFinish, TabBarMarginHeight, URLMappings
)
import kitty.options.utils
from kitty.types import FloatEdges
@ -762,6 +762,7 @@ class Options:
alias_map: AliasMap = AliasMap()
mouse_map: list[kitty.options.utils.MouseMapping] = []
mousemap: MouseMap = {}
url_mappings: URLMappings = {}
color_table: "array[int]" = array("L", (
0x000000, 0xcc0403, 0x19cb00, 0xcecb00, 0x0d73cc, 0xcb1ed1, 0x0dcdcd, 0xdddddd,
0x767676, 0xf2201f, 0x23fd00, 0xfffd00, 0x1a8fff, 0xfd28ff, 0x14ffff, 0xffffff,

View file

@ -47,6 +47,7 @@ from kitty.utils import expandvars, log_error, resolve_abs_or_config_path, shlex
KeyMap = dict[SingleKey, list['KeyDefinition']]
MouseMap = dict[MouseEvent, str]
URLMappings = dict[bool, int]
KeySequence = tuple[SingleKey, ...]
MINIMUM_FONT_SIZE = 4
# Zooming is limited to a multiple of the configured font size, or to this

View file

@ -382,7 +382,11 @@ initialize_window(Window *w, PyObject *title, bool init_gpu_resources) {
if (PyErr_Occurred()) PyErr_Print();
}
if (init_gpu_resources) create_gpu_resources_for_window(w);
else { w->render_data.vao_idx = -1; }
else {
// Mock windows have no graphics context. Neither VAO may be deleted when
// the mock window is destroyed by the mouse regression tests.
w->render_data.vao_idx = w->window_title_render_data.vao_idx = -1;
}
}
static id_type
@ -1148,6 +1152,13 @@ PYWRAP1(set_options) {
global_state.debug_font_fallback = debug_font_fallback ? true : false;
if (!convert_opts_from_python_opts(opts, &global_state.opts)) return NULL;
if (!set_wheel_mappings(opts, &global_state.opts)) return NULL;
RAII_PyObject(url_mappings, PyObject_GetAttrString(opts, "url_mappings"));
if (!url_mappings) return NULL;
for (size_t i = 0; i < arraysz(global_state.opts.url_mappings); i++) {
PyObject *mask = PyDict_GetItem(url_mappings, i ? Py_True : Py_False);
global_state.opts.url_mappings[i] = mask ? PyLong_AsUnsignedLongLong(mask) : 0;
if (PyErr_Occurred()) return NULL;
}
if (!set_vertical_tab_bar_padding(opts, &global_state.opts)) return NULL;
push_modifier_remap_to_glfw();
Py_XDECREF(global_state.options_object);

View file

@ -134,6 +134,8 @@ typedef struct Options {
// wheel with the modifiers i, button is 0 for wheel_up, 1 for wheel_down,
// 2 for wheel_left and 3 for wheel_right
uint64_t wheel_mappings[4][2];
// Bit i is set when a mouse button opens the hovered URL with modifiers i.
uint64_t url_mappings[2]; // ungrabbed, grabbed
bool window_alert_on_bell;
bool macos_dock_badge_on_bell;
bool debug_keyboard;
@ -849,6 +851,7 @@ void update_menu_bar_title(PyObject *title UNUSED);
void change_live_resize_state(OSWindow *, bool);
bool render_os_window(OSWindow *w, monotonic_t now, bool scan_for_animated_images);
void update_mouse_pointer_shape(void);
bool update_link_hover_for_modifiers(int old_mods, int new_mods);
void adjust_window_size_for_csd(OSWindow *w, int width, int height, int *adjusted_width, int *adjusted_height);
void dispatch_buffered_keys(Window *w);
void free_buffered_keys(Window *w);

View file

@ -4,10 +4,13 @@
from functools import partial
from time import sleep
from kitty.config import load_config
from kitty.fast_data_types import (
GLFW_MOD_ALT,
GLFW_MOD_CAPS_LOCK,
GLFW_MOD_CONTROL,
GLFW_MOD_SHIFT,
GLFW_MOD_SUPER,
GLFW_MOUSE_BUTTON_LEFT,
GLFW_MOUSE_BUTTON_RIGHT,
MOUSE_SELECTION_WORD_AND_LINE_FROM_POINT,
@ -16,6 +19,7 @@ from kitty.fast_data_types import (
send_mock_mouse_event_to_window,
send_mock_scroll_event_to_window,
set_options,
update_mock_pointer,
)
from .base import BaseTest, parse_bytes
@ -34,10 +38,127 @@ def send_mouse_event(
):
ix = int(x)
in_left_half_of_cell = x - ix < 0.5
send_mock_mouse_event_to_window(window, button, modifiers, is_release, ix, y, clear_click_queue, in_left_half_of_cell, pixel_x, pixel_y)
return send_mock_mouse_event_to_window(window, button, modifiers, is_release, ix, y, clear_click_queue, in_left_half_of_cell, pixel_x, pixel_y)
class TestMouse(BaseTest):
def test_link_hover_modifiers(self):
s = self.create_screen(cols=60)
s.draw('https://example.invalid/')
parse_bytes(s, b'\r\n\x1b]8;;https://example.invalid/\x1b\\hyperlink\x1b]8;;\x1b\\\r\nsrc/file.py:42')
w = create_mock_window(s)
hover = partial(send_mouse_event, w, x=2)
normal_shape = send_mouse_event(w, x=50)
link_shape = hover()
self.assertNotEqual(normal_shape, link_shape)
def configure(*lines):
set_options(load_config(overrides=('clear_all_mouse_actions yes', 'detect_url_regex [[:alnum:]_./-]+:[0-9]+', *lines)))
def check(mods, clickable, y=0):
self.ae(hover(modifiers=mods, y=y), link_shape if clickable else normal_shape)
expected = ('https://example.invalid/', 'hyperlink', 'src/file.py:42')[y] if clickable else ''
self.ae(''.join(s.text_for_marked_url()), expected)
# The renderer uses bit 1 of the selection buffer for URL underlines.
self.ae(sum(bool(cell & 2) for cell in s.current_selections()), len(expected))
mods = GLFW_MOD_CONTROL | GLFW_MOD_SHIFT
configure('mouse_map ctrl+shift+left release grabbed,ungrabbed mouse_handle_click link')
for y in (0, 1, 2):
for held, clickable in (
(0, False),
(GLFW_MOD_CONTROL, False),
(mods, True),
(mods | GLFW_MOD_ALT, False),
(mods | GLFW_MOD_CAPS_LOCK, True),
(0, False),
):
# Repeated events in the same cell must respond to modifier changes.
check(held, clickable, y)
configure('mouse_map left click ungrabbed mouse_handle_click selection link prompt')
check(0, True)
check(mods, False)
parse_bytes(s, b'\x1b[?1000h')
normal_shape = send_mouse_event(w, x=50)
check(0, False)
configure('mouse_map alt+left release grabbed mouse_click_url')
check(GLFW_MOD_ALT, True)
check(0, False)
parse_bytes(s, b'\x1b[?1000l')
normal_shape = send_mouse_event(w, x=50)
check(GLFW_MOD_ALT, False)
configure('action_alias follow_link mouse_handle_click link', 'mouse_map alt+left release ungrabbed follow_link')
check(GLFW_MOD_ALT, True)
check(0, False)
configure('mouse_map left click ungrabbed combine : mouse_handle_click link : discard_event')
check(0, True)
configure('mouse_map left click ungrabbed mouse_click_url_or_select')
check(0, True)
configure('mouse_map left click ungrabbed mouse_click_url', 'mouse_map left click ungrabbed')
check(0, False)
for event in ('press', 'release', 'click'):
configure(f'mouse_map cmd+left {event} ungrabbed mouse_handle_click link')
check(GLFW_MOD_SUPER, True)
check(0, False)
for event in ('doublepress', 'triplepress', 'doubleclick'):
configure(f'mouse_map left {event} ungrabbed mouse_click_url')
check(0, False)
def test_link_hover_key_events(self):
s = self.create_screen(cols=60)
s.draw('https://example.invalid/')
w = create_mock_window(s)
link_shape = send_mouse_event(w, x=2)
mods = GLFW_MOD_CONTROL | GLFW_MOD_SHIFT
set_options(
load_config(
overrides=(
'clear_all_mouse_actions yes',
'mouse_map ctrl+shift+left release grabbed,ungrabbed mouse_handle_click link',
'mouse_map cmd+left release grabbed,ungrabbed mouse_handle_click link',
)
)
)
for tracking in (False, True):
parse_bytes(s, b'\x1b[?1000h' if tracking else b'\x1b[?1000l')
normal_shape = send_mouse_event(w, x=50)
send_mouse_event(w, x=2)
for held in (mods, GLFW_MOD_SUPER):
for old, new, highlighted in ((0, held, True), (held, 0, False)):
self.ae(update_mock_pointer(w, old, new), (link_shape if highlighted else normal_shape, True))
self.ae(bool(''.join(s.text_for_marked_url())), highlighted)
self.ae(update_mock_pointer(w, 0, held, False)[1], False)
self.ae(''.join(s.text_for_marked_url()), '')
for old, new in ((0, GLFW_MOD_SHIFT), (mods, GLFW_MOD_SUPER), (mods, mods | GLFW_MOD_CAPS_LOCK)):
self.ae(update_mock_pointer(w, old, new)[1], False)
for drag in (1, 2):
self.ae(update_mock_pointer(w, 0, mods, True, drag)[1], False)
def test_link_hover_preserves_border_cursor(self):
s = self.create_screen(cols=60)
s.draw('https://example.invalid/')
w = create_mock_window(s)
send_mouse_event(w, x=2)
mods = GLFW_MOD_CONTROL | GLFW_MOD_SHIFT
for border in (1, 2):
shape, updated = update_mock_pointer(w, 0, 0, True, 0, border)
self.ae(updated, False)
self.ae(update_mock_pointer(w, 0, mods, True, 0, border), (shape, False))
def test_pointer_shape_during_mouse_drag(self):
s = self.create_screen(cols=60)
parse_bytes(s, b'\x1b[?1000h')
w = create_mock_window(s)
for drag in (1, 2):
for name in ('grabbing', 'ew-resize'):
s.change_pointer_shape('=', name)
expected = send_mouse_event(w, x=2)
s.change_pointer_shape('=', 'text')
self.ae(update_mock_pointer(w, 0, 0, True, drag, 0, name)[0], expected)
def test_mouse_selection(self):
s = self.create_screen(options=dict(rectangle_select_modifiers=GLFW_MOD_ALT | GLFW_MOD_CONTROL))
w = create_mock_window(s)

View file

@ -130,7 +130,7 @@ class TestSelectionDrag(BaseTest):
self.ae(drags, ['alpha'])
def test_selection_drag_links(self):
s, ev, drags = self.drag_screen()
s, ev, drags = self.drag_screen('mouse_map left click ungrabbed')
s.draw('https://example.com')
urls = []
s.callbacks.drag_url = lambda url, hyperlink_id: urls.append(url)
@ -142,6 +142,7 @@ class TestSelectionDrag(BaseTest):
self.ae(urls, [])
s.clear_selection()
ev(x=10)
self.assertNotIn(2, s.current_selections())
ev(LEFT, x=10, clear_click_queue=True)
ev(x=11)
self.ae(urls, ['https://example.com'])