Pull request je jedním z nejdůležitějších nástrojů pro spolupráci a vývoj v týmu při používání systémů pro správu verzí, jako je Git. Umožňuje provést změny v kódu jiného vývojáře a Navrhnout je tak, aby byly zahrnuty do hlavní verze projektu. Pokud chcete přispět k vývoji projektu, vytvoření pull request pro své úložiště bude nezbytným krokem.
Proces vytváření pull request je poměrně jednoduchý a skládá se z několika kroků. Nejprve si musíte vytvořit větev, ve které budete provádět změny. K tomu můžete použít příkaz git branch v terminálu nebo speciální možnost v nástroji pro kontrolu verzí.
Poté musíte provést změny kódu a uložit je do větve. Je důležité zajistit, aby provedené změny nebyly v rozporu s kódem hlavní větve projektu. Jakmile je vaše vlákno dokončeno, můžete jej odeslat na vzdálený server, aby ostatní vývojáři mohli váš kód zobrazit a vyhodnotit.
Nakonec můžete vytvořit pull request tím, že upozorníte tým projektu na váš kód a požádáte o zpětnou vazbu a komentáře. Poté můžete iterovat zpětnou vazbu provedením změn a opětovným odesláním větve na server. Když jsou všechny komentáře vyřešeny a váš kód bude připraven k začlenění do hlavní větve projektu, váš pull request bude přijat a vaše změny budou zahrnuty do projektu.
Čím je pull request užitečný?
| Umožňuje uspořádat revue kód | Pull requests slouží jako skvělý způsob, jak zorganizovat proces Cod Review v projektu. Vývojáři mohou prohlížet, komentovat a kontrolovat změny, což pomáhá zlepšit kvalitu kódu a předcházet chybám. |
| Vytváří zpětnou vazbu | Pull request umožňuje všem zúčastněným stranám zanechat komentáře, klást otázky a navrhovat zlepšení kódu. Tato zpětná vazba pomáhá zlepšit výsledky a poučit se z chyb. |
| Vytváří transparentnost | Pull requests umožňují všem účastníkům projektu vidět, jaké změny byly provedeny, kdy a kým. To pomáhá udržovat transparentnost, zlepšuje komunikaci ve vývojovém týmu a usnadňuje sledování procesu práce. |
| Zjednoduší slučování změn | Pull requesty zjednodušují proces slučování změn z jedné větve do druhé. Vývojáři mohou zobrazit všechny provedené změny, odmítnout nebo je přijmout a poté snadno integrovat větev do hlavní větve projektu. To pomáhá zefektivnit a urychlit proces vývoje. |
Celkově je pull request nedílnou součástí vývoje open source softwaru. Podporuje spolupráci, pomáhá udržovat kvalitu kódu a také usnadňuje proces slučování změn a podporu projektu jako celku.
Krok 1: Fork repozitář
Chcete-li vytvořit Fork úložiště, postupujte podle těchto kroků:
- Navštivte stránku původního úložiště, které chcete forkovat.
- Klikněte na tlačítko "Fork" v pravém horním rohu stránky.
- Vyberte svůj účet nebo organizaci a vytvořte Fork.
Po kliknutí na tlačítko "Fork" začne GitHub vytvářet vaši kopii úložiště. Po dokončení procesu budete přesunuti na stránku své nové kopie úložiště.
Nyní máte svůj vlastní Fork úložiště a můžete začít provádět změny v kódu a souborech projektu.
| Výhody Fork úložiště: | Další možnosti: |
|---|---|
| Můžete bezpečně provádět změny kódu a souborů projektu, aniž byste ovlivnili původní úložiště. | Je možné vytvořit novou funkci nebo opravit chyby. |
| Můžete uložit své změny do větve a sdílet je s ostatními vývojáři. | Je možné synchronizovat své změny s původním úložištěm prostřednictvím pull request. |
Jak mohu zálohovat úložiště v GitHubu?
Fork v GitHubu je kopie úložiště, které vytvoříte na svém účtu, abyste mohli na projektu dále pracovat. Proces Fork umožňuje zachovat původní úložiště beze změny a přidat do něj vlastní změny bez přímého přístupu k původnímu úložišti.
Chcete-li zálohovat úložiště v GitHubu, postupujte podle následujících kroků:
- Přihlaste se ke svému účtu na github.com..
- Otevřete stránku úložiště, kterou chcete forkovat.
- Klikněte na tlačítko "Fork" v pravém horním rohu stránky. Poté GitHub vytvoří kopii úložiště na vašem účtu. Poznámka: vytvoření forku může nějakou dobu trvat v závislosti na velikosti úložiště.
- Po vytvoření forku budete přesměrováni na stránku vašeho nového úložiště.
Nyní můžete pracovat s forkovaným úložištěm, provádět změny, vytvářet nové komity a dokonce vytvářet pull requesty, abyste mohli navrhnout své změny v původním úložišti.
Krok 2: Vytvořte větev
Chcete-li vytvořit větev na Githubu, postupujte takto:
- Otevřete stránku úložiště.
- Vedle názvu hlavní větve vyhledejte tlačítko "Branch: master" a klikněte na něj.
- Do zobrazeného pole zadejte název nové větve, například"My-branch".
- Vyberte možnost "Create new branch from 'master'".
- Klikněte na tlačítko "Create branch".
Nyní máte novou větev s vybraným názvem, ve které můžete provádět změny. Chcete-li přejít na novou větev, vyberte ji z rozevíracího seznamu větví v horní části stránky úložiště.
Jak vytvoříte větev v úložišti?
Chcete-li vytvořit novou větev ve svém úložišti na platformě GitHub, postupujte podle těchto jednoduchých kroků:
1. Přejděte na stránku úložiště.
Hlavní obrazovka vašeho úložiště zobrazí seznam souborů a složek.
2. Klikněte na tlačítko "Branch: master" vedle rozevíracího seznamu souborů.
Ve vašem úložišti uvidíte seznam všech existujících větví.
3. Do pole "Find or create a branch"zadejte název nové větve.
Vyberte si název, který nejlépe vyhovuje účelu vaší nové větve.
4. Stiskněte Enter na klávesnici.
GitHub vytvoří novou větev ve vašem úložišti se zadaným názvem.
5. Budete vyzváni k přechodu na novou větev.
Klikněte na odkaz "switching branches" nebo aktualizujte stránku, abyste viděli soubory ve své nově vytvořené větvi.
6. Nastavili jste vlákno ve svém úložišti!
Nyní můžete pracovat s touto větví, vytvářet nové soubory, provádět změny a zaznamenávat commity.
Krok 3: Proveďte změny
Nyní, když jste vytvořili vlákno pro své změny, je čas začít pracovat na kódu.
Otevřete soubory, ve kterých chcete provést změny, a proveďte požadované úpravy.
Při práci na kódu se doporučuje dodržovat dobré programátorské postupy, jako jsou:
- Jednotlivé komity: Rozdělte velké změny na několik malých komit. To pomůže porozumět změnám a usnadní proces kontroly kódu.
- Popisné zprávy o komunikacích: Pokuste se napsat přesnou a informativní zprávu commitu, aby ostatní vývojáři snadno pochopili, co přesně bylo změněno.
- Testování: Ujistěte se, že provedené změny nevedou k chybám. Otestujte kód před vytvořením pull request, abyste se ujistili, že funguje správně.
Jakmile dokončíte provádění změn, uložte soubory a přejděte k dalšímu kroku - vytvoření fondu rekvestitu.
Jak provést změny ve větvi?
Chcete-li provést změny ve větvi svého úložiště, postupujte podle následujících kroků:
Přejděte do skloňovaného adresáře:
Vytvořte novou větev, ve které budete provádět změny:
Otevřete soubory, ve kterých chcete provést změny, pomocí libovolného textového editoru.
Proveďte potřebné změny v souborech a uložte je.
Přidejte své změny do indexu:
Proveďte commit s popisem vašich změn:
Odešlete své vlákno na vzdálené úložiště:
Přejděte na stránku úložiště na Githubu.
Klikněte na tlačítko" compare & pull request " vedle vaší větve.
Vyplňte popis Pull Request a vytvořte jej.
Po těchto krocích budou vaše změny provedeny ve větvi vašeho úložiště a budete je moci navrhnout k začlenění do hlavní větve projektu.
Krok 4: Vytvořte pull request
Když jste dokončili práci na změnách ve svém místním úložišti a nahráli je do vzdáleného úložiště na vývojové platformě, jste připraveni vytvořit pull request.
Pull request je návrh na změnu hlavní větve projektu. Poskytuje týmu možnost diskutovat o změnách, které jste provedli, zkontrolovat je a rozhodnout se přidat do hlavní větve.
Chcete-li vytvořit pull request, postupujte podle následujících kroků:
- Přejděte na stránku úložiště na vývojové platformě.
- Najděte tlačítko "New pull request" (new Pull Request) a klikněte na něj.
- Ujistěte se, že je správně vybrána základní větev (base branch). Toto je větev, do které chcete provést své změny. Obvykle se jedná o větev "main" nebo "master".
- Jako srovnatelnou větev (compare branch) vyberte větev se změnami.
- Přidejte popis změn a jakékoli další informace, které chcete týmu poskytnout.
- Klikněte na tlačítko "Create pull request" (vytvořit Pull Request) a počkejte, až bude váš pull request vytvořen.
Nyní je váš pull request vytvořen a odeslán týmu k posouzení. Kromě diskuse a kontroly může tým také spustit testy na vašich změnách před rozhodnutím o jejich přidání do hlavní větve.
Nezapomeňte sledovat aktualizace a komentáře k vašemu pull request, abyste byli informováni o změnách a odpovídali na otázky týmu.
Jak vytvořit pull request v GitHubu?
Chcete-li vytvořit pull request v GitHubu, postupujte podle následujících kroků:
Krok 1:
Přejděte na stránku úložiště, kde chcete vytvořit pull request.
Krok 2:
Klikněte na tlačítko "New pull request" umístěné nad seznamem souborů a adresářů.
Krok 3:
Vyberte si větev, ve které jsou vaše změny, a větev, do které chcete provést změny.
Krok 4:
Zkontrolujte rozdíly mezi vybranými větvemi a ujistěte se, že se všechny změny zobrazují správně.
Krok 5:
Vyplňte formulář pull request přidáním názvu a popisu změn, které děláte.
Krok 6:
Kliknutím na tlačítko "Create pull request" vytvoříte pull request.
Poté bude vytvořen Pull Request a majitel úložiště bude moci zvážit vaše změny a přijmout je do svého projektu.
Je důležité si uvědomit, že před vytvořením pull request se doporučuje provést následující kroky:
- Ujistěte se, že je vaše úložiště aktuální a neobsahuje místní změny, které nechcete odeslat spolu s pull request.
- Zkontrolujte, zda pracujete ve správné větvi a větev, do které chcete provést změny, existuje a je relevantní.
Vytvoření pull request je důležitou fází ve vývoji projektu v GitHubu. S pomocí pull request můžete provádět změny v projektech jiných lidí a nabízet své změny ostatním účastníkům projektu.