Files
kitty-mirror/kitty/rc/disable_ligatures.py
2026-08-05 05:32:56 +05:30

64 lines
2.2 KiB
Python

#!/usr/bin/env python
# License: GPLv3 Copyright: 2020, Kovid Goyal <kovid at kovidgoyal.net>
from typing import TYPE_CHECKING
from .base import MATCH_TAB_OPTION, MATCH_WINDOW_OPTION, ArgsType, Boss, PayloadGetType, PayloadType, RCOptions, RemoteCommand, ResponseType, Window
if TYPE_CHECKING:
from kitty.cli_stub import DisableLigaturesRCOptions as CLIOptions
class DisableLigatures(RemoteCommand):
protocol_spec = __doc__ = """
strategy+/choices.never.always.cursor: One of :code:`never`, :code:`always` or :code:`cursor`
match_window/str: Window to change opacity in
match_tab/str: Tab to change opacity in
all/bool: Boolean indicating operate on all windows
"""
short_desc = 'Control ligature rendering'
desc = (
'Control ligature rendering for the specified windows/tabs (defaults to active window). The :italic:`STRATEGY`'
' can be one of: :code:`never`, :code:`always`, :code:`cursor`.'
)
options_spec = (
"""\
--all -a
type=bool-set
By default, ligatures are only affected in the active window. This option will
cause ligatures to be changed in all windows.
"""
+ '\n\n'
+ MATCH_WINDOW_OPTION
+ '\n\n'
+ MATCH_TAB_OPTION.replace('--match -m', '--match-tab -t')
)
args = RemoteCommand.Args(spec='STRATEGY', count=1, json_field='strategy')
def message_to_kitty(self, global_opts: RCOptions, opts: 'CLIOptions', args: ArgsType) -> PayloadType:
if not args:
self.fatal('You must specify the STRATEGY for disabling ligatures, must be one of never, always or cursor')
strategy = args[0]
if strategy not in ('never', 'always', 'cursor'):
self.fatal(f'{strategy} is not a valid disable_ligatures strategy')
return {
'strategy': strategy,
'match_window': opts.match,
'match_tab': opts.match_tab,
'all': opts.all,
}
def response_from_kitty(self, boss: Boss, window: Window | None, payload_get: PayloadGetType) -> ResponseType:
windows = self.windows_for_payload(boss, window, payload_get)
boss.disable_ligatures_in(windows, payload_get('strategy'))
return None
# }}}
disable_ligatures = DisableLigatures()