Pull- & Merge-Requests

Wyrm spricht direkt mit GitHub und GitLab, du kannst die Pull Requests (bei GitLab Merge Requests) zu deiner aktuellen Arbeit also sehen und verwalten, ohne das Log zu verlassen. In der App heißen beide Pull Requests.

Ein Konto verbinden

Öffne Einstellungen… (⌘,) → Integrationen. Dort gibt es eine Gruppe für GitHub und eine für GitLab.

GitHub: Klicke auf Mit GitHub verbinden. Wyrm zeigt einen kurzen Code (Gib diesen Code auf GitHub ein:). Klicke auf Code kopieren, dann auf GitHub öffnen, füge den Code ein und bestätige. Die App schließt den Vorgang von selbst ab, sobald GitHub bestätigt.
GitLab.com: Klicke auf Mit GitLab verbinden und erlaube Wyrm den Zugriff im Browser.
Selbst gehostetes GitLab oder ein persönliches Token: Wähle Stattdessen Token verwenden / selbst-gehostete Instanz hinzufügen. Gib den Host (nur den Hostnamen, z. B. gitlab.example.com) und ein Token ein, dann Prüfen und verbinden. Wyrm prüft das Token zuerst und speichert es nur, wenn es funktioniert. Die nötigen Berechtigungen stehen unter Erforderliche Token-Berechtigungen: repo, read:user für GitHub, api für GitLab.

Ein verbundenes Konto zeigt Verbunden als …. Tokens landen im macOS-Schlüsselbund. Um eines zu entfernen, öffne das Menü der Zeile und wähle Trennen…; Wyrm löscht das Token aus dem Schlüsselbund.

Das Panel „Pull Requests“

Sobald der Remote des Repositorys zu einem verbundenen Konto passt, erscheint links in der Icon-Leiste ein Button Pull Requests. Das Panel listet die offenen Pull Requests für das nächstgelegene Bookmark und aktualisiert sich jede Minute (oder klicke auf Aktualisieren).

Jede Zeile zeigt Nummer und Titel, ein CI-Ergebnis (✓, ✗ oder ⏳; mit der Maus darüberfahren für die Anzahl der Checks), den Status (Entwurf, Offen, Zusammengeführt, Geschlossen), eine Markierung Konflikte, wenn sich der Branch nicht mehr sauber mergen lässt, und die Reviewer mit ihrem Review-Status. CI-Ergebnisse erscheinen außerdem als Badges an Commits im Log. Klicke mit der rechten Maustaste auf eine Zeile und wähle Im Browser öffnen, um zur Forge zu springen.

Zeigt das Panel Keine Forge-Verbindung für …, klicke auf Integrationseinstellungen öffnen und verbinde das Konto für diesen Host.

Einen Pull Request öffnen

Gib den Commits, die du vorschlagen willst, ein Bookmark (B bei ausgewähltem Commit).
Klicke im Panel „Pull Requests“ unten auf Pull Request erstellen.
Fülle das Formular aus:
- Titel und Beschreibung (die Beschreibung wird aus dem Commit übernommen).
- Quell-Lesezeichen: standardmäßig das nächstgelegene Bookmark. Bookmarks, die es nur auf deinem Rechner gibt, sind mit Nur lokal — wird beim Erstellen gepusht markiert.
- Ziel-Lesezeichen: standardmäßig dein Trunk (main, master oder develop).
- Prüfer und Entwurf, wenn du sie brauchst.
Klicke auf Pull Request erstellen. Ist das Quell-Bookmark noch nicht auf dem Remote, heißt der Button Pushen & PR erstellen und pusht es zuerst. Ist dein lokales Bookmark dem Remote voraus, warnt Wyrm dich und bietet Ohne Push erstellen an oder diese Commits zuerst zu pushen.

Wyrm zeigt Pull Request erstellt! mit einem Link. Ein halb ausgefülltes Formular übersteht das Schließen des Panels.

Bearbeiten, reviewen und mergen

Klicke auf eine Zeile, um den Pull Request im Revisionsbereich zu öffnen. Von dort aus kannst du:

Titel bearbeiten und Beschreibung bearbeiten (Markdown wird gerendert).
Zwischen Als bereit markieren und Als Entwurf markieren wechseln.
Prüfer hinzufügen oder entfernen.
Einen offenen, mergebaren Pull Request Zusammenführen. Wähle die Zusammenführungsmethode (Merge-Commit, Squash oder Rebase) und bestätige. Ein Merge lässt sich in Wyrm nicht rückgängig machen. Wartet die Forge noch auf eine erforderliche Pipeline oder Freigabe, sagt dir Wyrm, dass du den Pull Request im Browser prüfen sollst.

Kommentare, Freigaben und Review-Threads bleiben auf der Forge: Nutze dafür Im Browser öffnen.

Was Pro braucht

Bei öffentlichen Repositories ist alles oben Genannte kostenlos, ebenso bei Repositories auf selbst gehosteten Servern.

Ein privates Repository auf GitHub, GitLab.com oder Bitbucket braucht für jede Arbeit Pro (oder die 14-tägige Testphase), Pull Requests eingeschlossen. Mit Free öffnet Wyrm es hinter dem Hinweis „Dies ist ein privates Repository“, und das Pull-Request-Formular zeigt „Zum Erstellen von Pull Requests in privaten Repositorys ist Pro erforderlich.“ Siehe Konto, Testphase & Abrechnung.