Версии и git

QueryLane ведёт историю версий каждого шага. Кроме того, он умеет читать задачи из git-репозитория и отправлять в него задачи.

История версий шага

Изменение названия, типа, подключения, кода, зависимостей, статуса, таймаута, проверок или других настроек шага сохраняется как версия. Изменения, сделанные с разницей меньше 3 секунд, объединяются в одну версию. У каждого шага хранятся последние 25 версий.

1. В редакторе нажмите кнопку версий на карточке шага, например 4 верс.
2. В окне История версий шага у каждой записи видны дата, вид изменения (Создание, Изменение или Восстановление), источник (Вручную, AI, Дублирование, Импорт или Восстановление) и изменённые поля. В сравнении строки, которые это изменение убрало, отмечены -, а добавленные строки отмечены +.
3. Нажмите Восстановить, чтобы вернуть шаг в состояние до этого изменения.

Восстановление тоже сохраняется как версия, поэтому его можно отменить тем же способом.

Восстановить удалённый шаг

Задача хранит до 50 удалённых шагов.

1. В редакторе нажмите значок истории над шагами (Удаленные шаги: 2). Значок виден, только когда удалённые шаги есть.
2. В окне Удаленные шаги найдите шаг по названию и дате удаления и нажмите Восстановить.

Шаг вернётся в конец задачи вместе со своей историей версий. Зависимости от шагов, которых больше нет, будут убраны.

Чтобы удалить версии и удалённые шаги всех задач, нажмите Очистить версии шагов в разделе Настройки > Общее > Локальные данные.

Добавить git-репозиторий

QueryLane вызывает команду git вашего Mac, поэтому git должен быть установлен.

1. Откройте Подключения. В разделе Git репозитории нажмите Добавить репозиторий.
2. Заполните Название, URL репозитория, Ветка, Автор (имя) и Автор (email).
3. Для закрытого репозитория по HTTPS вставьте Персональный токен доступа (PAT).
4. В поле Структура задач выберите, где хранятся папки, теги и порядок: Локальная, Общая, только чтение или Общая, редактирование.
5. Нажмите Добавить. Позже можно открыть репозиторий и нажать Проверить, чтобы проверить доступ.

QueryLane клонирует репозиторий в ~/Library/Application Support/app.querylane.desktop/repos/. Каждая задача хранится в файле jobs/<job-id>.yaml.

Открыть задачи из репозитория

Когда репозиторий добавлен, над списком задач появляется переключатель. Выберите в нём репозиторий вместо Локальные задачи. QueryLane выполнит pull ветки и покажет её задачи с коротким хешем последнего коммита. Кнопка Pull из репозитория забирает новые коммиты и приводит локальный клон в соответствие с удалённой веткой.

Задача из репозитория помечена Git · только чтение. Её нельзя изменить или поставить на расписание на месте:

• Старт и Редактировать локально копируют задачу в Локальные задачи с тем же id и продолжают работу там.
• Перед запуском задачи из репозитория с JavaScript-шагами QueryLane просит подтверждение в окне Запуск доверенного JavaScript. Нажимайте Доверять и запустить, только если доверяете этой версии репозитория. Ответ запоминается для этого коммита.

Отправить задачу в репозиторий

1. Откройте локальную задачу в редакторе.
2. В поле Где хранить выберите репозиторий вместо Локально. Редактор покажет репозиторий и файл jobs/<job-id>.yaml.
3. Измените задачу. Задачи с неотправленными изменениями отмечены в списке меткой Изменено.
4. Нажмите Push.

QueryLane делает коммит задачи в YAML с сообщением job(update): <name> (<id>) и отправляет его. Если удалённая ветка успела измениться, QueryLane берёт её состояние, заново записывает ваш файл и повторяет отправку, поэтому побеждает ваша версия файла.

В файл попадают название, описание, переменные и шаги задачи. Версии шагов, расписания и история запусков остаются на вашем Mac. Переменные, в названии которых есть слова вроде token, key, password или secret, записываются без значений. Чтобы не выгружать значение другой переменной, включите замок рядом с ней.

Копия, созданная через Редактировать локально, сохраняет id задачи, поэтому отправка в тот же репозиторий заменит исходный файл.

Git-история задачи

У задачи, привязанной к репозиторию, нажмите Версии в заголовке редактора. Окно История версий показывает последние 20 коммитов файла задачи с колонками Сообщение, Хэш, Автор и Дата. Просмотр показывает YAML из коммита. Откатить загружает эту версию в задачу и отправляет её новым коммитом.