Nauč se Python > Kurzy > GitWorking > Git > Spolupráce a Open source

Spolupráce

„Opravdové” programy zřídka vznikají prací jednoho člověka. Víc hlav víc ví, a tak je dobré si na projekt vytvořit tým.

Každý člen týmu potřebuje mít přístup k práci ostatních. K tomu se dá použít Git: někde na internetu si zařídíme sdílený repozitář, se kterým se všichni budou synchronizovat.

Pro samostudium

Pokud materiály čteš z domu a máš možnost se v budoucnu dostat na nějaký sraz, zatím tuhle sekci přeskoč. Na sraze pak popros zkušenější programátory, aby ti pomohli. (Nechystáš-li se na sraz, můžeš pokračovat – zvládnout se to dá.)

Pro kouče

Udělej na GitHubu repozitář jménem prezencka a dej do něj soubor se svým jménem. Příklad je na encukou/prezencka. Nasdílej s účastnicemi příkaz na jeho naklonování (přes https).

Open Source

Nejde mluvit o Gitu a spolupráci a nezastavit se chvíli u otevřeného zdrojového kódu. První programy vznikaly v akademické sféře, kde byly zcela přirozeně sdíleny, jako je to s poznatky mezi vědci běžné. 50. a 60. léta byla obdobím velké kreativity, kdy vzniklo mnoho z konceptů a technologií, které dnes používáme. Pak se začalo programování postupně komercializovat a firmy začaly zdrojový kód skrývat jako konkurenční výhodu. Do té doby víceméně jednolitá komunita programátorů byla nucena se rozdělit.

Některým programátorům tohle skrývání kódu hluboce vadilo. Roku 1985 publikoval Richard Stallman GNU Manifesto, kde vysvětlil, proč hodlá vytvořit operační systém s otevřeným kódem a odstartoval tak hnutí svobodného softwaru. To prosazuje 4 následujících svobod (převzato z Wikipedie):

  1. svoboda používat program za jakýmkoliv účelem,
  2. svoboda studovat, jak program pracuje a možnost přizpůsobit ho svým potřebám,
  3. svoboda redistribuovat kopie programu,
  4. svoboda vylepšovat program a zveřejňovat zlepšení, aby z nich mohla mít prospěch celá komunita.

Dnes je spousta projektů s otevřeným zdrojovým kódem (tzv. open-source projektů) dostupná na Internetu a každý je používáme. Jejich další sdílení je upraveno jednou z licencí, které tyto základní svobody zaručují.

Ne všechny jsou v Pythonu (a těm co jsou zatím nebudeš všem rozumět). Ne všechny jsou v Gitu. Ne všechny jsou kvalitní – protože si každý může zveřejnit co chce, na Internetu se válí spousta nedodělků, opuštěných nápadů a nepodařených experimentů. A bohužel, ne všechny projekty mají přátelské autory.

Na druhou stranu ale open-source programy mají svoje výhody: nejenom že se z nich může kdokoli učit, ale každý může i zkontrolovat, jestli dělají to, co dělat mají. Populární open-source programy tě například pravděpodobně nebudou špehovat (tj. hlásit autorovi, co na počítači děláš), ani většinou neobsahují reklamy: kdyby to dělaly, najde se někdo kdo tyhle „funkce” odstraní a lidi – časem – začnou používat opravenou verzi.

Některé příklady populárních open-source projektů:

Jak vidno z posledního příkladu, nejen softwarové projekty se dají vést takhle veřejně. Tento kurz vychází z principů open source: všechno know-how je sdílené a budeme rádi, když se zapojíš.

Až příště uvidíš v materiálech chybu (nebo jestli o nějaké víž už teď), dnes se dozvíš, jak ji opravit!

A co tvůj kód? Chceš ho taky dávat takhle veřejně k dispozici? Nutné to samozřejmě není – Git se dá používat i v uzavřeném týmu – ale na druhou stranu, máš důvod proč to nedělat? Zveřejňovat zdrojový kód se hodí už jen pro to, aby ti s ním mohli zkušenější programátoři snadněji pomáhat.

GitHub

Na Internetu existuje spousta stránek, kam se dají nahrávat gitové repozitáře s kódem – např. GitLab, BitBucket, Pagure nebo Launchpad. Aktuálně nejpopulárnější je ale GitHub, který si tady ukážeme.

Jestli ještě nemáš uživatelský účet na github.com, jdi tam a založ si ho.

Naklonování repozitáře (git clone)

Pro začátek zkusíme práci s repozitářem, který už vytvořil někdo jiný. V příkazové řádce zadej příkaz, který ti oznámí kouč; něco jako

$ git clone https://github.com/vojtechruz/prezencka

Vytvoří se ti nový repozitář – adresář se jménem prezencka, ve kterém je nějaký soubor.

Na URL (adresu), kterou jsi v tomhle příkladě použil/a, se můžeš podívat i v prohlížeči. Uvidíš seznam souborů a spoustu odkazů k informacím o repozitáři (například pod „commits” je historie).

