Lidsky řečeno
Chceš opravit chybu v cizí knize. Do originálu v knihovně psát nesmíš. Uděláš si tedy vlastní kopii (fork), opravu v ní vyznačíš a autorovi pošleš žádost: „Podívej, tady jsem to opravil, převezmeš to?“ To je pull request. Autor ji přečte, napíše připomínky (review), ty je zapracuješ, a když je spokojený, opravu převezme do originálu.
Obtížnost: 3 z 5. Předpokládá větve, slučování a push/pull z předchozích lekcí. Webové rozhraní GitHubu v simulaci není, terminálové kroky si ale vyzkoušíš celé.
Dva způsoby spolupráce
- Jeden sdílený repozitář. Tým má do repozitáře právo zápisu. Každý pracuje ve vlastní větvi, pošle ji na server a otevře pull request do
main. Tak to funguje ve většině firem. - Fork. Do cizího (typicky open source) projektu zápis nemáš. Na GitHubu klikneš na Fork a vznikne tvoje kopie repozitáře pod tvým účtem. Do ní posíláš větve a pull request otevíráš z forku do původního projektu.
U forku máš dva vzdálené repozitáře. Zvykem je pojmenovat je takto:
origin: tvůj fork (https://github.com/ty/projekt.git), sem posíláš.upstream: původní projekt (https://github.com/autor/projekt.git), odsud stahuješ novinky.
Naklonuj fork a připoj původní projekt
Udělal sis na GitHubu fork projektu https://github.com/sudo-learn/kucharka.git. Tvůj fork má adresu https://github.com/adam/kucharka.git. Naklonuj svůj fork a přidej původní projekt jako vzdálený repozitář se jménem upstream. Výsledek ověř přes git remote -v.
Načítám terminál…
Pull request krok za krokem
- Aktualizuj
main(git pull, u forku synchronizace s upstreamem, viz níže). - Vytvoř větev pro jednu konkrétní změnu:
git switch -c oprava-preklepu. - Commitni změnu (klidně ve více commitech).
- Pošli větev na svůj repozitář:
git push -u origin oprava-preklepu. Git ti v odpovědi rovnou napíše odkaz na vytvoření pull requestu. - Otevři pull request na GitHubu: vyber cílovou větev (obvykle
mainpůvodního projektu), napiš název a popis. - Review: ostatní okomentují konkrétní řádky, schválí (Approve), nebo požádají o změny (Request changes). Automatické testy (checks, GitHub Actions) ukážou, jestli kód prochází.
- Zapracuj připomínky: další commity do stejné větve a
git push. Pull request se aktualizuje sám. - Sloučení: správce klikne na Merge. Potom větev smažeš (GitHub na to nabídne tlačítko) a lokálně
git switch main,git pull,git branch -d oprava-preklepu.
Připrav větev pro pull request
V receptu je překlep: místo Guláš je tam Gulás. Vytvoř větev oprava-preklepu, oprav v ní soubor gulas.txt na Guláš: maso, cibule, paprika, commitni se zprávou Opraven překlep v guláši a pošli větev na svůj fork (origin) s nastaveným sledováním.
Načítám terminál…
Synchronizace forku
Původní projekt jde dál a tvůj fork o tom neví. Novinky si stáhneš z upstream, sloučíš do svého main a pošleš do svého forku:
git switch main
git fetch upstream
git merge upstream/main
git push origin main(GitHub má pro totéž v rozhraní forku tlačítko Sync fork.)
Dožeň původní projekt
Do původního projektu mezitím autorka přidala recept na knedlíky. Tvůj main i tvůj fork ho nemají. Stáhni novinky z upstream, sluč je do svého main a pošli aktualizovaný main do svého forku.
Načítám terminál…
Dobrý pull request a dobré review
Jako autor:
- Jeden PR = jedna změna. Malý PR (desítky řádků) se zkontroluje za pár minut, obří se odkládá týdny.
- Název řekne co, popis proč a jak to vyzkoušet. U změn vzhledu přidej snímek obrazovky.
- Odkaž na úkol: když v popisu napíšeš
Closes #12(neboFixes #12), GitHub po sloučení do výchozí větve úkol číslo 12 sám uzavře. - Nedokončenou práci otevři jako Draft pull request, ať ostatní ví, že ještě není k revizi.
Jako recenzent:
- Komentuj kód, ne člověka. „Tady by se hodila kontrola prázdného vstupu“ místo „tohle je špatně“.
- Rozliš, co je nutné a co jen návrh (třeba předponou „nit:“ pro drobnosti).
- Ptej se, když něčemu nerozumíš. Otázka často odhalí chybu lépe než příkaz.
Pod kapotou · Ochrana větví, CODEOWNERS a CI
Správce může na main zapnout pravidla (branch protection rules nebo novější rulesets): zákaz přímého pushe, povinný počet schválení, povinné úspěšné kontroly CI a zákaz force push. Soubor CODEOWNERS určí, kdo musí schválit změny v určitých složkách. Pull request je ve skutečnosti jen záznam na serveru: „větev X chci sloučit do Y“. Git sám žádné pull requesty nezná, každá služba je dělá trochu jinak (GitLab jim říká merge request). Lokálně si cizí PR na GitHubu stáhneš přes git fetch origin pull/123/head:pr-123, pohodlněji přes GitHub CLI gh pr checkout 123.
Procvič si to
Co je fork?
Fork vzniká na serveru (tlačítkem Fork). Klon je kopie u tebe na počítači.
Jak se u forku obvykle jmenuje vzdálený repozitář s původním projektem?
origin je tvůj fork, upstream původní projekt, odkud stahuješ novinky.
Po otevření PR ti recenzent napsal připomínku. Jak ji zapracuješ?
Pull request sleduje větev. Každý push do ní se v PR objeví.
Co způsobí v popisu PR text Fixes #12?
GitHub rozpozná klíčová slova jako close, fix nebo resolve s číslem úkolu.
Který způsob sloučení na GitHubu spojí všechny commity PR do jediného?
Squash vezme všechny změny PR a uloží je jako jeden commit do cílové větve.