priklady-resene:git [Programování]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== Git ======
Git je distribuovaný systém pro správu verzí. Slouží k ukládání historie změn souborů (převážně textových). Distribuovaný znamená, že nemusí existovat jeden centrální prvek - celá historie je k dispozici ve všech kopiích repozitáře.

Na této stránce najdete krátký přehled nejběžnějších termínů a nejčastějších příkazů (při použití příkazové řádky) pro práci se systémem git
===== Základní terminologie =====
  * repozitář - Představuje složku, která je "verzovaná" systémem git. Typicky to bývá složka celého projektu, včetně dokumentace.
  * revize - Představuje jednu konkrétní verzi repoztiáře v daném čase. V systému git je revize hash v hexadecimální (šestnáctkové) soustavě. Např: "46f32ca"
  * commit - Operace, při které se uloží stav repozitáře do historie revizí. Termín commit se často v hovoru používá i ve významu "revize". Např.: "Chyba byla opravena v commitu 46f32ca"
  * clone - Operace, pri které "naklonujeme" repozitář z jiného umístění (např. github/gitlab serveru). Tzn. že vytvoříme kopii vzdáleného repozitáře s veškerou historií na náš počítač.
  * push - Operace, kterou posíláme naše změny (commity) do vzdáleného, ale stejného repozitáře (např. github/gitlab server)
  * pull - Operace, kterou si stáhneme změny (commity) ze vzdáleného, ale stejného repozitáře (např. github/gitlab server)
  * conflict / merge conflict - Stav, ke kterému dochází zejména při použití operací pull/push. Znamená, že změny v cizím/vzdáleném repozitáři jsou v kolizi s naším/lokálním repozitářem. Typickým příkladem jsou dvě různé změny na identickém řádku souboru.

===== Workflow =====
==== Získání repozitáře ====
Pokud ještě nemáme repozitář na našem počítači, je třeba ho naklonovat (operace clone). V případě práce s naším školním gitlab serverem doporučuji používat protokol HTTPS. V prostředí příkazové řádky se klonování vzdáleného repozitáře provádí příkazem git clone. Následující příkaz vytvoří kopii repozitáře ze zadané URL ve složce specifikované jako parametr. Parametr SLOZKA lze vynechat, v takovém případe repozitář vytvoří složku odpovídající názvu repozitáře na serveru.
<code bash>
git clone https://URL_VZDALENEHO_REPOZITARE SLOZKA
</code>

Všechny následující příkazy pro práci s repozitářem je pak třeba spouštět přímo uvnitř toho repozitáře. Tzn. použít například příkaz ''cd slozka'' pro přechod do složky s repozitářem.

==== Stav a historie repozitáře ====
Pokud nás zajímá, jaký je aktuální stav repozitáře, můžeme použít příkaz ''git status''. Tento příkaz nám mimo jiné i poradí další příkazy, které je možné v dané situaci použít (v závislosti na stavu repozitáře)
<code bash>
git status
</code>

Pro zobrazení historie repozitáře můžeme použít příkaz ''git log''. Ten nám umožní interaktivní procházení historie revizí. Ukončení tohoto procházení se provádí klávesou Q
<code bash>
git log
</code>

Případně můžeme zobrazit i zjednodušený výpis historie přidáním argumentu
<code bash>
git log --oneline
</code>

==== Commitnutí změny ====
Po úspěšném naklonování repozitáře již můžete provádět změny v jeho obsahu. Pokud chceme svoji změnu uložit do historie změn, provádíme tzv. commit.

Pokud chceme provést commit, musíme mít nejdřívě změněné soubory, které přidáme do commitu příkazem ''git add''. Je to z toho důvodu, že často nechceme commitnout všechny změny naráz. Představme si, že máme upravený (a na disku uložený) soubor README.md, který chceme "commitnout". Do commitu ho přidáme příkazem ''git add'' následovně:
<code bash>
git add REAMDE.md
</code>

Soubory přidané do commitu příkazem ''git add'' jsou označovány jako "staged". Jakmile máme takto připravené soubory, je možné vytvořit commit. Commit vyžaduje, aby byl provázen věcným komentářem - tzv. commit message, která popisuje co daný commit obsahuje/aplikuje/"dělá". Pro commitnutí souboru README.md přidaného předchozím příkazem můžeme použít například následující příkaz:
<code bash>
git commit -m "Change README.md file to better describe my project"
</code>
Pokud vynecháme parametr ''-m'' s commit zprávou, otevře se výchozí textový editor, který bude čekat na napsání její napsání. Po uložení a zavření editoru typicky dojde ke commitu.

První commit vás může typicky upozornit na absenci uživatelskcýh údajů (jméno a email), které později slouží k identifikaci. Stačí jen pozorně následovat pokyny, které vám git popíše ve výstupu příkazu commit.

==== Synchronizace (push, pull) ====
Jakmile máme "commitnuté" změny, tak je často chceme nahrát na vzdálený repozitář jako je github/gitlab server. Během klonování se informace o tomto vzdáleném repozitáři ukládá ve vaší lokální kopii a nazývá se typicky "origin" (původ).
Pro nahrání našich commitů používáme příkaz ''git push''. Tato operace/příkaz vezme naše commity, které doposud nejsou ve vzdáleném repozitáři a odešle je. Pozor, jen dokončené commity. Lokální upravené soubory se neberou v potaz. Příklad:
<code bash>
git push
</code>
Případně
<code bash>
git push origin master
</code>

Pokud chceme naopak stáhnout změny, které nemáme v naší lokální kopii repozitáře, používáme příkaz ''git pull'', který je prakticky opakem příkazu push. Např.: Pokud jsem udělal doma commit + push jako v předchozích ukázkách a chci mít tyto změny k dispozici i ve škole. Je třeba jako první věc ve své kopii repozitáře na školním PC provést příkaz ''git pull'', který stáhne nové commity.
<code bash>
git pull
</code>