Pull i merge requesty

Wyrm komunikuje się bezpośrednio z GitHubem i GitLabem, więc możesz przeglądać pull requesty (na GitLabie merge requesty) dla pracy, którą masz przed sobą, i zarządzać nimi bez opuszczania logu. W aplikacji jedne i drugie nazywają się Pull requesty.

Połącz konto

Otwórz Ustawienia… (⌘,) → Integracje. Jest tam grupa dla GitHuba i jedna dla GitLaba.

• GitHub: kliknij Połącz z GitHub. Wyrm pokaże krótki kod (Wpisz ten kod na GitHubie:). Kliknij Kopiuj kod, potem Otwórz GitHub, wklej kod i zatwierdź. Aplikacja kończy sama, gdy GitHub potwierdzi.
• GitLab.com: kliknij Połącz z GitLab i zatwierdź Wyrm w przeglądarce.
• GitLab self-hosted lub token osobisty: wybierz Użyj tokenu / dodaj instancję self-hosted. Wpisz Host (tylko nazwę hosta, np. gitlab.example.com) i Token, a potem Sprawdź i połącz. Wyrm najpierw sprawdza token i zapisuje go tylko wtedy, gdy działa. Wymagane zakresy są podane w Wymagane uprawnienia tokenu: repo, read:user dla GitHuba, api dla GitLaba.

Połączone konto pokazuje Połączono jako …. Tokeny trafiają do pęku kluczy macOS. Aby usunąć konto, otwórz menu wiersza i wybierz Rozłącz…; Wyrm usuwa token z pęku kluczy.

Panel Pull requesty

Gdy zdalne repozytorium pasuje do połączonego konta, na pasku ikon po lewej pojawia się przycisk Pull requesty. Panel wypisuje otwarte pull requesty dla najbliższego bookmarka i odświeża się co minutę (albo kliknij Odśwież).

Każdy wiersz pokazuje numer i tytuł, wynik CI (✓, ✗ lub ⏳; najedź kursorem, aby zobaczyć liczbę testów), stan (Szkic, Otwarty, Scalony, Zamknięty), etykietę Konflikty, gdy gałęzi nie da się już czysto scalić, oraz recenzentów ze stanem ich recenzji. Wyniki CI pojawiają się też jako plakietki przy commitach w logu. Kliknij wiersz prawym przyciskiem i wybierz Otwórz w przeglądarce, aby przejść do forge.

Jeśli panel pokazuje Brak połączenia z forge dla …, kliknij Otwórz ustawienia Integracji i połącz konto dla tego hosta.

Otwieranie pull requesta

1. Nadaj commitom, które chcesz zaproponować, bookmark (B przy zaznaczonym commicie).
2. W panelu Pull requesty kliknij Utwórz Pull Request na dole.
3. Wypełnij formularz:
   • Tytuł i Opis (opis jest wypełniany z commita).
   • Zakładka źródłowa: domyślnie najbliższy bookmark. Bookmarki, które istnieją tylko na Twoim komputerze, mają oznaczenie Tylko lokalnie — zostanie wypchnięta przy tworzeniu.
   • Zakładka docelowa: domyślnie Twój trunk (main, master lub develop).
   • Recenzenci i Szkic, jeśli ich potrzebujesz.
4. Kliknij Utwórz Pull Request. Jeśli bookmarka źródłowego nie ma jeszcze na zdalnym repozytorium, przycisk ma napis Wypchnij i utwórz PR i najpierw go wypycha. Jeśli Twój lokalny bookmark wyprzedza zdalny, Wyrm ostrzega Cię i oferuje Utwórz bez wypychania albo najpierw wypchnięcie tych commitów.

Wyrm pokazuje Pull Request utworzony! z linkiem. Częściowo wypełniony formularz przetrwa zamknięcie panelu.

Edycja, recenzja i scalanie

Kliknij wiersz, aby otworzyć pull request w panelu rewizji. Stamtąd możesz:

• zmieniać tytuł i opis przyciskami Edytuj tytuł i Edytuj opis (Markdown jest renderowany);
• przełączać między Oznacz jako gotowe a Oznacz jako szkic;
• dodawać lub usuwać recenzentów (Recenzenci);
• scalić przyciskiem Scal otwarty pull request, który da się scalić. Wybierz Metoda scalania (Commit scalający, Squash lub Rebase) i potwierdź. Scalenia nie da się cofnąć z poziomu aplikacji Wyrm. Jeśli forge wciąż czeka na wymagany pipeline lub zatwierdzenie, Wyrm poprosi Cię o sprawdzenie pull requesta w przeglądarce.

Komentarze, zatwierdzenia i wątki recenzji zostają na forge: do nich użyj Otwórz w przeglądarce.

Co wymaga Pro

W publicznych repozytoriach wszystko powyższe jest darmowe, podobnie jak w repozytoriach na serwerach self-hosted.

Prywatne repozytorium na GitHubie, GitLab.com lub Bitbucket wymaga Pro (albo 14-dniowego okresu próbnego) do jakiejkolwiek pracy, łącznie z pull requestami. W planie Free Wyrm otwiera je za komunikatem „To jest prywatne repozytorium”, a formularz pull requesta pokazuje „Do tworzenia pull requestów w prywatnych repozytoriach wymagany jest Pro.” Zobacz Konto, okres próbny i płatności.