Git #

Ať už programuješ nebo píšeš dokumenty, stává se, že vytvoříš několik verzí. Tuhle chceš archivovat část, která už není potřeba, tamhle chceš svoji práci poslat k ohodnocení, nebo dokonce kolegům, kteří na ni spolupracují. A když se verze začnou kupit, může být problém se v nich vyznat.

Část těchto problémů řeší nástroje jako Dropbox či Google Drive, se kterými ses možná již setkal/a. Tam můžeš například sdílet svůj dokument s dalšími lidmi nebo se můžeš vrátit k dřívější verzi dokumentu, když něco pokazíš a nemůžeš si vzpomenout, jak to bylo předtím. Příklad toho, jak to může vypadat, je zde:

V tomto rozhraní ale vidíš pouze verze jednoho dokumentu a navíc nemůžeš tušit, ke které verzi se to vlastně chceš vrátit. Nevidíš ani čím se jednotlivé verze liší. Pro větší projekt by byl takový způsob práce neefektivní.

Programátoři proto používají mocnější nástroje na správu verzí (angl. version control system - VCS). Asi nejpopulárnější z nich je Git, se kterým se teď seznámíme.

Instalace #

Popis instalace Gitu najdeš zde. Jestli jsi instalaci přeskočil/a, projdi si ji teď.

Repozitář #

Každý projekt, který budeš verzovat, musí mít pro sebe vyhrazený adresář. My budeme tenhle kurz považovat za jeden projekt. Přejdi do složky, kde máš uložené všechny materiály. Tady vytvoř gitový repozitář (angl. repository) pomocí příkazu git init:

$ git init
Initialized empty Git repository in .../.git/

Na první pohled to vypadá, že se nic nestalo. Tenhle příkaz totiž vytvořil skrytý adresář .git, do kterého uložil nějaké informace. Přesvědč se příkazem ls -a (Linux) nebo dir /a (Windows). Adresář .git je schovaný proto, že ho spravuje Git a ty bys v něm neměl/a nic měnit.

V repozitáři zatím nic není. Zkus to ověřit příkazem git status, který vypisuje informace o stavu repozitáře:

$ git status
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

„On branch main” říká něco o větvích, k tomu se vrátíme později. „No commits yet” říká, že zatím nemáš uloženou žádnou revizi. A „nothing to commit” říká, že je adresář prázdný – nejsou tu žádné soubory k verzování.

První revize #

Teď si zkus do Gitu něco přidat!

Vytvoř soubor basnicka.txt a napiš do něj nějakou básničku. Měla by mít aspoň pět řádků, ať pak máme s čím pracovat. Pak zkus znovu git status: Git oznámí, že v adresáři je soubor, o kterém ještě „neví“.

$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
    basnicka.txt

nothing added to commit but untracked files present (use "git add" to track)

U každého nového souboru musíme Gitu říct, že chceme jeho obsah sledovat. Proveď to se svojí básničkou:

$ git add basnicka.txt

a znovu zkontroluj stav repozitáře:

$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
    new file:   basnicka.txt

To, co je zelené („changes to be committed“), se přidá do další revize (angl. commit), kterou vytvoříš. Pojď tedy vytvořit revizi:

$ git commit
[main (root-commit) eb0fcd9] První revize
 1 file changed, 6 insertions(+)
 create mode 100644 basnicka.txt

Po zadání tohoto příkazu se otevře editor, do kterého musíš napsat nějaký popisek, abys věděl/a, co tahle revize obsahuje za změny. Pro začátek napiš jen První revize. Předvyplněné řádky začínající # nech být (nebo vymaž, podle chuti – Git je ignoruje). Pak soubor ulož a zavři editor.

Znovu zkus vypsat stav repozitáře:

$ git status
On branch main
nothing to commit, working tree clean

Tenhle krátký výstup znamená, že od poslední revize se nic nezměnilo. Což dává smysl – poslední revizi jsi právě vytvořil/a!

A co všechno je v téhle první/poslední revizi? To ti poví příkaz git show:

$ git show
commit eb0fcd9317cbba3d9406ffe2918dfaad667f100f
Author: Adéla Novotná <adela.novotna@example.cz>
Date:   Mon May 18 16:18:40 2020 +0200

    První revize

diff --git a/basnicka.txt b/basnicka.txt
new file mode 100644
index 0000000..558d133
--- /dev/null
+++ b/basnicka.txt
@@ -0,0 +1,6 @@
+Holka modrooká, nesedávej u potoka
+Holka modrooká, nesedávej tam
+
+V potoce je hastrmánek
+Zatahá tě za copánek
+Holka modrooká, nesedávej tam

Vidíš unikátní označení revize, pomocí kterého se vždy bude dát dostat k této konkrétní verzi projektu. Pak je tam jméno autora a datum vytvoření, popisek a nakonec shrnutí změn: byl přidán soubor basnicka.txt s nějakým obsahem.

> set LC_ALL=C.UTF-8

Druhá revize #

Udělej v básničce nějakou malou změnu – změň slovo, uprav interpunkci nebo přidej sloku. Pak se opět zeptej Gitu na stav repozitáře.

$ git status
On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
    modified:   basnicka.txt

no changes added to commit (use "git add" and/or "git commit -a")

Soubor je opět červený! Něco se v něm změnilo! Ale co? Na to nám odpoví příkaz git diff.

$ git diff
diff --git a/basnicka.txt b/basnicka.txt
index 558d133..24e2384 100644
--- a/basnicka.txt
+++ b/basnicka.txt
@@ -1,6 +1,9 @@
-Holka modrooká, nesedávej u potoka
-Holka modrooká, nesedávej tam
+Holka modrooká
+Nesedávej u potoka
+Holka modrooká
+Nesedávej tam
 
 V potoce je hastrmánek
 Zatahá tě za copánek
