'kitty' not defined on example python kitty's

[hedefalk]

Hi,

I'm having some Python issues with trying to run kitten examples:

✗ cat ~/.config/kitty/mykitten.py 

from typing import List

def main(args: List[str]) -> str:
    # this is the main entry point of the kitten, it will be executed in
    # the overlay window when the kitten is launched
    answer = input('Enter some text: ')
    # whatever this function returns will be available in the
    # handle_result() function
    return answer

def handle_result(args: List[str], answer: str, target_window_id: int, boss: kitty.boss.Boss) -> None:
    # get the kitty window into which to paste answer
    w = boss.window_id_map.get(target_window_id)
    if w is not None:
        w.paste(answer)

And running it manually I get python errors

❯ kitty +kitten mykitten.py
Traceback (most recent call last):
  File "lib/python3.8/runpy.py", line 282, in run_path
  File "lib/python3.8/runpy.py", line 87, in _run_code
  File "__main__.py", line 127, in <module>
  File "__main__.py", line 118, in main
  File "__main__.py", line 75, in namespaced
  File "__main__.py", line 65, in run_kitten
  File "kittens/runner.py", line 117, in run_kitten
  File "lib/python3.8/runpy.py", line 265, in run_path
  File "lib/python3.8/runpy.py", line 97, in _run_module_code
  File "lib/python3.8/runpy.py", line 87, in _run_code
  File "/Users/viktor/.config/kitty/mykitten.py", line 11, in <module>
    def handle_result(args: List[str], answer: str, target_window_id: int, boss: kitty.boss.Boss) -> None:
NameError: name 'kitty' is not defined

✗ kitty --debug-config
kitty 0.19.2 created by Kovid Goyal
Darwin polina 20.1.0 Darwin Kernel Version 20.1.0: Sat Oct 31 00:07:11 PDT 2020; root:xnu-7195.50.7~2/RELEASE_X86_64 x86_64
ProductName:	macOS ProductVersion:	11.0.1 BuildVersion:	20B50
Loaded config files: /Users/viktor/.config/kitty/kitty.conf

Config options different from defaults:
allow_remote_control y
editor               /usr/local/bin/code
enabled_layouts      ['splits:split_axis=horizontal']
font_family          JetBrains Mono
font_size            13.0
open_url_modifiers   8
shell                /usr/local/bin/fish --login
tab_bar_edge         1
tab_bar_style        separator
url_prefixes         ('http', 'https', 'file', 'ftp', '/')
Added shortcuts:
	f11 KeyAction(func='kitten', args=['zoom_toggle.py'])
	control+right KeyAction(func='neighboring_window', args=['right'])
	control+left KeyAction(func='neighboring_window', args=['left'])
	super+d KeyAction(func='launch', args=['--location=vsplit'])
	shift+super+enter KeyAction(func='kitten', args=['zoom_toggle.py'])
Changed shortcuts:
	shift+control+p > n KeyAction(func='kitten', args=['hints', '--type linenum --linenum-action=background /usr/local/bin/code -g {path}:{line}'])
	shift+control+right KeyAction(func='resize_window', args=['wider', 1])
	shift+control+left KeyAction(func='resize_window', args=['narrower', 1])
	shift+control+down KeyAction(func='resize_window', args=['shorter', 3])
	shift+control+up KeyAction(func='resize_window', args=['taller', 1])
	super+1 KeyAction(func='goto_tab', args=(1,))
	super+2 KeyAction(func='goto_tab', args=(2,))
	super+3 KeyAction(func='goto_tab', args=(3,))
	super+4 KeyAction(func='goto_tab', args=(4,))
	super+5 KeyAction(func='goto_tab', args=(5,))
	super+6 KeyAction(func='goto_tab', args=(6,))
	super+7 KeyAction(func='goto_tab', args=(7,))
	super+8 KeyAction(func='goto_tab', args=(8,))
	super+9 KeyAction(func='goto_tab', args=(9,))
	super+t KeyAction(func='new_tab_with_cwd', args=())
	super+w KeyAction(func='close_window', args=())
	shift+super+d KeyAction(func='launch', args=['--location=hsplit'])

Couldn't find any docs on Python requirements but maybe I'm just not looking in the right place? It does seem the examples assume a global 'kitty' that's not there for me?

[kovidgoyal]

replace kitty.boss.Boss with just Boss and add

from kitty.boss import Boss