Git
Denna artikel beskriver några kommandon och användarfall med git.
(Jag håller på att skriva om sidan från engelska till svenska då jag nu insåg att alla mina andra sidor är på svenska.)
Inställningar
Git inställningar kan var global eller per repository (sparade under .git mappen i ett repository). Globala inställningar är sparade i filen ~/.gitconfig. Det går att läsa och editera filen ~/.gitconfig manuellt, eller använda kommandot git config --global. Några exempel hur man sätter, tar bort och läser inställningar:
Vem är du?
Ställ in namn och email adress:
Pager
Du kan välja vilken 'pager' (t.ex. more, less, cat) Git ska använda. Kör detta kommando om du vill att Git ska använda cat:
Snyggare log
För att skapa alias i Git, som t.ex. att skriva ut en kompakt och snygg log med kommandot git hist, kör kommandot:
Vi använder tformat istället för format för att få med ett avslutande 'carriage return' ifall du använder cat som din pager. Utskriften från git hist kommer att se ut så här:
* 40ec614 2012-12-10 | The best commit ever (HEAD, master) [Peter Kerwien] * 4b732d0 2012-12-10 | Initial commit [Peter Kerwien]
Repository
Skapa ett repository
För att skapa ett repository i en icke-existerande katalog, kör:
Eller om du vill skapa ett repository i nuvarande katalog:
Båda kommandona kommer skapa en dold katalog som heter .git. Dessa repositoryn kan också innehålla filerna som man jobbar med dvs ett 'workspace'. Om du vill skapa ett repository som ska fungera som ett centralt repository eller dela mellan flera användare och alla ska kunna pusha till repositoryt så måste man skapa ett s.k. bare repository. Ett bare repository saknar workspace och alla git-filer ligger synliga direkt i repositoryt och inte i en katalog som heter .git. För att skapa ett bare repository, kör::
Namnkonventionen är att bare repositorys slutar med ändelsen .git i namnet.
Klona ett repository
För att klona ett repository, dvs skapa en kopia av alla dess versioner, kör:
Det spelar ingen roll om du klonar ett vanligt eller bare repository, du kommer få en klon med ett workspace. Men om du vill klona utan ett workspace, kör kommandot:
Din klon med namnet dir kommer nu inte innehålla något workspace.
Rensa workspace
Efter en del arbete kommer ditt workspace innehålla versionshanterade, ändrade men också genererade och backup-filer. En del av de icke-versionshanterade filerna listas med git status, men en del filer ignoreras via en .gitignore fil. För att rensa hela ditt workspace från alla icke-versionshanterade inklusive ignorerade filer, gå till toppen av repositoryt och kör:
Använd -n optionen för att endast lista vilka filer som skulle ha raderats.
Versionshantera, komitta och sluta versionshantera förändringar
Versionshantera förändringar
För att addera en eller flera filer till git, kör:
Om en fil redan versionshanteras, kommer kommandot att addera förändringar till index. Om du vill addera alla gjorda förändringar till index, kör kommandot:
Commit:a förändringar
För att commit:a förändringar redan adderade till index, kör:
Om man vill commit:a alla ändringar som är gjorda i redan versionshanterade filer, men ej adderade till index, kör kommandot:
Sluta versionshantera förändringar
För att ta bort en eller flera filer från workspace och index, kör kommandot:
Filerna kommer att tas bort från repositoryt när du commit:ar till repositoryt.
Lista förändringar
Lista förändringar i workspace
För att lista förändringar du har gjort i workspace, men som inte än är adderade till index, kör kommandot:
För att lista förändringar mellan ditt index och HEAD, dvs versionen du ser i repositoryt, kör kommandot:
Om du vill se alla dina icke-commit:ade förändringar (både adderade till index eller inte), kör kommandot:
Använda meld som grafiskt diff-verktyg
För att använda meld som diff-verktyg när man kör kommandot git difftool -g kör följande kommandon:
Man kan nu få upp grafiska jämförelser mellan versioner m.m. genom kommandot:
Ersätt git diff med git difftool -g i exemplen ovan. En diff med meld kan se ut så här:
(Äldre versionen visas till vänster och den nya till höger.)
Jämföra commits
Antag att vi har följande historia:
* 2634685 2012-12-18 | Commit 4 (HEAD, master) [Peter Kerwien] * d0afcbd 2012-12-18 | Commit 3 [Peter Kerwien] * aaa2574 2012-12-18 | Commit 2 [Peter Kerwien] * b61568c 2012-12-18 | Initial commit [Peter Kerwien]
För att visa alla förändringar mellan commit 2 och 3, kör:
Du kan också köra kommandot:
Välja revision
Släkt-referenser
Antag att vi har följande historia:
* 5b38862 2013-01-16 | Commit 5 (HEAD, master) [Peter Kerwien] * 9940a50 2013-01-16 | Commit 4 [Peter Kerwien] |\ | * fc796ce 2013-01-16 | Commit on test (test) [Peter Kerwien] * | f7935db 2013-01-16 | Commit 3 [Peter Kerwien] |/ * dc53825 2013-01-16 | Commit 2 [Peter Kerwien] * bea9676 2013-01-16 | Initial commit [Peter Kerwien]
Istället för att ange hela hashen för att välja version, kan man ange släkt-referenser genom att addera ^ eller ~ efter versionen. HEAD^ betyder den första föräldern till HEAD (=9940a50). Commit:en 9940a50 har två föräldrar, därför väljer 9940a50^ den föräldern som finns på nuvarande branch. Om vi är på master så kommer 9940a50^ välja commit:en f7935db. 9940a50^2 kommer välja den andre föräldern, i detta fall fc796ce. Man kan också lägga till flera ^ efter varandra. HEAD^^ kommer välja commit f7935db.
~ däremot betyder alltid den första föräldern av en commit. Så HEAD~ och HEAD^ betyder alltid samma sak. Men HEAD~2 betyder "första föräldern till första föräldern", så 9940a50~2 väljer commit:en dc53825. Detta är inte samma sak som 9940a50^2.
Man kan kombinera dessa två, t.ex. HEAD~^2. Detta betyder "den andra föräldern till den första föräldern till HEAD", dvs commit:en fc796ce.
Ångra och ändra
Ångra ändringar som inte har adderats till index
För att ångra ändringar som inte har adderats till index, kör kommandot:
Ångra ändringar som har adderats till index
För att ångra ändringar som har adderats till index, kör:
Reset kommandot återställer index till vad som pekas ut av HEAD. Reset kommandot återståller inte workspace. Så workspace kan fortfarande innehålla oönskade ändringar.
Rätta senaste commit
Om du upptäcker att någonting saknas i den senaste commit:en och du vill inte göra en ny, då kan du rätta till ditt misstag med kommandot:
Du måste dock först addera vad du saknade till index innan du kör kommandot ovan.
Ångra en commit
För att ångra en commit kan vi skapa en commit som tar bort dom förändringar som gjordes i den oönskade commit:en. För att ånga den senaste gjorda commit:en kör kommandot:
Om du vill ångra någon annan commit, ersätt HEAD med hashen. Använd optionen --no-edit om du vill acceptera standard commit meddelandet för en revert.
Ta bort en commit på en branch
När man ångrar en commit med git revert kommer både den felaktiga och återställningen synas i historian. Om man vill ångra commit:en och radera den från historian kan man flytta HEAD pekaren tillbaka till commit:en före den felaktiga och börja om från början. Antag att man har en historia som ser ut så här:
* e5f1c95 2012-12-10 | Another good commit (HEAD, master) [Peter Kerwien] * e491e6d 2012-12-10 | Good commit [Peter Kerwien] * ba30da7 2012-12-10 | Bad commit [Peter Kerwien] * 4b732d0 2012-12-10 | Initial commit [Peter Kerwien]
Om man vill slänga bort dom 3 senaste commit:erna kan man flytta HEAD till commit 4b732d0 med kommandot:
När man sen genomför en ny commit, kommer historian se ut så här:
* 40ec614 2012-12-10 | The best commit ever (HEAD, master) [Peter Kerwien] * 4b732d0 2012-12-10 | Initial commit [Peter Kerwien]
git reset --hard kommer även radera ev. icke-commit:ade ändringar i workspace. Om du vill spara alla förändringar (oavsett om de adderats till index eller inte), använd istället --soft optionen. De commit:s som blev slängda kommer fortfarande finnas kvar tills man städar repositoryt. Man kommer åt dessa commit:s via deras hash eller taggar. Man kan köra kommandot git reflog för att se var HEAD varit den senaste tiden.
Branch:a
Skapa och byta branch
Om man vill skapa och byta till en branch som heter test, kör kommandot:
Man kan också specifiera en annan branchnings punkt än HEAD via:
Eller:
Lista brancher
För att lista alla lokala brancher, kör:
Den aktuella branchen är markerad med *. Om man också vill se remote brancher, kör:
Om man bara vill lista alla lokala brancher som börjar på te, kör kommandot:
Växlar mellan branch:er
Det är väldigt enkelt att växla mellan branch:er, kör bara kommandot:
Git kommer att varna och stoppa dig om du har förändringar i workspace som inte är commit:ade.
Byta namn på en branch
För att döpa om branch:en test till dev, kör kommandot:
Radera en branch
För att radera en branch som heter test, kör:
Git kommer varna dig om branch:en inte har merge:ats ordentligt till annan branch. För att radera den trots detta, kör kommandot:
Följa en lokal branch i ett annat repository
Två användare har klonat samma repository (helloworld.git). Användare A skapar en lokal branch som heter test:
Sen skapar A en ändring och commit:ar den till sitt repository:
Nu vill B följa denna branch. B måste då först lägga till As repository som en remote:
I detta exempel kommer B kalla As repository för hello_a och URL:en är en absolut sökväg till repositoryt:
Visa detaljer om hello_a med kommandot:
* remote hello_a
Fetch URL: /home/a/git/helloworld
Push URL: /home/a/git/helloworld
HEAD branch: test
Remote branches:
master new (next fetch will store in remotes/hello_a)
test new (next fetch will store in remotes/hello_a)
Local ref configured for 'git push':
master pushes to master (up to date)
Innan B kan följa test branschen, måste B hämta heads, taggar, och objekt från As repository:
remote: Counting objects: 5, done. remote: Compressing objects: 100% (3/3), done. remote: Total 3 (delta 2), reused 0 (delta 0) Unpacking objects: 100% (3/3), done. From /home/a/git/helloworld * [new branch] master -> hello_a/master * [new branch] test -> hello_a/test
B kan nu skapa en lokal branch som B också kallar test som följer As test branch:
Byt till test branchen:
Merge
Olika typer av merge i git
I följande exempel har vi gjort 2 commit:s på en branch som heter test:
Ingen merge behövs (standard)
Om ingen commit har gjorts på master branch:en sen test skapades, kommer git göra en s.k. fast-forward merge om vi merge:ar test till master:
Updating e124053..8a48fa7 Fast-forward Makefile | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 Makefile
Git bara flyttar HEAD framåt. Så alla commit:s vi har gjort på test branch:en kommer "flyttas" till master. Om vi pushar till origin kommer vi push:a två commit:s.
Ingen merge behövs men med optionen --no-ff
Om ingen commit har gjorts på master branch:en sen test skapades, kommer git göra en s.k. fast-forward merge om vi merge:ar test till master. Men i detta fall använder vi --no-ff optionen:
Merge made by the 'recursive' strategy. Makefile | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 Makefile
Git skapar nu en merge-commit på master.
Merge behövs
Antag att någon har commit:at till master efter att vi branch:ade:
I detta fall måste git göra en vanlig merge, så vi behöver inte ange --no-ff optionen:
Merge made by the 'recursive' strategy. Makefile | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 Makefile
Git skapar nu en merge-commit på master.
Resolve merge conflicts with meld
If you have set up meld as your graphical merge-tool (See ?), you can perform graphical merge by running:
Example: After a merge from test branch to master, git prints out the following:
Auto-merging main.c CONFLICT (content): Merge conflict in main.c Auto-merging Makefile CONFLICT (content): Merge conflict in Makefile Automatic merge failed; fix conflicts and then commit the result.
Start the graphical merge:
Each file will be opened in meld for resolving the conflicts. With the configuration where meld is given 4 arguments, it will resolve all non-conflicting changes, and then leave the rest for the user to resolve. The meld window is divided into three parts. From left to right we have:
- The version on master branch (to-version)
- The merge result
- The version on test branch (from-version)
Resolve the merge by selecting the code from the left or right section into the middle section. You can also edit the code in the middle section to create the correct merge result. When done save the result.
When you have resolved the conflicts, commit the merge result.
Rebase
Rebase är ett sätt att framåt-porta dina commit:s till en nyare HEAD. Antag att vi har skapat 2 commit:s på en branch som heter test. Efter att vi branch:at så har någon annan gjort en nya commit på master:
Istället för att merga:a från master till test, vi kan rebase:a våra 2 commit:s. När man är på test branch:en, kör kommandot:
I detta exempel uppstår inga merge konflikter, så git kommer automatiskt göra rebase:en åt oss:
First, rewinding head to replay your work on top of it... Applying: Added unused attribute on argc & argv Applying: Replaced __attribute__((unused)) with -Wno-unused-parameter
Våra 2 commit:s har nu blivit modifierade och baseras nu på den nya HEAD på master.
Men en rebase på en lokal branch är att föredra framför en merge, eftersom du kommer skapa en renare historia. Det spelar ingen roll om du merge:ar eller rebase:ar, varje konflikt måste lösas ändå. Om vi nu merge:ar till master, så kommer git default att göra en fast-forward merge.
Cherry-pick
Enkel cherry-picking utan konflikt
Om man vill merge:a commit:s från en branch till en annan, och vill exakt kunna peka ut enskilda commit:s som ska tas med, då kan man göra en sk. cherry-pick. Antag att vi har följande historia:
* b5df0bb 2012-12-17 | Added main() header (HEAD, test) [Peter Kerwien] | * 12ad7c3 2012-12-17 | Whitespace edit in main.c (master) [Peter Kerwien] | * f39ba2f 2012-12-14 | Add some file headers [Peter Kerwien] | * 02d1638 2012-12-14 | Change hello message [Peter Kerwien] |/ * 0e1085d 2012-12-14 | Made some cleanup [Peter Kerwien] * 10213e2 2012-12-14 | Initial commit [Peter Kerwien]
Vi vill nu applicera commit f39ba2f på vår test branch. För att göra det, byt till test branch:en och kör kommandot:
[test 81d9476] Add some file headers 2 files changed, 4 insertions(+)
Historian vill nu se ut så här:
* 81d9476 2012-12-14 | Add some file headers (HEAD, test) [Peter Kerwien] * b5df0bb 2012-12-17 | Added main() header [Peter Kerwien] | * 12ad7c3 2012-12-17 | Whitespace edit in main.c (master) [Peter Kerwien] | * f39ba2f 2012-12-14 | Add some file headers [Peter Kerwien] | * 02d1638 2012-12-14 | Change hello message [Peter Kerwien] |/ * 0e1085d 2012-12-14 | Made some cleanup [Peter Kerwien] * 10213e2 2012-12-14 | Initial commit [Peter Kerwien]
Notera att commit f39ba2f har hashen 81d9476 på test branch:en.
Multipla cherry-picking med konflikt
Under cherry-picking, kan konflikter uppstå som måste lösas. I detta exempel kommer vi cherry-pick:a två commit:s, där den första kommer att ha konflikt med våra commit:s på test branch:en. Antag att vi har följande historia:
* e108d4a 2012-12-17 | Hello test! (HEAD, test) [Peter Kerwien] | * fdb65d7 2012-12-17 | Return EXIT_SUCCESS instead of 0 (master) [Peter Kerwien] | * 69e7150 2012-12-17 | Added argc & argv parameters to main() [Peter Kerwien] | * 413565e 2012-12-17 | Changed hello message [Peter Kerwien] |/ * 3ff2e68 2012-12-17 | Initial commit [Peter Kerwien]
Byt till test branch:en och cherry-pick:a commit:s 413565e och fdb65d7. Den första kommer ha konflikter med commit e108d4a:
error: could not apply 413565e... Changed hello message hint: after resolving the conflicts, mark the corrected paths hint: with 'git add <paths>' or 'git rm <paths>' hint: and commit the result with 'git commit'
Lös konflikterna och commit:a merge resultatet. Nu kan vi återuppta cherry-picking med kommandot:
$ git cherry-pick --continue [test 9eac083] Return EXIT_SUCCESS instead of 0 1 file changed, 2 insertions(+), 1 deletion(-)
Nu ser vår historia ut så här:
* 9eac083 2012-12-17 | Return EXIT_SUCCESS instead of 0 (HEAD, test) [Peter Kerwien] * bfc1ad9 2012-12-17 | Changed hello message [Peter Kerwien] * e108d4a 2012-12-17 | Hello test! [Peter Kerwien] | * fdb65d7 2012-12-17 | Return EXIT_SUCCESS instead of 0 (master) [Peter Kerwien] | * 69e7150 2012-12-17 | Added argc & argv parameters to main() [Peter Kerwien] | * 413565e 2012-12-17 | Changed hello message [Peter Kerwien] |/ * 3ff2e68 2012-12-17 | Initial commit [Peter Kerwien]
Vi har nu applicerat de två commit:sen och deras nya hashvärden på branch:en är bfc1ad9 respektive 9eac083.
Squash:a
När man gör en push kommer ev. flera commit:s att push:as. Det är inte alltid man vill att detta ska ske, eftersom man kanske har många commit:s på en lokal utvecklingsbranch. När man push:ar till en centralt repository kommer alla dessa commit:s att bli synliga för alla andra som klonar repositoryt. Om man istället vill push:a en feature som en enda kommit så kan man använda sig av squash:ing. En squash kan skapa en ny commit av flera andra commit:s.
Antag att vi har utvecklat en feature på en branch som heter test. Allt är rebase:at till senaste commit på master:
Skapa en ny branch från master som heter test-squash:
Merga:a alla commit:s från test, men tryck ihop dom till en enda commit:
Commit:a till test-squashed:
Vi har nu skapat en enda commit på test-squash branch:en som innehåller summan av alla commit:s gjorda på test branch:en:
Byt till master branch:en och merge:a från test-squash (fast-forward merge):
Om vi nu push:ar till origin/master kommer endast en commit att adderas:
Terminology
| Term | Description |
|---|---|
| Bare repository | Ett git repository utan workspace. |
| Klon | En kopia av ett repository. En klon innehåller alla versioner av repositoryt. |
| Workspace | Katalogen som innehåller filerna som versionshanteras. Det är här man kan editera, skapa nya filer och commit:a sina ändringar. |
| HEAD | En pekare som pekar ut den just nu valda versionen av repositoryt. |
| Staged | (Saknar bra svensk översättning). Adderad till index men inte commit:ad. |
| Cached | (Saknar bra svenska översättning). Se staged. |
| Versionshanterad fil | En fil i workspace som är adderad och versionshanterad i git repositoryt. |
| Ej versionshanterad fil | En fil i workspace som inte är adderad och versionshanterad i git repositoryt. |
| Index | Innehåller alla förändringar i versionshanterade filer som kommer commit:as när man kör kommandot git commit. |