Repository (repo)

En projektmapp som Git håller ordning på: alla filer i projektet plus hela historiken av sparade versioner.

Kallas även: kodförråd
Kategori: Git

Enkel förklaring

Ett repository, ofta förkortat repo, är en vanlig mapp på datorn som Git håller ordning på. Mappen innehåller dina filer som vanligt. Dessutom finns en dold del där Git sparar alla tidigare versioner.

Tänk på det som en pärm med ett dokument, där varje gammal version ligger sparad längst bak med datum och en lapp om vad som ändrades.

I Forgejos svenska gränssnitt heter ett repository kodförråd.

Teknisk förklaring

Ett repository består av två delar:

arbetskatalogen (working directory): filerna som du ser och redigerar
katalogen .git: Gits databas med alla sparade versioner (commits), grenar och inställningar

Det finns lokala repon på den egna datorn och fjärr-repon (remote) på en server. När man hämtar ett fjärr-repo (clone) får man en fullständig kopia med hela historiken, inte bara de senaste filerna. Ändringar flyttas mellan lokala repon och fjärr-repon med kommandona push (skicka) och pull (hämta).

Praktiskt exempel

Kodkollektivet Academy är ett repository. Det innehåller kursmaterialet, de automatiska testerna och hela historiken av alla ändringar. Repot finns på Kodkollektivets server i Forgejo, och en fullständig kopia finns hos varje person som arbetar med det.

Ett nytt repository skapas med kommandot git init i en mapp:

$ git init
Initialized empty Git repository in /home/kim/resplan/.git/

När och varför används det?

Ett repository behövs för varje projekt som ska versionshanteras med Git. Oftast hör ett repo till ett projekt: en webbplats, ett program eller en kurs.

Fjärr-repot på en server används för att dela arbetet med andra och som säkerhetskopia.

Vanliga missförstånd

“Ett repo finns bara på servern.” Nej. Kopian på din egen dator är ett fullständigt repository med hela historiken. Servern är bara en gemensam kopia.
“Mappen .git är skräp som kan tas bort.” Nej. Tar du bort .git försvinner hela historiken från datorn. Bara de nuvarande filerna finns kvar.
“Repository och projektmapp är olika saker.” De är samma mapp. Det som gör mappen till ett repository är katalogen .git i den.

Relaterade begrepp

GitEtt program som sparar versioner av filerna i ett projekt, så att man kan se vad som ändrats, gå tillbaka till tidigare versioner och arbeta flera samtidigt.

CommitEn sparad version av projektet i Git, med en beskrivning av vad som ändrats, vem som gjorde det och när.

READMEDen första filen man bör läsa i ett projekt. Den förklarar vad projektet är, hur man kommer igång och var man hittar mer.