Pull і merge requests

Wyrm працює з GitHub і GitLab напряму, тож ти можеш бачити й керувати pull requests (на GitLab — merge requests) для поточної роботи, не виходячи з журналу. У застосунку обидва називаються Pull-запити.

Підключення облікового запису

Відкрий Налаштування… (⌘,) → Інтеграції. Там є група для GitHub і група для GitLab.

• GitHub: клацни Підключити GitHub. Wyrm покаже короткий код (Введіть цей код на GitHub:). Клацни Копіювати код, потім Відкрити GitHub, встав код і підтвердь. Застосунок завершить усе сам, щойно GitHub підтвердить.
• GitLab.com: клацни Підключити GitLab і підтвердь доступ для Wyrm у браузері.
• Власний сервер GitLab або персональний токен: вибери Використати токен / додати власний екземпляр. Введи Хост (лише ім’я хоста, напр. gitlab.example.com) і Токен, потім Перевірити й підключити. Wyrm спершу перевіряє токен і зберігає його, лише якщо він працює. Потрібні дозволи наведено в Необхідні дозволи токена: repo, read:user для GitHub, api для GitLab.

Підключений обліковий запис показує Підключено як …. Токени зберігаються у в’язці ключів macOS. Щоб вилучити один, відкрий меню рядка й вибери Відключити…; Wyrm видалить токен із в’язки ключів.

Панель «Pull-запити»

Щойно віддалений репозиторій збігається з підключеним обліковим записом, на панелі значків ліворуч з’являється кнопка Pull-запити. Панель показує відкриті pull requests для найближчого bookmark і оновлюється щохвилини (або клацни Оновити).

Кожен рядок показує номер і заголовок, результат CI (✓, ✗ або ⏳; наведи курсор, щоб побачити кількість перевірок), стан (Чернетка, Відкрито, Злито, Закрито), позначку Конфлікти, коли гілка більше не зливається чисто, а також рецензентів зі станом їхніх рецензій. Результати CI також з’являються як значки на комітах у журналі. Клацни рядок правою кнопкою й вибери Відкрити у браузері, щоб перейти на forge.

Якщо панель показує Немає підключення до forge для …, клацни Відкрити налаштування інтеграцій і підключи обліковий запис для цього хоста.

Відкриття pull request

1. Дай комітам, які хочеш запропонувати, bookmark (B, коли вибрано коміт).
2. На панелі «Pull-запити» клацни Створити Pull Request унизу.
3. Заповни форму:
   • Заголовок і Опис (опис заповнюється з коміту).
   • Вихідна закладка: типово найближчий bookmark. Bookmarks, які існують лише на твоєму комп’ютері, позначено Лише локально — буде надіслано під час створення.
   • Цільова закладка: типово твій trunk (main, master або develop).
   • Рецензенти і Чернетка, якщо потрібно.
4. Клацни Створити Pull Request. Якщо вихідного bookmark ще немає на віддаленому репозиторії, кнопка називається Надіслати й створити PR і спершу надсилає його. Якщо твій локальний bookmark випереджає віддалений, Wyrm попередить і запропонує Створити без push або спершу надіслати ці коміти.

Wyrm покаже Pull Request створено! із посиланням. Частково заповнена форма зберігається, навіть якщо закрити панель.

Редагування, рецензування й злиття

Клацни рядок, щоб відкрити pull request на панелі ревізії. Звідти можна:

• Редагувати назву і Редагувати опис (Markdown відображається).
• Перемикатися між Позначити готовим і Позначити чернеткою.
• Додавати чи прибирати Рецензенти.
• Об’єднати відкритий pull request, який можна злити. Вибери Метод об’єднання (Коміт об’єднання, Squash або Rebase) і підтвердь. Злиття не можна скасувати з Wyrm. Якщо forge ще чекає на обов’язковий pipeline чи схвалення, Wyrm порадить перевірити pull request у браузері.

Коментарі, схвалення й обговорення рецензій залишаються на forge: для них використовуй Відкрити у браузері.

Що потребує Pro

У публічних репозиторіях усе описане вище безкоштовне, як і в репозиторіях на власних серверах.

Приватний репозиторій на GitHub, GitLab.com або Bitbucket потребує Pro (або 14-денного пробного періоду) для будь-якої роботи, зокрема й pull requests. На Free Wyrm відкриває його за повідомленням «Це приватний репозиторій», а форма pull request показує «Для створення pull request у приватних репозиторіях потрібен Pro.» Дивись Обліковий запис, пробний період і оплата.