#!/usr/bin/env python3 # vim:fileencoding=utf-8 # License: GPL v3 Copyright: 2017, Kovid Goyal import os import re import sys from collections import deque from .conf.utils import resolve_config from .constants import appname, defconf, is_macos, is_wayland, str_version CONFIG_HELP = '''\ Specify a path to the configuration file(s) to use. All configuration files are merged onto the builtin {conf_name}.conf, overriding the builtin values. This option can be specified multiple times to read multiple configuration files in sequence, which are merged. Use the special value NONE to not load a config file. If this option is not specified, config files are searched for in the order: :file:`$XDG_CONFIG_HOME/{appname}/{conf_name}.conf`, :file:`~/.config/{appname}/{conf_name}.conf`, {macos_confpath} :file:`$XDG_CONFIG_DIRS/{appname}/{conf_name}.conf`. The first one that exists is used as the config file. If the environment variable :env:`KITTY_CONFIG_DIRECTORY` is specified, that directory is always used and the above searching does not happen. If :file:`/etc/xdg/{appname}/{conf_name}.conf` exists it is merged before (i.e. with lower priority) than any user config files. It can be used to specify system-wide defaults for all users. '''.replace( '{macos_confpath}', (':file:`~/Library/Preferences/{appname}/{conf_name}.conf`,' if is_macos else ''), 1 ) def surround(x, start, end): if sys.stdout.isatty(): x = '\033[{}m{}\033[{}m'.format(start, x, end) return x def emph(x): return surround(x, 91, 39) def cyan(x): return surround(x, 96, 39) def green(x): return surround(x, 32, 39) def blue(x): return surround(x, 34, 39) def yellow(x): return surround(x, 93, 39) def italic(x): return surround(x, 3, 23) def bold(x): return surround(x, 1, 22) def title(x): return blue(bold(x)) def opt(text): return text def option(x): idx = x.find('-') if idx > -1: x = x[idx:] parts = map(bold, x.split()) return ' '.join(parts) def code(x): return x def kbd(x): return x def env(x): return italic(x) def file(x): return italic(x) def parse_option_spec(spec=None): if spec is None: spec = options_spec() NORMAL, METADATA, HELP = 'NORMAL', 'METADATA', 'HELP' state = NORMAL lines = spec.splitlines() prev_line = '' seq = [] disabled = [] mpat = re.compile('([a-z]+)=(.+)') current_cmd = None for line in lines: line = line.rstrip() if state is NORMAL: if not line: continue if line.startswith('# '): seq.append(line[2:]) continue if line.startswith('--'): parts = line.split(' ') current_cmd = {'dest': parts[0][2:].replace('-', '_'), 'aliases': frozenset(parts), 'help': ''} state = METADATA continue raise ValueError('Invalid option spec, unexpected line: {}'.format(line)) elif state is METADATA: m = mpat.match(line) if m is None: state = HELP current_cmd['help'] += line else: k, v = m.group(1), m.group(2) if k == 'condition': v = eval(v) current_cmd[k] = v if k == 'choices': current_cmd['choices'] = {x.strip() for x in current_cmd['choices'].split(',')} elif state is HELP: if line: spc = '' if current_cmd['help'].endswith('\n') else ' ' current_cmd['help'] += spc + line else: if prev_line: current_cmd['help'] += '\n\n' else: state = NORMAL (seq if current_cmd.get('condition', True) else disabled).append(current_cmd) current_cmd = None prev_line = line if current_cmd is not None: (seq if current_cmd.get('condition', True) else disabled).append(current_cmd) return seq, disabled def prettify(text): role_map = globals() def sub(m): role, text = m.group(1, 2) return role_map[role](text) text = re.sub(r':([a-z]+):`([^`]+)`', sub, text) return text def prettify_rst(text): return re.sub(r':([a-z]+):`([^`]+)`(=[^\s.]+)', r':\1:`\2`:code:`\3`', text) def version(add_rev=False): rev = '' from . import fast_data_types if add_rev and hasattr(fast_data_types, 'KITTY_VCS_REV'): rev = ' ({})'.format(fast_data_types.KITTY_VCS_REV[:10]) return '{} {}{} created by {}'.format(italic(appname), green(str_version), rev, title('Kovid Goyal')) def wrap(text, limit=80): NORMAL, IN_FORMAT = 'NORMAL', 'IN_FORMAT' state = NORMAL last_space_at = None chars_in_line = 0 breaks = [] for i, ch in enumerate(text): if state is IN_FORMAT: if ch == 'm': state = NORMAL continue if ch == '\033': state = IN_FORMAT continue if ch == ' ': last_space_at = i if chars_in_line < limit: chars_in_line += 1 continue if last_space_at is not None: breaks.append(last_space_at) last_space_at = None chars_in_line = i - breaks[-1] lines = [] for b in reversed(breaks): lines.append(text[b:].lstrip()) text = text[:b] if text: lines.append(text) return reversed(lines) def get_defaults_from_seq(seq): ans = {} for opt in seq: if not isinstance(opt, str): ans[opt['dest']] = defval_for_opt(opt) return ans default_msg = ('''\ Run the :italic:`{appname}` terminal emulator. You can also specify the :italic:`program` to run inside :italic:`{appname}` as normal arguments following the :italic:`options`. For example: {appname} /bin/sh For comprehensive documentation for kitty, please see: https://sw.kovidgoyal.net/kitty''').format(appname=appname) def print_help_for_seq(seq, usage, message, appname): from kitty.utils import screen_size_function screen_size = screen_size_function() try: linesz = min(screen_size().cols, 76) except EnvironmentError: linesz = 76 blocks = [] a = blocks.append def wa(text, indent=0, leading_indent=None): if leading_indent is None: leading_indent = indent j = '\n' + (' ' * indent) lines = [] for l in text.splitlines(): if l: lines.extend(wrap(l, limit=linesz - indent)) else: lines.append('') a((' ' * leading_indent) + j.join(lines)) usage = '[program-to-run ...]' if usage is None else usage optstring = '[options] ' if seq else '' a('{}: {} {}{}'.format(title('Usage'), bold(yellow(appname)), optstring, usage)) a('') message = message or default_msg wa(prettify(message)) a('') if seq: a('{}:'.format(title('Options'))) for opt in seq: if isinstance(opt, str): a('{}:'.format(title(opt))) continue help_text = opt['help'] if help_text == '!': continue # hidden option a(' ' + ', '.join(map(green, sorted(opt['aliases'])))) if not opt.get('type', '').startswith('bool-'): blocks[-1] += '={}'.format(italic(opt['dest'].upper())) if opt.get('help'): defval = opt.get('default') t = help_text.replace('%default', str(defval)) wa(prettify(t.strip()), indent=4) if defval is not None: wa('Default: {}'.format(defval), indent=4) if 'choices' in opt: wa('Choices: {}'.format(', '.join(opt['choices'])), indent=4) a('') text = '\n'.join(blocks) + '\n\n' + version() if print_help_for_seq.allow_pager and sys.stdout.isatty(): import subprocess p = subprocess.Popen(['less', '-isRXF'], stdin=subprocess.PIPE) try: p.communicate(text.encode('utf-8')) except KeyboardInterrupt: raise SystemExit(1) raise SystemExit(p.wait()) else: print(text) print_help_for_seq.allow_pager = True def seq_as_rst(seq, usage, message, appname, heading_char='-'): import textwrap blocks = [] a = blocks.append usage = '[program-to-run ...]' if usage is None else usage optstring = '[options] ' if seq else '' a('.. highlight:: sh') a('.. code-block:: sh') a('') a(' {} {}{}'.format(appname, optstring, usage)) a('') message = message or default_msg a(prettify_rst(message)) a('') if seq: a('Options') a(heading_char * 30) for opt in seq: if isinstance(opt, str): a(opt) a('~' * (len(opt) + 10)) continue help_text = opt['help'] if help_text == '!': continue # hidden option defn = '.. option:: ' if not opt.get('type', '').startswith('bool-'): val_name = ' <{}>'.format(opt['dest'].upper()) else: val_name = '' a(defn + ', '.join(o + val_name for o in sorted(opt['aliases']))) if opt.get('help'): defval = opt.get('default') t = help_text.replace('%default', str(defval)).strip() a('') a(textwrap.indent(prettify_rst(t), ' ' * 4)) if defval is not None: a(textwrap.indent('Default: :code:`{}`'.format(defval), ' ' * 4)) if 'choices' in opt: a(textwrap.indent('Choices: :code:`{}`'.format(', '.join(sorted(opt['choices']))), ' ' * 4)) a('') text = '\n'.join(blocks) return text def defval_for_opt(opt): dv = opt.get('default') typ = opt.get('type', '') if typ.startswith('bool-'): if dv is None: dv = False if typ == 'bool-set' else True else: dv = dv.lower() in ('true', 'yes', 'y') elif typ == 'list': dv = [] elif typ in ('int', 'float'): dv = (int if typ == 'int' else float)(dv or 0) return dv class Options: def __init__(self, seq, usage, message, appname): self.alias_map = {} self.seq = seq self.names_map = {} self.values_map = {} self.usage, self.message, self.appname = usage, message, appname for opt in seq: if isinstance(opt, str): continue for alias in opt['aliases']: self.alias_map[alias] = opt name = opt['dest'] self.names_map[name] = opt self.values_map[name] = defval_for_opt(opt) def opt_for_alias(self, alias): opt = self.alias_map.get(alias) if opt is None: raise SystemExit('Unknown option: {}'.format(emph(alias))) return opt def needs_arg(self, alias): if alias in ('-h', '--help'): print_help_for_seq(self.seq, self.usage, self.message, self.appname or appname) raise SystemExit(0) opt = self.opt_for_alias(alias) if opt['dest'] == 'version': print(version()) raise SystemExit(0) typ = opt.get('type', '') return not typ.startswith('bool-') def process_arg(self, alias, val=None): opt = self.opt_for_alias(alias) typ = opt.get('type', '') name = opt['dest'] nmap = {'float': float, 'int': int} if typ == 'bool-set': self.values_map[name] = True elif typ == 'bool-reset': self.values_map[name] = False elif typ == 'list': self.values_map.setdefault(name, []) self.values_map[name].append(val) elif typ == 'choices': choices = opt['choices'] if val not in choices: raise SystemExit('{} is not a valid value for the {} option. Valid values are: {}'.format( val, emph(alias), ', '.join(choices))) self.values_map[name] = val elif typ in nmap: f = nmap[typ] try: self.values_map[name] = f(val) except Exception: raise SystemExit('{} is not a valid value for the {} option, a number is required.'.format( val, emph(alias))) else: self.values_map[name] = val class Namespace: def __init__(self, kwargs): for name in kwargs: setattr(self, name, kwargs[name]) def parse_cmdline(oc, disabled, args=None): NORMAL, EXPECTING_ARG = 'NORMAL', 'EXPECTING_ARG' state = NORMAL if args is None: args = sys.argv[1:] args = deque(args) current_option = None while args: arg = args.popleft() if state is NORMAL: if arg.startswith('-'): if arg == '--': break parts = arg.split('=', 1) needs_arg = oc.needs_arg(parts[0]) if not needs_arg: if len(parts) != 1: raise SystemExit('The {} option does not accept arguments'.format(emph(parts[0]))) oc.process_arg(parts[0]) continue if len(parts) == 1: current_option = parts[0] state = EXPECTING_ARG continue oc.process_arg(parts[0], parts[1]) else: args = [arg] + list(args) break else: oc.process_arg(current_option, arg) current_option, state = None, NORMAL if state is EXPECTING_ARG: raise SystemExit('An argument is required for the option: {}'.format(emph(arg))) ans = Namespace(oc.values_map) for opt in disabled: setattr(ans, opt['dest'], defval_for_opt(opt)) return ans, list(args) def options_spec(): if not hasattr(options_spec, 'ans'): OPTIONS = ''' --class dest=cls default={appname} condition=not is_macos Set the class part of the :italic:`WM_CLASS` window property. On Wayland, it sets the app id. --name condition=not is_macos Set the name part of the :italic:`WM_CLASS` property (defaults to using the value from :option:`{appname} --class`) --title -T Set the window title. This will override any title set by the program running inside kitty. So only use this if you are running a program that does not set titles. If combined with :option:`{appname} --session` the title will be used for all windows created by the session, that do not set their own titles. --config -c type=list {config_help} --override -o type=list Override individual configuration options, can be specified multiple times. Syntax: :italic:`name=value`. For example: :option:`kitty -o` font_size=20 --directory -d default=. Change to the specified directory when launching --detach type=bool-set condition=not is_macos Detach from the controlling terminal, if any --session Path to a file containing the startup :italic:`session` (tabs, windows, layout, programs). See the README file for details and an example. --hold type=bool-set Remain open after child process exits. Note that this only affects the first window. You can quit by either using the close window shortcut or :kbd:`Ctrl+d`. --single-instance -1 type=bool-set If specified only a single instance of :italic:`{appname}` will run. New invocations will instead create a new top-level window in the existing :italic:`{appname}` instance. This allows :italic:`{appname}` to share a single sprite cache on the GPU and also reduces startup time. You can also have separate groups of :italic:`{appname}` instances by using the :option:`kitty --instance-group` option --instance-group Used in combination with the :option:`kitty --single-instance` option. All :italic:`{appname}` invocations with the same :option:`kitty --instance-group` will result in new windows being created in the first :italic:`{appname}` instance within that group --wait-for-single-instance-window-close type=bool-set Normally, when using :option:`--single-instance`, :italic:`{appname}` will open a new window in an existing instance and quit immediately. With this option, it will not quit till the newly opened window is closed. Note that if no previous instance is found, then :italic:`{appname}` will wait anyway, regardless of this option. --listen-on Tell kitty to listen on the specified address for control messages. For example, :option:`{appname} --listen-on`=unix:/tmp/mykitty or :option:`{appname} --listen-on`=tcp:localhost:12345. On Linux systems, you can also use abstract UNIX sockets, not associated with a file, like this: :option:`{appname} --listen-on`=unix:@mykitty. To control kitty, you can send it commands with :italic:`kitty @` using the :option:`kitty @ --to` option to specify this address. This option will be ignored, unless you set :opt:`allow_remote_control` to yes in :file:`kitty.conf`. Note that if you run :italic:`kitty @` within a kitty window, there is no need to specify the :italic:`--to` option as it is read automatically from the environment. --start-as type=choices default=normal choices=normal,fullscreen,maximized,minimized Control how the initial kitty window is created. # Debugging options --version -v type=bool-set The current {appname} version --dump-commands type=bool-set Output commands received from child process to stdout --replay-commands Replay previously dumped commands. Specify the path to a dump file previously created by --dump-commands. You can open a new kitty window to replay the commands with:: kitty sh -c "kitty --replay-commands /path/to/dump/file; read" --dump-bytes Path to file in which to store the raw bytes received from the child process --debug-gl type=bool-set Debug OpenGL commands. This will cause all OpenGL calls to check for errors instead of ignoring them. Useful when debugging rendering problems --debug-keyboard type=bool-set This option will cause kitty to print out key events as they are received --debug-font-fallback type=bool-set Print out information about the selection of fallback fonts for characters not present in the main font. --debug-config type=bool-set Print out information about the system and kitty configuration. --execute -e type=bool-set ! ''' options_spec.ans = OPTIONS.format( appname=appname, config_help=CONFIG_HELP.format(appname=appname, conf_name=appname) ) return options_spec.ans def options_for_completion(): raw = '--help -h\ntype=bool-set\nShow help for {appname} command line options\n\n{raw}'.format( appname=appname, raw=options_spec()) return parse_option_spec(raw)[0] def option_spec_as_rst(ospec=options_spec, usage=None, message=None, appname=None, heading_char='-'): options = parse_option_spec(ospec()) seq, disabled = options oc = Options(seq, usage, message, appname) return seq_as_rst(oc.seq, oc.usage, oc.message, oc.appname, heading_char=heading_char) def parse_args(args=None, ospec=options_spec, usage=None, message=None, appname=None): options = parse_option_spec(ospec()) seq, disabled = options oc = Options(seq, usage, message, appname) return parse_cmdline(oc, disabled, args=args) SYSTEM_CONF = '/etc/xdg/kitty/kitty.conf' def print_shortcut(key_sequence, action): if not getattr(print_shortcut, 'maps', None): from kitty.keys import defines v = vars(defines) mmap = {m[len('GLFW_MOD_'):].lower(): x for m, x in v.items() if m.startswith('GLFW_MOD_')} kmap = {k[len('GLFW_KEY_'):].lower(): x for k, x in v.items() if k.startswith('GLFW_KEY_')} krmap = {v: k for k, v in kmap.items()} print_shortcut.maps = mmap, krmap mmap, krmap = print_shortcut.maps keys = [] for key in key_sequence: names = [] mods, is_native, key = key for name, val in mmap.items(): if mods & val: names.append(name) if key: if is_native: from .fast_data_types import GLFW_KEY_UNKNOWN, glfw_get_key_name names.append(glfw_get_key_name(GLFW_KEY_UNKNOWN, key)) else: names.append(krmap[key]) keys.append('+'.join(names)) print('\t', ' > '.join(keys), action) def print_shortcut_changes(defns, text, changes): if changes: print(title(text)) for k in sorted(changes): print_shortcut(k, defns[k]) def compare_keymaps(final, initial): added = set(final) - set(initial) removed = set(initial) - set(final) changed = {k for k in set(final) & set(initial) if final[k] != initial[k]} print_shortcut_changes(final, 'Added shortcuts:', added) print_shortcut_changes(initial, 'Removed shortcuts:', removed) print_shortcut_changes(final, 'Changed shortcuts:', changed) def flatten_sequence_map(m): ans = {} for k, rest_map in m.items(): for r, action in rest_map.items(): ans[(k,) + (r)] = action return ans def compare_opts(opts): from .config import defaults, load_config print('\nConfig options different from defaults:') default_opts = load_config() changed_opts = [ f for f in sorted(defaults._fields) if f not in ('key_definitions', 'keymap', 'sequence_map') and getattr(opts, f) != getattr(defaults, f) ] field_len = max(map(len, changed_opts)) if changed_opts else 20 fmt = '{{:{:d}s}}'.format(field_len) for f in changed_opts: print(title(fmt.format(f)), getattr(opts, f)) final, initial = opts.keymap, default_opts.keymap final = {(k,): v for k, v in final.items()} initial = {(k,): v for k, v in initial.items()} final_s, initial_s = map(flatten_sequence_map, (opts.sequence_map, default_opts.sequence_map)) final.update(final_s) initial.update(initial_s) compare_keymaps(final, initial) def create_opts(args, debug_config=False, accumulate_bad_lines=None): from .config import load_config config = tuple(resolve_config(SYSTEM_CONF, defconf, args.config)) if debug_config: print(version(add_rev=True)) print(' '.join(os.uname())) if is_macos: import subprocess print(' '.join(subprocess.check_output(['sw_vers']).decode('utf-8').splitlines()).strip()) if os.path.exists('/etc/issue'): print(open('/etc/issue', encoding='utf-8', errors='replace').read().strip()) if os.path.exists('/etc/lsb-release'): print(open('/etc/lsb-release', encoding='utf-8', errors='replace').read().strip()) config = tuple(x for x in config if os.path.exists(x)) if config: print(green('Loaded config files:'), ', '.join(config)) overrides = (a.replace('=', ' ', 1) for a in args.override or ()) opts = load_config(*config, overrides=overrides, accumulate_bad_lines=accumulate_bad_lines) if debug_config: if not is_macos: print('Running under:', green('Wayland' if is_wayland(opts) else 'X11')) compare_opts(opts) return opts