Vaje: Git
1. Predpriprava
Vsak študent naj preveri, ali je njegov računalnik pripravljen za delo z Git-om. Naložimo si tudi razširitev za VScode imenovano GitGraph.
2. SSH ključ
Za enostavnejšo uporabo gita naj si vsak ustvari svoj SSH ključ. Pri tem si lahko pomagamo z GitGUI, kjer pod zavihkom Help najdemo možnost Show SSH Key, kjer lahko ključ generiramo (ali pa uporabimo obstoječega). Predlagamo, da ne nastavite gesla za ključ (nastavite prazno geslo), saj ima VSCode občasno težave z gesli.
Študentje, ki ne uporabljajo operacijskega sistema Windows, naj v terminal vpišejo
ssh-keygen -t rsa -C "your_email@example.com" (kjer email zamenjajo s tistim, ki so ga uporabili za Github račun) in pritisnejo enter, da ključ generirajo na privzeti lokaciji. Javni ključ se nahaja na ~/.ssh/id_rsa.pub.
Ključ dodamo na uporabniški račun s primernim imenom (npr. osebni-racunalnik).
Če želite zamenjati geslo s katerim ste zaščitili privatni ključ (ali ga odstraniti), to lahko storite z ukazom ssh-keygen -p. V prvem koraku izberete lokacijo datoteke s ključem. Če ste ključ generirali z GitGUI, lahko za lokacijo izberete kar prazno, saj bo sam izbral default mesto.
3. Repozitorij
Vsak študent naj ustvari repozitorij z imenom Vislice. To naj storijo kar preko spletne strani GitHub, kjer naj uporabijo predpripravljen Readme.md, licenco MIT in pa .gitignore za python.
4. Uporaba repozitorija
Repozitorij naj študenti klonirajo (preko SSH) in odprejo v urejevalniku VSCode.
Ob prvem kloniranju repozitorija je potrebno dodatno potrditi, da zaupamo oddaljenemu strežniku na katerem je github. Tega trenutno ni mogoče storiti prek VSCode, kar pomeni, da je to potrebno storiti prek ukazne vrstice z ukazom: git clone link_do_repositorija. Najprej vas git vpraša če zaupate oddaljenem strežniku, na kar odgovorite z y al yes. Ko ste to storili, tega na tem računalniku ne potrebujete več in lahko od sedaj naprej uporabljate clone repository v levem panelu vsc.
5. Posodabljanje repozitorija
V repozitorij dodamo datoteke za vislice iz prejšnjih vaj (model.py, besede.txt, tekstovni_vmesnik.py). Kot se spodobi, v datoteko Readme.md napišemo kratek opis projekta. Nato spremembe shranimo v commit (z informativnim komentarjem), ki ga pošljemo na repozitorij.
Ob prvem commitu na vašem računalniku bo prišlo do napake, saj git ne ve, kdo ste in morate najprej nastaviti svoje ime in email. To storite v ukaznem pozivu z ukazoma:
git config --global user.name "Ime in Priimek" # Uporabite polno ime in priimek
git config --global user.email vas.email@email.com # Uporabite email s katerim ste registrirani na git
6. Ustvarjanje spora
Študenti naj odprejo issue, kjer naj napišejo, da v datoteki Readme.md manjkajo avtorji.
Prek spletnega vmesnika sedaj dodamo poglavje z avtorji v Readme.md in to shranimo. Če v sporočilo napišemo tudi closes #1 (kjer je #1 id issua), potem ta sprememba avtomatsko zapre dotični issue.
Nato na različici repozitorija na računalniku, brez da repozitorij posodobimo, posodobimo opis o avtorju.
Če sedaj repozitorij posodobimo (pull), bi se moral git pritožiti.
7. Razreševanje spora
Z uporabo zavihka za git v urejevalniku VSCode razrešimo spor, kjer je odločitev za izbiro imena prepuščena študentom. Dokončamo združevanje in spremembe potisnemo na GitHub.