Запуск, тесты и отладка
Запуск#
Кнопка запуска стоит в центре шапки и появляется, когда есть что запускать: файл
Python, Node, Shell или задача из scripts в package.json. Запускается то, чем нужно —
интерпретатор виртуального окружения проекта, а без него python3; менеджер пакетов Node
определяется по проекту. Команда набирается в терминале в каталоге проекта: процесс видно,
его можно прервать и посмотреть вывод, вкладка называется по запуску. Перед запуском
несохранённые файлы сохраняются (отключается в настройках).
Точка входа отмечена значком ▶ у номера строки: if __name__ == "__main__": в Python,
require.main в Node. Клик по значку запускает файл так же, как Ctrl+F5. В тестовом файле
значок стоит у каждого теста — клик запускает ровно этот тест, а не весь файл.
Файлы TypeScript запускаются без предварительной сборки. Если в проекте есть tsx или
ts-node — запускаются они, иначе файл выполняет сам Node со встроенным стиранием типов.
Более старый Node файлы .ts не выполняет, и запуск тогда не предлагается.
Виртуальные окружения Python — окно «Python: виртуальные окружения» (меню «Python»
или палитра по слову venv): видно уже найденные, главное помечено, тут же создаётся новое —
с выбором версии Python из системы, набором пакетов и зависимостей из requirements.txt.
Пакеты и окружение#
Попап окружения Python показывает, сколько пакетов стоит, сверяет
установленное с requirements.txt (сколько зависимостей не хватает и каких) и ставит их одной
кнопкой; то же — командой «Python: установить зависимости». Клик по чипу «Node.js» в строке
состояния показывает версию Node, менеджер пакетов, требуемую версию, поломки (нет node_modules,
не хватает зависимостей, нет файла блокировки) и кнопку установки зависимостей.
Проверка импортов#
Импорты неустановленных библиотек подчёркиваются прямо в редакторе
(import requests, import { z } from 'zod'); стандартная библиотека Python и встроенные
библиотеки Node не трогаются. Так же помечаются свои файлы, которых нет на диске:
import { x } from './gone'. Окружение сменилось или файл открыли заново — проверка повторяется.
Отладчик работает для Python и JavaScript: F5 запускает, Shift+F5 останавливает,
F9 ставит точку останова на строке курсора, F10/F11/Shift+F11 — шаги. Подключиться можно
и к уже запущенному процессу («Отладка: подключиться к процессу…»). Правый клик по жёлобу открывает
меню точки останова: условие, счётчик попаданий («остановиться на пятом проходе») и точка в журнал —
она печатает сообщение с подстановкой значений вместо останова.
Раздел «Наблюдение» считает свои выражения (total * 2, len(items)) в контексте выбранного
кадра; выражения можно заготовить заранее. Наведение на имя в остановленном файле показывает
значение и тип. Двойной клик по переменной или наблюдаемому выражению задаёт новое значение.
Панель «Отладка» показывает стек вызовов и переменные выбранного кадра. Параметры запуска
(аргументы, переменные окружения, рабочий каталог), наблюдения и точки останова помнятся
в проекте. Останов по исключению — двумя галочками: необработанные и любые.
Замеры скорости#
У приложения есть шесть контрольных точек: старт окна, сборка
интерфейса, открытие проекта (запрос и первый кадр с деревом), поиск по проекту и
ожидание первого токена ответа. По умолчанию они выключены и не стоят ничего — ни
вызова часов, ни памяти. Включаются адресом ?perf=1 в окне или переменной
CHUI_PERF=1 — главный процесс тогда пишет свои фазы в консоль.
Сравнивать с базой, а не с порогом в миллисекундах: абсолютные числа зависят от
машины. Снимок берётся из DevTools — __chuiPerf() отдаёт JSON — и кладётся в
perf-last.json рядом с package.json; база для сравнения — perf-baseline.json.
Есть оба файла — npm test проверяет сползание и падает, когда фаза стала медленнее
базы больше чем на половину (запас заложен на шум и прогрев). Нет — тест молчит.
Проверки#
Всё, что гоняет GitHub Actions, собирается в одну локальную команду:
npm run check — типы, формат (biome), линт и тесты. Отдельно npm run test:coverage
(порог покрытия), npm run build и smoke-проверки правок не-ASCII. Формат гоняйте
перед пушем: расхождение с биомом видно только этой командой, а CI падает на нём
на первом же шаге. Workflow запускается на push в любую ветку — прогон можно получить
с временной ветки, не вливая правку в main.
Раздел взят из README приложения версии 0.3.57. Нашли расхождение с приложением — скажите о нём, и раздел поправят вместе с приложением.