Translate comments into English

kls

@@ -8,7 +8,7 @@ KEY_BINDINGS = {
     "4": 'kubectl -n {namespace} logs {resource} | batcat -l log --paging always --style numbers'
 }
 
-EXTRA_COLUMNS = {  # по умолчанию отображается только колонка NAME:.metadata.name
+EXTRA_COLUMNS = {  # By default, only the NAME column is displayed:.metadata.name
     "pods": ',STATUS:.status.phase,NODE:.spec.nodeName',
     "services": ',TYPE:.spec.type,CLUSTER_IP:.spec.clusterIP',
     "ingresses": ',HOSTS:.spec.rules[*].host',
@@ -19,35 +19,35 @@ EXTRA_COLUMNS = {  # по умолчанию отображается тольк
 class Menu:
     def __init__(self, title, rows, begin_x, width):
         self.title = title
-        self.rows = rows  # все строки
+        self.rows = rows  # all rows
-        self.filter = ""  # фильтр строк
+        self.filter = ""  # filter for rows
-        self.filtered_rows = lambda: [x for x in self.rows if self.filter in x]  # фильтрованные строки
+        self.filtered_rows = lambda: [x for x in self.rows if self.filter in x]  # filtered rows
-        self.filtered_row_index = 0  # индекс выбранной строки из фильтрованных строк
+        self.filtered_row_index = 0  # index of the selected filtered row
-        # __start_index - начиная с какой строки мы будем выбирать строки из filtered_rows()? Обычно с первой строки,
+        # __start_index - starting from which row we will select rows from filtered_rows()? Usually from the first row,
-        # но если размер filtered_rows больше HEIGHT и filtered_row_index выходит за границы высоты меню HEIGHT,
+        # but if the size of filtered_rows is greater than HEIGHT and filtered_row_index exceeds the menu HEIGHT,
-        # сдвигаем __start_index вправо на filtered_row_index - HEIGHT. Таким образом реализуется прокрутка меню
+        # we shift __start_index to the right by filtered_row_index - HEIGHT. This way we implement menu scrolling
         self.__start_index = lambda: 0 if self.filtered_row_index < HEIGHT else self.filtered_row_index - HEIGHT + 1
-        self.visible_rows = lambda: self.filtered_rows()[self.__start_index():][:HEIGHT]  # видимые строки
+        self.visible_rows = lambda: self.filtered_rows()[self.__start_index():][:HEIGHT]  # visible rows
-        self.__visible_row_index = lambda: self.filtered_row_index - self.__start_index()  # индекс выбранной строки из видимых строк
+        self.__visible_row_index = lambda: self.filtered_row_index - self.__start_index()  # index of the selected visible row
-        self.selected_row = lambda: self.visible_rows()[self.__visible_row_index()] if self.visible_rows() else None  # выбранная строка из видимых строк
+        self.selected_row = lambda: self.visible_rows()[self.__visible_row_index()] if self.visible_rows() else None  # selected row from visible rows
         self.win = curses.newwin(curses.LINES - 3, width, 0, begin_x)
 
 
-SCREEN = curses.initscr()  # инициализация экрана
+SCREEN = curses.initscr()  # screen initialization
-# вывод команды преобразуем в list
+# convert command output to list
 kubectl = lambda command: subprocess.check_output("kubectl " + command, shell=True).decode().rstrip().split("\n")
 api_resources_top = ["pods", "services", "ingresses", "deployments", "statefulsets", "daemonsets", "configmaps",
                      "secrets", "persistentvolumes", "persistentvolumeclaims", "nodes", "storageclasses"]
 api_resources_kubectl = kubectl("api-resources --no-headers --verbs=get | awk '{print $1}'")
-api_resources = list(dict.fromkeys(api_resources_top + api_resources_kubectl))  # так top api ресурсы будут вверху
+api_resources = list(dict.fromkeys(api_resources_top + api_resources_kubectl))  # so top api resources are at the top
 width_unit = curses.COLS // 8
 MENUS = [Menu("Namespaces", kubectl("get ns --no-headers -o custom-columns=NAME:.metadata.name"), 0, width_unit),
          Menu("API resources", api_resources, width_unit, width_unit * 2),
          Menu("Resources", [], width_unit * 3, curses.COLS - width_unit * 3)]
 SELECTED_MENU = MENUS[0]
 HELP_TEXT = "Esc: exit filter mode or exit kls, 1: get yaml, 2: describe, 3: edit, 4: pod logs, arrows/TAB: navigation"
-HEIGHT = curses.LINES - 9  # максимальное число индексов видимых строк
+HEIGHT = curses.LINES - 9  # maximum number of visible row indices
-namespace = MENUS[0].selected_row  # псеводним метода
+namespace = MENUS[0].selected_row  # method alias
 api_resource = MENUS[1].selected_row
 resource = lambda: MENUS[2].selected_row().split()[0]
 
@@ -64,10 +64,10 @@ def draw_rows(rows, menu):
 
 
 def draw_menu(menu):
-    menu.win.clear()  # очищаем окно меню
+    menu.win.clear()  # clear menu window
-    draw_row(menu.win, menu.title, 1, 2, selected=True if menu == SELECTED_MENU else False)  # рисуем заголовок
+    draw_row(menu.win, menu.title, 1, 2, selected=True if menu == SELECTED_MENU else False)  # draw title
-    draw_rows(menu.visible_rows(), menu)  # рисуем строки меню
+    draw_rows(menu.visible_rows(), menu)  # draw menu rows
-    draw_row(menu.win, f"/{menu.filter}" if menu.filter else "", curses.LINES - 5, 2)  # рисуем строку поиска
+    draw_row(menu.win, f"/{menu.filter}" if menu.filter else "", curses.LINES - 5, 2)  # draw filter row
 
 
 def update_menu3():
@@ -75,34 +75,34 @@ def update_menu3():
     if namespace() and api_resource():
         columns = EXTRA_COLUMNS.get(api_resource(), "")
         command = f"-n {namespace()} get {api_resource()} --no-headers -o custom-columns=NAME:.metadata.name{columns}"
-        MENUS[2].rows = [x for x in kubectl(command) if x]  # это нужно для удаления пустых значений из листа
+        MENUS[2].rows = [x for x in kubectl(command) if x]  # this is needed to remove empty values from the list
-    MENUS[2].filtered_row_index = 0  # перед перерисовкой сбрасываем выбранную строку на 0
+    MENUS[2].filtered_row_index = 0  # reset the selected row index before redrawing
     draw_menu(MENUS[2])
 
 
 def run_command(key):
-    if not (key == "4" and api_resource() != "pods"):
+    if not (key == "4" and api_resource()!= "pods"):
-        curses.def_prog_mode()  # сохраняем преыдущее состояние терминала
+        curses.def_prog_mode()  # save the previous terminal state
-        curses.endwin()  # без этого после выхода из vim начинаются проблемы
+        curses.endwin()  # without this, there are problems after exiting vim
         command = KEY_BINDINGS[key].format(namespace=namespace(), api_resource=api_resource(), resource=resource())
         subprocess.call(command, shell=True)
-        curses.reset_prog_mode()  # восстанавливаем преыдущее состояние терминала
+        curses.reset_prog_mode()  # restore the previous terminal state
         SCREEN.refresh()
 
 
 def handle_filter_state(key, menu):
     if key == "\x1b":
-        menu.filter = ""  # Нажатие Escape выходит из режима поиска
+        menu.filter = ""  # Escape key exits filter mode
     elif key in ["KEY_BACKSPACE", "\x08"]:
-        menu.filter = menu.filter[:-1]  # Нажатие Backspace удаляет символ (\x08 это тоже Backspace)
+        menu.filter = menu.filter[:-1]  # Backspace key deletes a character (\x08 is also Backspace)
     elif key.isalpha() or key == "-":
         menu.filter += key.lower()
     else:
         return
     menu.filtered_row_index = 0
     draw_menu(menu)
-    if menu != MENUS[2]:
+    if menu!= MENUS[2]:
-        update_menu3()  # перерисовываем строки третьего меню, если мы перерисовали строки первого или второго меню
+        update_menu3()  # redraw the third menu rows if we redraw the first or second menu rows
 
 
 def catch_input(menu):
@@ -110,38 +110,38 @@ def catch_input(menu):
     if key in ["\t", "KEY_RIGHT", "KEY_BTAB", "KEY_LEFT"]:
         increment = {"KEY_RIGHT": 1, "\t": 1, "KEY_LEFT": -1, "KEY_BTAB": -1}[key]
         next_menu = MENUS[(MENUS.index(menu) + increment) % 3]
-        draw_row(menu.win, menu.title, 1, 2, selected=False)  # убираем выделение с заголовка текущего меню
+        draw_row(menu.win, menu.title, 1, 2, selected=False)  # remove selection from the current menu title
-        # и выделяем заголовок нового меню
+        # and select the new menu title
         draw_row(next_menu.win, next_menu.title, 1, 2, selected=True)
         globals().update(SELECTED_MENU=next_menu)
     elif key in ["KEY_UP", "KEY_DOWN"] and len(menu.visible_rows()) > 1:
         increment = {"KEY_DOWN": 1, "KEY_UP": -1}[key]
         menu.filtered_row_index = (menu.filtered_row_index + increment) % len(menu.filtered_rows())
-        draw_rows(menu.visible_rows(), menu)  # перерисовываем меню
+        draw_rows(menu.visible_rows(), menu)  # redraw the menu
-        if menu != MENUS[2]:
+        if menu!= MENUS[2]:
-            update_menu3()  # перерисовываем строки третьего меню, если мы перерисовали строки первого или второго меню
+            update_menu3()  # redraw the third menu rows if we redraw the first or second menu rows
     elif key in KEY_BINDINGS.keys() and MENUS[2].selected_row():
         run_command(key)
     elif key == "\x1b" and not menu.filter:
-        globals().update(SELECTED_MENU=None)  # выход
+        globals().update(SELECTED_MENU=None)  # exit
     else:
         handle_filter_state(key, menu)
 
 
 def main(screen):
-    SCREEN.refresh()  # не знаю зачем это нужно но без этого не работает
+    SCREEN.refresh()  # I don't know why this is needed but it doesn't work without it
-    SCREEN.keypad(True)  # нужно для работы со стрелками
+    SCREEN.keypad(True)  # needed for arrow keys
-    # в curses зачем-то сделали задержку на срабатывание Escape, уменьшаем её до 1 милисекунды (до 0 нельзя)
+    # in curses, there is a delay on Escape key press, we reduce it to 1 millisecond (can't set it to 0)
     curses.set_escdelay(1)
-    curses.curs_set(0)  # делаем курсор невидимым
+    curses.curs_set(0)  # make the cursor invisible
-    curses.use_default_colors()  # не меняем цвет терминала
+    curses.use_default_colors()  # don't change the terminal color
-    curses.noecho()  # не выводим символы вверху
+    curses.noecho()  # don't output characters at the top
-    draw_menu(MENUS[0])  # рисуем основные окна
+    draw_menu(MENUS[0])  # draw the main windows
     draw_menu(MENUS[1])
     update_menu3()
-    draw_row(curses.newwin(3, curses.COLS, curses.LINES - 3, 0), HELP_TEXT, 1, 2)  # и окно помощи
+    draw_row(curses.newwin(3, curses.COLS, curses.LINES - 3, 0), HELP_TEXT, 1, 2)  # and the help window
     while SELECTED_MENU:
-        catch_input(SELECTED_MENU)  # если какое-то меню выбрано, перехватываем ввод пользователя
+        catch_input(SELECTED_MENU)  # if a menu is selected, catch user input
 
 
 curses.wrapper(main)