Přepni se do nového adresáře (cd prezencka) a zkus se podívat na historii (gitk nebo git log). Možná je krátká, ale hlavně, že nějaká je. Máš na počítači kopii projektu, který založil někdo jiný!

Posílání změn (git push)

Teď se do projektu zapoj. Přidej soubor se svým jménem (nebo přezdívkou) a dej ho do gitu (git add jmeno.txt, git commit).

Teď zbývá „jen” změnu začlenit do původního sdíleného repozitáře. To ale není jen tak: repozitář, který jsi naklonoval/a, patří koučovi. A tomu by se asi nelíbilo, kdyby kdokoliv na Internetu mohl přijít a nahrát mu do repozitáře změny.

Spousta míst na Internetu funguje tak, že vybraná skupina lidí má „přístup”: můžou dělat změny, jak se jim líbí.

S Gitem se používá jiný přístup: změny nahraješ do vlastního sdíleného repozitáře a majiteli původního projektu napíšeš žádost o začlenění těch změn (angl. pull request). Může to být třeba mail se slovy „Hele, na té a té adrese mám nějaké změny, které by se ti mohli hodit! Přidej je do svého projektu!”

Výhoda je v tom, že se do projektu – pokud je veřejný – může zapojit kdokoliv. Nemusíš se předem ptát, nemusíš dokazovat že jsi důvěryhodná osoba, stačí něco změnit a poslat. Jestli se změna bude autorům projektu líbit nebo ne, to už je jiná věc. Ale záleží hlavně na samotné změně, ne na tom, kdo ji udělal.

Služba github.com ti umožňuje si udělat vlastní sdílený repozitář a zjednodušuje začleňování změn (místo posílání mailů stačí zmáčknout tlačítko). Pojďme se podívat, jak na to.

Přihlaš se na GitHub a pak zajdi na adresu kterou jsi použil/a pro git clone. Vlevo nahoře najdi tlačítko „Fork” a klikni na něj. Tím si vytvoříš na GitHubu vlastní kopii repozitáře: adresa by měla být něco jako https://github.com/tvojejmeno/prezencka.

Kdybys měl/a v různých kopiích repozitáře zmatek, přijde vhod malé vysvětlení: jedna kopie je původní projekt na GitHubu, kam správce projektu dává aktuální „oficiální verzi“. Další kopie na GitHubu je „tvoje“ a můžeš si do ní nahrát co chceš (nejčastěji v ní ale zveřejňuješ změny, které můžou být užitečné pro ostatní). A třetí kopii repozitáře máš u sebe na počítači.

Diagram tří repozitářů

A teď, jak z tvého počítače nahrát změny na GitHub? Git si u každého repozitáře na tvém počítači pamatuje adresy, odkud se dají stahovat a kam se dají posílat změny. Seznam těchhle adres ti ukáže příkaz git remote -v. Třeba:

$ git remote -v
origin  https://github.com/vojtechruz/prezencka (fetch)
origin  https://github.com/vojtechruz/prezencka (push)

Tenhle výstup znamená, že pod zkratkou „origin” se schovává adresa, ze které jsi repozitář naklonoval/a.

Přidej si podobnou zkratku pro vlastní repozitář na GitHubu. Nezapomeň nahradit tvojejmeno za jméno účtu, který máš na GitHubu ty. (Pozor, v příkazu je tvojejmeno dvakrát!)

$ git remote add tvojejmeno https://github.com/tvojejmeno/prezencka

a zkontroluj si, že se to povedlo:

$ git remote -v
origin  git@github.com:vojtechruz/prezencka.git (fetch)
origin  git@github.com:vojtechruz/prezencka.git (push)
tvojejmeno      https://github.com/tvojejmeno/prezencka (fetch)
tvojejmeno      https://github.com/tvojejmeno/prezencka (push)

Tolik k nastavení – git remote add stačí udělat jednou pro každý repozitář. Pak už můžeš změny nahrávat pomocí:

$ git push tvojejmeno master

což znamená: pošli na adresu uloženou pod zkratkou tvojejmeno větev master.

Funguje? Podívej se na https://github.com/tvojejmeno/prezencka v prohlížeči a ujisti se, že tam tvoje změny jsou.

Žádost o začlenění (pull request)

Teď zbývá požádat autory původního projektu, aby změny z tvého sdíleného repozitáře přidali do svojí kopie. GitHub na to má mechanismus zvaný pull request (žádost o začlenění).

Jdi na stránku původního projektu (na adresu, kterou jsi použil/a na začátku pro git clone). Měl/a bys tam vidět oznámení o své nově nahrané větvi s velkým zeleným tlačítkem Compare & pull request. Klikni na něj. Pokud chceš, tak dopiš/změň popisek toho, co tahle změna obnáší. Pak zmáčkni další tlačítko.

Jestli tlačítko Compare & pull request nevidíš, běž na adresu své kopie repozitáře a stiskni tlačítko New pull request. Vyber, co kam chceš začlenit, dopiš/změň popisek a pak zmáčkni Create pull request.

