chui_iDE

Запуск, тесты и отладка

4 мин чтения 644 слова 4 подразделов

Запуск#

Кнопка запуска стоит в центре шапки и появляется, когда есть что запускать: файл 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. Нашли расхождение с приложением — скажите о нём, и раздел поправят вместе с приложением.