Pull request - je to způsob, jak navrhnout změny v projektu uloženém na úložišti git. Při vytváření požadavků na pull, navrhujete své změny, aby je vývojáři mohli zobrazit, diskutovat a v případě potřeby je přidat do zdrojového kódu projektu.
V této příručce vám řekneme, jak vytvořit požadavky na pull na populárních hostingech, jako jsou GitHub a Bitbucket. Popíšeme každý krok, od forku úložiště a klonování na místní stroj, až po vytvoření samotného pull request.
Proces vytváření požadavků na pull může být trochu odlišný v závislosti na hostingu, ale obecné principy zůstanou stejné. Podíváme se také na některé osvědčené postupy a tipy, které vám pomohou vytvořit efektivní požadavky na pull, které budou snadno přijaty a implementovány do projektu.
Hlavním pravidlem při vytváření požadavků na pull je být jasný a jasný. Čím lépe vysvětlíte svou změnu a proč je důležitá, tím větší je šance, že váš požadavek na pull bude přijat a začleněn do projektu.
Co je pull request?
Proces vytváření požadavků na pull začíná forkem (fork) úložiště. Fork vám umožňuje vytvořit kopii původního úložiště, se kterým můžete pracovat nezávisle. Po forku může vývojář provést potřebné změny ve svém forku. Pomocí pull request pak může navrhnout tyto změny zahrnout do původního úložiště.
Kromě samotného kódu vám pull request umožňuje také zahrnout komentáře a diskuse a na základě těchto komentářů provádět následné změny. To umožňuje vývojovému týmu společně kontrolovat a diskutovat o navrhovaných změnách před integrací do hlavního projektu.
Když je pull request vytvořen, je přístupný ostatním členům týmu. Mohou si prohlédnout provedené změny a vyjádřit svůj názor na ně. Poté může být proveden review Code, který způsobí, že určité změny mohou být v kódu provedeny a jiné mohou být odmítnuty. Celý proces diskuse a Revue se odehrává přímo na stránce pull request.
Pokud změny, které byly provedeny v aplikaci pull request, splňují požadavky a jsou schváleny vývojovým týmem, mohou být integrovány do hlavního projektu pomocí operace Merge. Po integraci se pull request zavře a všechny provedené změny se stanou součástí hlavního úložiště.
Pull request je tedy mechanismus, který umožňuje členům týmu spolupracovat na projektu a nabízet a diskutovat o změnách před jejich integrací. To hraje důležitou roli v procesu vývoje, zlepšuje kvalitu kódu a podporuje týmovou spolupráci.
Definice a princip práce
Základním principem pull request je, že vývojář vytvoří novou větev založenou na hlavní větvi projektu, provede potřebné změny a poté navrhne tyto změny v hlavní větvi prostřednictvím pull request. Vlastník projektu nebo příslušný Developer změny zkontroluje, provede jejich revizi a přijme nebo odmítne požadavky na pull.
Proces vytváření požadavků na pull zahrnuje následující kroky:
- Vytvoření nové větve na základě hlavní větve projektu.
- Změna kódu projektu ve vytvořené větvi.
- Stahování změn do vzdáleného úložiště.
- Otevření Pull request na platformě, kde probíhá vývoj projektu (např. GitHub).
- Popis provedených změn a důvody jejich provedení.
- Čekání na kontrolu a revizi pull request majitelem projektu nebo příslušným vývojářem.
- Přijetí nebo zamítnutí žádosti.
Kroky pull request se mohou lišit v závislosti na platformě používané k vývoji projektu a procesech instalovaných v týmu vývojářů.
Při použití pull request je možné zjednodušit proces revue code, zajistit spolupráci a komunikaci mezi vývojáři a sledovat změny provedené v hlavním kódu projektu.
Kroky k vytvoření požadavky na pull
Chcete-li začít pracovat na novém požadavku pull request, musíte postupovat podle následujících kroků:
1. Získejte přístup k úložišti
Prvním krokem je získat přístup k úložišti, ve kterém plánujete vytvořit požadavky na pull. K tomu budete muset mít účet na platformě, kde je úložiště uloženo, například na Githubu.
2. Zálohujte úložiště
Po získání přístupu k úložišti jej musíte forkovat. Fork úložiště vytvoří kopii úložiště na váš účet, kde budete moci provádět změny bez zásahu do původního kódu.
3. Klonujte úložiště
Po forku úložiště jej musíte naklonit do místního počítače. Chcete-li to provést, použijte příkaz git clone zadáním adresy URL vašeho forku úložiště.
4. Vytvořte novou větev
Před zahájením práce na změnách se doporučuje vytvořit novou větev. Název větve by měl být jasný a popsat podstatu provedených změn.
5. Proveďte potřebné změny
Nyní můžete provést potřebné změny kódu, komentovat, přidávat nebo mazat soubory podle účelu vašeho požadavku na natažení.
6. Udělejte commit
Jakmile jsou změny dokončeny, proveďte commit, abyste tyto změny uložili do místní větve.
7. Odešlete změny na GitHub
Chcete-li odeslat změny na GitHub, použijte příkaz git push k aktualizaci vašeho Fork úložiště.
8. Vytvořte požadavky na pull
Nyní jste připraveni vytvořit pull request. Přejděte na stránku úložiště na Githubu a klikněte na tlačítko "New pull request". Zadejte popis požadavků na pull, vyberte vlákno, do kterého chcete provést změny, a odešlete dotaz.
Gratuluji! Nyní jste vytvořili Pull request a čekáte, až bude váš příspěvek zkontrolován a přijat do hlavního úložiště.
Krok 1: Fork repozitář
Proces vytváření požadavků na pull začíná forkací (rozvětvením) úložiště, ve kterém chcete provést změny. Fork vám umožňuje vytvořit kopii úložiště na vašem účtu, kde můžete provádět změny bez dopadu na původní úložiště.
Chcete-li zálohovat úložiště, přejděte na stránku úložiště na Githubu a klikněte na tlačítko "Fork" v pravém horním rohu stránky. Po stisknutí tlačítka GitHub vytvoří kopii úložiště na vašem účtu.
Po forkaci úložiště budete přesměrováni na stránku kopie úložiště. Nyní s ním můžete pracovat, provádět změny a vytvářet požadavky na pull, abyste spojili své změny s původním úložištěm.
Krok 2: Vytvořit novou větev
Chcete-li vytvořit novou větev, budete muset přejít na stránku úložiště a kliknout na tlačítko "Branch" nebo "větev". Poté budete vyzváni k zadání názvu nové větve. Je vhodné zvolit smysluplné jméno, abyste snadno pochopili, co bylo v dané větvi změněno.
Po vytvoření nové větve na ni musíte přejít. Chcete-li to provést, budete muset najít rozevírací seznam větví a vybrat větev, kterou jste právě vytvořili.
Nyní můžete začít pracovat na svých změnách kódu. Jakmile jsou všechny změny připraveny, budete moci přejít k dalšímu kroku - vytvořit požadavky na pull, které upozorní na vaše změny a vyzvou je k provedení hlavního projektu.
Krok 3: Proveďte změny a komunikujte
Po vytvoření větve můžete začít provádět změny kódu. Chcete-li to provést, budete si muset naklonit úložiště do místního počítače. Poté budete moci otevřít soubory projektu v libovolném textovém editoru a provést potřebné změny.
Po dokončení změn musí být každá změna zaznamenána v komuniké. Commit je záznam o provedených změnách, který obsahuje popis toho, co bylo provedeno a kým.
Pro změnu můžete použít různé nástroje, jako je příkazový řádek Git nebo grafické uživatelské rozhraní (GUI), které poskytuje váš editor kódu nebo klient git.
Chcete-li vytvořit commit, budete muset zadat zprávu commitu, která bude popisovat provedené změny. Například zpráva z komuniké může vypadat takto:"opravená chyba se zobrazením tlačítka". Je důležité vytvářet informativní zprávy o komunikacích, aby bylo pro ostatní vývojáře snazší pochopit, jaké změny byly provedeny.
Jakmile je commit vytvořen,můžete jej odeslat do vzdáleného úložiště spuštěním příkazu git push origin vaše_vět. To vám umožní uložit provedené změny ve vaší větvi a připravit se na pull request.
| git add | git commit | git push |
|---|---|---|
| Přidává změny v indexu | Vytvoří výbor se změnami | Odesílá příkazy do vzdáleného úložiště |