Hotovo; teď je na autorech projektu, aby se na změny podívali a přijali – nebo začali diskusi o tom, jak je ještě vylepšit. (Diskutovat se dá na stránce pull requestu nebo přes mail.)

Pro samostudium

Procházíš-li materiály z domu, musíš teď počkat, než si někdo tvé žádosti všimne a začlení ji. To může trvat i pár dní; kdyby to bylo přes týden, tak se na stránce pull requestu zkus připomenout.

Aktualizace (git pull)

Když budou tvé změny – a změny od ostatních – začleněné, můžeš si aktualizovat lokální repozitář. (To je ten, který máš u sebe na počítači.)

To se dělá příkazem git pull origin master (stáhni změny z větve „master” z adresy pod zkratkou „origin”). Pomocí gitk --all nebo git log se můžeš podívat, jak se projekt mezitím vyvinul.

Gratuluji! Právě jsi prošel/prošla „kolečkem“, které většina programátorů dělá denně: udělání nějaké změny, odeslání kolegům na kontrolu a začlenění a stažení změn od ostatních.

Hlášení chyb (issues)

Občas nastane situace, kdy v nějakém projektu na GitHubu najdeš chybu, ale nemáš čas nebo znalosti, abys ji opravil/a. V takovém případě často na GitHubu na stránce projektu pod záložkou Issues najdeš seznam nahlášených problémů. Nenajdeš-li mezi nimi „svoji” chybu, můžeš ji nahlásit – stačí kliknout na New Issue a můžeš psát, kdy chyba nastává, co program dělá špatně a co by měl dělat místo toho.

Některé projekty nepoužívají Issues na GitHubu. Kdybys záložku Issues nenašel/nenašla, podívej se do dokumentace projektu, jestli tam není odkaz na seznam chyb.

README: Informace pro ostatní

Pokud vytváříš projekt a chceš, aby do něj přispívali i ostatní, je potřeba aby věděli, co tvůj projekt dělá, k čemu se hodí, jak se používá a podobně.

Na základní informace o projektu/repozitáři se používá soubor README (z angl. read me, čti mě). Do tohoto souboru patří mj.:

  • název projektu,
  • stručný popis projektu (jedna až dvě věty),
  • krátký návod k instalaci projektu,
  • krátký návod ke spuštění projektu,
  • krátký návod k používání projektu, případně odkaz na rozsáhlejší dokumentaci,
  • pokud má projekt testy, informace o tom, jak je spustit,
  • informace o tom, jak se zapojit do vývoje projektu,
  • informace o autorech projektu,
  • informace o licenci (více se licencích dozvíš později).

README by mělo být členěné a jeho přečtení by nemělo zabrat uživateli hodinu, většinou stačí krátké úderné informace s případným odkazem někam dál. Není tedy například potřeba vysvětlovat v každém projektu, jak se instaluje Python. Stačí říct, že Python je potřeba (a v jaká verze) a odkázat uživatele na patřičný návod. Je také třeba brát v úvahu, kdo bude README číst. Píšete-li program pro jiné vývojářky a vývojáře, často není třeba zabrušovat do velikých detailů.

GitHub (a spousty jiných podobných služeb) umožňuje pro README použít nějaký značkovací jazyk, například Markdown. Je možné pak používat nadpisy, obrázky apod.

V neposlední řadě – aby se do projektu mohl zapojit kdokoli z celého světa, bývají open-source projekty v angličtině. Jména proměnných, komentáře, dokumentace – všechno je primárně v anglické verzi. Tenhle kurz je česky, aby byly začátky jednodušší, ale jestli se ti programování zalíbilo a chceš v něm po kurzu pokračovat dál, bez angličtiny to bude velice složité.

Licence

Aby sdílení fungovalo i pro právní stránce, nestačí když nahraješ kus kódu na Internet. Musíš taky oficiálně oznámit, že si s ním ostatní můžou hrát. Bez licence totiž nemá nikdo právo tvůj program ani používat, natož vylepšovat.

Problematika licencí může být, bohužel, docela složitá. Když to ale zjednodušíme na minimum, budeš chtít jen zajistit, aby každý mohl tvůj výtvor používat, učit se z něj, předávat ho dál a vylepšovat ho. V tom případě vyber třeba licenci MIT.

Pokud chceš navíc zabránit tomu, že si tvůj kód někdo vezme a začne ho „vylepšovat“ a vydělávat na něm, aniž by se o vylepšení podělil s ostatními, zkus licenci AGPL.

A tyto materiály jsou pod ještě jinou licencí – CC BY-SA – protože výše jmenované licence jsou dělané na programy, ne na text.

Kód se nejčastěji licencuje tak, že text licence dáš do souboru jménem LICENSE a přidáš do Gitu.

Chceš-li si o licencích přečíst něco víc, odkážu tě na choosealicense.com, případně creativecommons.org a opensource.org.


Toto je stránka lekce z kurzu, který probíhá nebo proběhl naživo s instruktorem.