Git
Git on hajautettu versionhallintajärjestelmä, jonka kehityksen aloitti Linus Torvalds Linuxin ytimen kehitystä varten. Se korvasi ytimen kehityksessä suljetun lähdekoodin BitKeeperin.
Käyttö
Seuraavassa käydään läpi Gitin peruskäyttö esimerkin avulla luomalla esimerkkiprojektille "hello" versionhallintajärjestelmä.
Versionhallinnan käyttöönotto
Luodaan ensin muutama tiedosto projektia varten: hello.c (C-kielinen lähdekoodi, ohjelma tulostaa ruudulle yhden rivin tekstiä, kääntyy komennolla gcc hello.c -o hello):
#include <stdio.h>
void main() {
printf("Hei, maailma\n");
}
README:
Esimerkkiprojekti, jonka avulla opetellaan Gitin käyttöä
Seuraavaksi alustetaan Git ajamalla projektin hakemistossa komento
$ git init Initialized empty Git repository in .git/
Kuten Git ilmoittaa, komento luo työhakemistoon piilotetun alihakemiston .git jonne Git tallentaa kaiken tarvitsemansa datan. Tämän hakemiston sisältöön ei tarvitse kiinnittää huomiota.
Tiedostojen lisääminen
Seuraavaksi lisätään versionhallinnan piiriin alussa luodut tiedostot komennolla git add:
$ git add .
Piste tarkoittaa, että versionhallinnan piiriin lisätään kaikki hakemistossa olevat tiedostot. Yksittäisten tiedostojen lisääminen on myös mahdollista:
$ git add hello.c README
Nyt kun Git tietää, että tällaisia tiedostoja on muokattu, on aika tehdä ensimmäinen "commit", eli siirretään tiedostojen uusin tila versionhallintaan yhdeksi commitiksi:
$ git commit
Komento avaa ympäristömuuttujassa EDITOR määritettyyn tekstieditoriin tiedoston, jossa #-merkeillä alkavilla riveillä lyhyesti kuvattu tehtävät muutokset. Tässä tapauksessa ilmoitetaan uusista tiedostoista hello.c ja README. Tiedostoon voidaan kirjoittaa lyhyehkö lokiin tallentuva kuvaus tehdyistä muutoksista. Risuaidalla alkavat rivit eivät päädy kommenttiin. Kun kommentti on kirjoitettu suljetaan tekstieditori, jolloin muutokset viedään versionhalintaan eli tapahtuu commit:
Created initial commit 9c5cc04: Ensimmäinen commit 2 files changed, 5 insertions(+), 0 deletions(-) create mode 100644 README create mode 100644 hello.c
Nyt lokista nähdään, että projektiin on tehty yksi muokkaus:
$ git log commit 9c5cc04010c91cf560e097c69e5c53f6a51d30ef Author: Osku Ohjelmoija <osku@linux.fi> Date: Fri Oct 23 23:39:56 2009 +0300
Ensimmäinen commit
Lokiin ilmestyvä nimi ja sähköpostiosoite voidaan asettaa komennoilla
$ git config --global user.name "Oma Nimi" $ git config --global user.email oma@sähköposti.osoite
Tiedostojen muokkaaminen
Nyt kun ensimmäinen commit on tehty voidaan alkaa kehittämään projektia jolloin näemme, miten Gitin kanssa toimitaan tiedostojen muuttuessa. Tiedosto hello.c ei ole standardin mukainen eikä se käänny suoritettavaksi ohjelmaksi. Korjataan tämä ongelma muuttamalla tiedosto muotoon hello.c
#include <stdio.h>
int main() {
printf("Hei, maailma\n");
return 0;
}
Tässä on siis muutettu toisella rivillä esiintyvä void muotoon int ja lisätty toiseksiviimeinen rivi return 0;.
Nyt tehdyt, vielä committoimattomat muutokset nähdään komennolla
$ git status # On branch master # Changed but not updated: # (use "git add <file>..." to update what will be committed) # # modified: hello.c
Eli huomataan, että tiedostoa hello.c on muokattu mutta ei vielä commitoitu. Commit tehdään kertomalla Gitille ensin, että tiedostoa on muokattu, komennolla
$ git add hello.c
ja tekemällä commit tämän jälkeen kuten aluksi
$ git commit
Edellä olevat vaiheet voi myös yhdistää ja suorittaa yhdellä komennolla
$ git commit -a
joka commitoi kaikkiin tiedostoihin tehdyt muutokset.
Muokkaushistoria
Muiden versionhallintaohjelmien tapaan Git mahdollistaa projektin etenemisen tutkimisen helposti monilla eri tavoilla. Jokaisesta commitista tehdään merkintä lokiin, joka näkyy komennolla
$ git log commit 770194dd647d7f7ab11a96cfd47ea6cd42c19f3a Author: Osku Ohjelmoija <osku@linux.fi> Date: Fri Oct 23 23:51:59 2009 +0300 Korjaus
commit 9c5cc04010c91cf560e097c69e5c53f6a51d30ef Author: Osku Ohjelmoija <osku@linux.fi> Date: Fri Oct 23 23:39:56 2009 +0300
Ensimmäinen commit
Lokissa näkyy jokaiselle commitille yksilöllinen tunnistenumero, commitin tekijä, kellonaika jolloin commit tehtiin ja committiin liittyvä kommentti. Jos loki on pitkä sitä voi selata nuolinäppäimillä tai näppäimillä j ja k ja selaamistilasta voi siirtyä takaisin komentoriville painamalla q-näppäintä. Käyttämällä valitsinta -p Git näyttää myös versioiden välillä tapahtuneet muutokset:
$ git log -p
-- (osa tulosteesta poistettu)
diff --git a/hello.c b/hello.c
index d1788b8..f4e5959 100644
--- a/hello.c
+++ b/hello.c
@@ -1,4 +1,5 @@
#include <stdio.h>
-void main() {
+int main() {
printf("Hei, maailma\n");
+ return 0;
}
Muutokset näytetään käyttäen diff-komennosta tuttua syntaksia.
Jokaisesta commitista on nähtävissä myös tarkempi yhteenveto komennolla
$ git log --stat --summary
Haarat
Haarat (engl. branch) ovat erillisinä kehityshaaroina eteneviä kehityspolkuja jotka lähtevät yhdestä tietystä commitista. Esimerkiksi ohjelmaa kehitettäessä voidaan luoda kokeellinen haara jossa tehdään radikaaleja muutoksia samalla kun ohjelman pääasialliseen kehityshaaraan tehdään maltillisempia muutoksia. Kun uudet muutokset on saatu onnistuneesti tehtyä valmiiksi kokeellisessa haarassa voidaan ne liittää (engl. merge) päähaaraan (tai johonkin toiseen haaraan). Git mahdollistaa eri haarojen monipuolisen käytön ja niitä voi huoletta käyttää runsaastikin.
Luodaan esimerkkiohjelmastamme uusi kokeellinen kehityshaara nimeltään testailu:
$ git branch testailu
Katsotaan tämän jälkeen, mitä haaroja on käytettävissä:
$ git branch * master testailu
Tähdellä (*) on merkattu tällä hetkellä aktiivisena oleva kehityshaara. master-haara luodaan aina automaattisesti oletuksena.
Siirrytään nyt uuteen kehityshaaraan komennolla
$ git checkout testailu Switched to branch "testailu"
Tehdään tässä nyt radikaaleja muutoksia ohjelmaamme: hello.c:
#include <stdio.h>
int main() {
printf("Päivää, maailma!!!!!111111\n");
printf("Vierailepa osoitteessa http://linux.fi\n");
return 0;
}
README:
Upea esimerkkiohjelma v. 2.0!
Ja tehdään muutoksista uusi commit:
$ git commit -a -m "Ohjelman versio 2.0"
Huomaa, että tässä on käytetty valitsinta -a jolloin erillistä git add -komentoa ei tarvita. Lisäksi valitsimella -m asetetaan kommentti jolloin sitä ei kysytä erikseen.
Siirrytään seuraavaksi takaisin master-haaraan:
$ git checkout master Switched to branch "master"
ja tehdään ohjelmaan pieni muutos tiedostoon hello.c. Huomaa, että git checkout latasi versionhallinnasta master-haaran sisällön joten äsken tekemämme muokkaukset eivät näy tiedostossa. Muutetaan tiedoston printf-rivi muotoon
printf("Terve maailma\n");
ja commitoidaan muutokset
$ git commit -a -m "Hienosäädetään tekstiä"
Ajatellaan nyt, että ohjelmamme on kehittynyt siihen pisteeseen että on aika ottaa kokeellisessa testailu-haarassa tehdyt muokkaukset käyttöön. Niiden käyttöönotto onnistuu nyt helposti, sillä Git osaa yhdistää kaksi kehityshaaraa. Yhdistetään testailu-haara master-haaraan ajamalla komento
$ git merge testailu Auto-merged hello.c CONFLICT (content): Merge conflict in hello.c Automatic merge failed; fix conflicts and then commit the result.
joka yhdistää testailu-haaran aktiivisena olevaan haaraan (nyt master). Git osaa automaattisesti muuttaa README-tiedoston sisällön sillä siihen ei ole tehty muokkauksia testailu-haaran luomisen jälkeen. Sen sijaan molemmissa haaroissa on muokattu hello.c-tiedostoa samasta kohdasta, joten Git ei osaa päätellä, miten muokkaukset tulisi yhdistää. Tästä syystä automaattinen yhdistäminen epäonnistuu ja yhdistäminen jätetään käyttäjän harteille.
Yhdistäminen tapahtuu muokkaamalla nyt käsin tiedostoa hello.c josta löytyy rivit
<<<<<<< HEAD:hello.c
printf("Terve maailma\n");
=======
printf("Päivää, maailma!!!!!111111\n");
printf("Vierailepa osoitteessa http://linux.fi\n");
>>>>>>> testailu:hello.c
Git on siis merkinnyt allekkain ristiriidassa olevan kohdan rivit ensin aktiivisesta haarasta ja tämän jälkeen liitettävästä haarasta. Toteamme, että teistailu-haaran ensimmäinen printf-rivi on järkyttävä, joten poistamme sen. Sen sijaan jätämme tietysti jäljelle linux.fin mainoksen. Lisäksi tiedostosta poistetaan käsin Gitin lisäämät ohjausrivit (========= yms.), jolloin tiedoston tämä osuus jää muotoon
printf("Terve maailma\n");
printf("Vierailepa osoitteessa http://linux.fi\n");
Siirretään muutokset versionhallintaan:
$ git commit -a -m "Yhdistetty kokeellisesta haarasta versio 2.0" Created commit 82fef9e: Yhdistetty kokeellisesta haarasta versio 2.0
Nyt komennolla git log nähdään, että on kyseisen commitin yhteydessä on tapahtunut kahden haaran liittäminen, sillä commitin tunnistenumeron alapuolelle ilmestyy rivi
Merge: 040c39d... b2626d8...
Numero- ja kirjainyhdistelmät viittaavat tiettyyn committeihin, joiden välillä liitos tapahtui (commitin tunnistenumerosta ilmoitetaan vain alkuosa jos se riittää yksilöimään commitin).
Kun luomallamme kehityshaaralla ei enää ole käyttöä, se voidaan poistaa komennolla
$ git branch -d testailu Deleted branch testailu.
Komento varmistaa, että haarassa tehty kehitystyö on liitetty johonkin toiseen haaraan. Jos muualle liittämätön haara halutaan tarkoituksella hylätä käytetään valitsinta -D:
$ git branch -D testailu