-Holka modrooká, nesedávej tam
+Holka modrooká
+Nesedávej tam

Změny se ukazují po řádcích. Červeně, s -, jsou ukázány odebrané řádky; zeleně s + řádky přidané.

Takhle se dá jednoduše zjistit, co se dělo od poslední verze. Když ti program přestane fungovat (a v poslední uložené revizi fungoval), použij git diff – v jedné ze změn musí být chyba!

Jsi-li se změnami spokojen/a, řekni Gitu, ať je použije v další revizi:

$ git add basnicka.txt

A pro úplnost se znovu koukni, co říká status – co je zelené, přidá se do další revize.

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    modified:   basnicka.txt

Než uděláš druhou revizi, ještě řeknu něco o tom, jak správně psát k revizím popisky. Na to je totiž úzus, který téměř všichni programátoři respektují: na prvním řádku je krátké shrnutí změn, následuje prázdný řádek a pak detailnější popis důvodů ke změně a případně změny samotné. Snaž se délku řádků držet do zhruba 70 znaků; vodítkem můžou být předvyplněné řádky začínající #. Nemá cenu popisovat, co je jasné ze změn samotných, zajímavé jsou hlavně širší souvislosti a důvody ke změnám. Cokoli, co může přijít vhod, až se změny bude snažit někdo pochopit. (Ten někdo můžeš být klidně ty, za pár měsíců.)

Můj popisek bude znít takhle:

Rozdělení dlouhých řádků

Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
takhle se to líp čte. (Ale co si budeme povídat, hlavní
důvod je ukázat, co dělá git diff.)

Pomocí git commit vytvoř druhou revizi. Pak ji zkontroluj:

$ git show
commit 1fcd654a331f290616c948d9841fd8d2a34aa6b4
Author: Adéla Novotná <adela.novotna@example.cz>
Date:   Mon May 18 16:18:40 2020 +0200

    Rozdělení dlouhých řádků

    Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
    takhle se to líp čte. (Ale, co si budeme povídat, hlavní
    důvod je ukázat co dělá git diff.)

diff --git a/basnicka.txt b/basnicka.txt
index 558d133..24e2384 100644
--- a/basnicka.txt
+++ b/basnicka.txt
@@ -1,6 +1,9 @@
-Holka modrooká, nesedávej u potoka
-Holka modrooká, nesedávej tam
+Holka modrooká
+Nesedávej u potoka
+Holka modrooká
+Nesedávej tam
 
 V potoce je hastrmánek
 Zatahá tě za copánek
-Holka modrooká, nesedávej tam
+Holka modrooká
+Nesedávej tam

Diagram #

Pro lepší pochopení, co dělají jednotlivé příkazy a v jakém stavu můžou být soubory/změny, přikládám tento diagram:

Log #

Teď, když máme za sebou první(ch) pár revizí, si ukážeme několik příkazů, které nám umožní se v nich orientovat. První z nich je git log.

$ git log
commit 1fcd654a331f290616c948d9841fd8d2a34aa6b4
Author: Adéla Novotná <adela.novotna@example.cz>
Date:   Mon May 18 16:18:40 2020 +0200

    Rozdělení dlouhých řádků

    Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
    takhle se to líp čte. (Ale co si budeme povídat, hlavní
    důvod je ukázat, co dělá git diff.)

    Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
    takhle se to líp čte. (Ale, co si budeme povídat, hlavní
    důvod je ukázat co dělá git diff.)

commit eb0fcd9317cbba3d9406ffe2918dfaad667f100f
Author: Adéla Novotná <adela.novotna@example.cz>
Date:   Mon May 18 16:18:40 2020 +0200

    První revize

Git log vypíše všechny revize od té nejnovější až po úplný začátek projektu.

Až budeš mít verzí tolik, že se nevejdou najednou na obrazovku, můžeš se v logu pohybovat pomocí šipek a PgUp/PgDn. „Ven“ se dostaneš klávesou q.

Když se na nějakou verzi budeš chtít podívat podrobněji, napiš git show 5ff0b, kde místo 5ff0b uveď prvních několik čísel z označení revize.

gitk #

Z příkazové řádky se dá vyčíst všechno potřebné, ale chce to trochu praxe. Někdy je přehlednější použít grafické „klikátko“ jménem gitk, které se dá spustit příkazem gitk --all:

$ gitk --all

Tenhle program vypadá celkem šeredně (skoro jako by ho psali programátoři, které místo designu zajímá, co je „vevnitř“), ale pro naše účely postačí. Zkus se v něm trochu zorientovat, pak ho zavři, udělej dalších pár revizí a koukni se na ně přes git log a gitk --all.

Závěr #

A to je všechno, co z Gitu zatím budeš potřebovat. Vždycky, když uděláš git add soubor a git commit, aktuální verze souborů se uloží a už nejde (jednoduše) smazat – pokud nesmažeš celý adresář .git. Jednotlivé verze a změny od posledního uložení, si umíš i prohlížet.

Možná to všechno zní jako zbytečně moc práce. Máš tak trochu pravdu – naše projekty jsou zatím dost malé na to, aby se jen pro ně vyplatilo učit Git. Ale je dobré ho používat už od začátku. Až bude správa verzí opravdu potřeba, bude se tenhle trénink hodit.

Takže odteď, kdykoliv uděláš v rámci PyLadies funkční verzi nějakého programu, pomocí git add a git commit si ji ulož do Gitu.