From 262b3296186229207cca8aab1dd4eb783d162d7d Mon Sep 17 00:00:00 2001 From: Digital Studium Date: Sun, 21 Apr 2024 09:56:17 +0300 Subject: [PATCH] Translate comments into English --- kls | 92 ++++++++++++++++++++++++++++++------------------------------- 1 file changed, 46 insertions(+), 46 deletions(-) diff --git a/kls b/kls index 94a32a2..d34a9ab 100755 --- a/kls +++ b/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.filter = "" # фильтр строк - self.filtered_rows = lambda: [x for x in self.rows if self.filter in x] # фильтрованные строки - self.filtered_row_index = 0 # индекс выбранной строки из фильтрованных строк - # __start_index - начиная с какой строки мы будем выбирать строки из filtered_rows()? Обычно с первой строки, - # но если размер filtered_rows больше HEIGHT и filtered_row_index выходит за границы высоты меню HEIGHT, - # сдвигаем __start_index вправо на filtered_row_index - HEIGHT. Таким образом реализуется прокрутка меню + self.rows = rows # all rows + self.filter = "" # filter for rows + self.filtered_rows = lambda: [x for x in self.rows if self.filter in x] # filtered rows + self.filtered_row_index = 0 # index of the selected filtered row + # __start_index - starting from which row we will select rows from filtered_rows()? Usually from the first row, + # but if the size of filtered_rows is greater than HEIGHT and filtered_row_index exceeds the menu 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_row_index = lambda: self.filtered_row_index - self.__start_index() # индекс выбранной строки из видимых строк - self.selected_row = lambda: self.visible_rows()[self.__visible_row_index()] if self.visible_rows() else None # выбранная строка из видимых строк + 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() # index of the selected visible row + 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() # инициализация экрана -# вывод команды преобразуем в list +SCREEN = curses.initscr() # screen initialization +# 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 # максимальное число индексов видимых строк -namespace = MENUS[0].selected_row # псеводним метода +HEIGHT = curses.LINES - 9 # maximum number of visible row indices +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() # очищаем окно меню - draw_row(menu.win, menu.title, 1, 2, selected=True if menu == SELECTED_MENU else False) # рисуем заголовок - draw_rows(menu.visible_rows(), menu) # рисуем строки меню - draw_row(menu.win, f"/{menu.filter}" if menu.filter else "", curses.LINES - 5, 2) # рисуем строку поиска + menu.win.clear() # clear menu window + 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 menu rows + 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].filtered_row_index = 0 # перед перерисовкой сбрасываем выбранную строку на 0 + 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 # reset the selected row index before redrawing draw_menu(MENUS[2]) def run_command(key): - if not (key == "4" and api_resource() != "pods"): - curses.def_prog_mode() # сохраняем преыдущее состояние терминала - curses.endwin() # без этого после выхода из vim начинаются проблемы + if not (key == "4" and api_resource()!= "pods"): + curses.def_prog_mode() # save the previous terminal state + 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]: - update_menu3() # перерисовываем строки третьего меню, если мы перерисовали строки первого или второго меню + if menu!= MENUS[2]: + 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) # перерисовываем меню - if menu != MENUS[2]: - update_menu3() # перерисовываем строки третьего меню, если мы перерисовали строки первого или второго меню + draw_rows(menu.visible_rows(), menu) # redraw the menu + if menu!= MENUS[2]: + 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.keypad(True) # нужно для работы со стрелками - # в curses зачем-то сделали задержку на срабатывание Escape, уменьшаем её до 1 милисекунды (до 0 нельзя) + SCREEN.refresh() # I don't know why this is needed but it doesn't work without it + SCREEN.keypad(True) # needed for arrow keys + # 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.use_default_colors() # не меняем цвет терминала - curses.noecho() # не выводим символы вверху - draw_menu(MENUS[0]) # рисуем основные окна + curses.curs_set(0) # make the cursor invisible + curses.use_default_colors() # don't change the terminal color + curses.noecho() # don't output characters at the top + 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) +curses.wrapper(main) \ No newline at end of file