GIT – Git

GIT Et Git-lager kan bla i som en mappe: de endrede filene, grenene, historikken.

Åpne et lager

Knappen GIT i linjen hopper til favorittprosjektet, og høyreklikk gir listen: de kjente lagrene, «Commit», «Historikk…», grenene, «Stash…» og «Stasher», «Merkelapper…», «Fjernlagre». En mappe på disken som ennå ikke er et lager, tilbyr «Klon» der. Prosjektene legges til av seg selv når du går inn i dem, og et prosjekt hvis mappe er borte, glemmes – unntatt hvis det er disken som mangler, for en frakoblet minnepinne får ikke noe til å bli glemt.

Tilstanden til en mappe

Hver linje har sin farge: i konflikt, usporet, endret, klargjort, ignorert. En fil beskrives av git langs to akser – indeksen og arbeidskopien – og en linje har ikke plass til å vise begge: det er det som gjenstår å gjøre som avgjør fargen. Brødsmulestien viser gjeldende gren.

Klargjøre og committe

«Commit» åpner endringsvisningen: én fil per linje, med kolonnen Sporet som viser hva git vet om den. Du peker ut linjene som overalt ellers – klikk, Ctrl+klikk, Skift+klikk –, skriver meldingen nederst, og Commit går av sted med det som er valgt. Ingenting valgt, ingenting sendt: knappen sier det.

Knappen Ikke sporet i commit-linjen skjuler det git ikke sporer: en mappe full av engangsfiler drukner ikke lenger de to man vil committe, og Ctrl+A tar dem ikke lenger med. Avkrysset bort viser den hvor mange den skjuler.

Se forskjellene

«Vis forskjellene» åpner diffen blokk for blokk, mellom arbeidskopien, indeksen (klargjort) og en commit – før og etter er navngitt der. En binærfil sier det i stedet for å vise støy.

Handlingene

• Commit med meldingen sin.
• Ignorer: filen slutter seg til .gitignore.
• Rull tilbake: dialogen sier hvor mange nye filer som forsvinner fra disken og hvor mange som får tilbake tilstanden fra lageret. Arbeid som ikke er committet, går tapt – det står skrevet.
• Kopier › utklippstavle: en linje i endringene er en fil på disken, og kopieres som sådan – for å lime den inn andre steder, også utenfor Meneaufile. Verken klipp ut eller lim inn: listen settes sammen på nytt av git, man tar ikke ut en linje og skriver ingenting inn i den.
• Åpne på plasseringen: filen ligger et annet sted enn linjen sin – den lever i listen, filen i arbeidskopien, der den redigeres. Det er dit oppføringen fører.

Grenene og historikken

Opprette en gren, bytte til den, flette – oppføringen bærer navnet på grenen, og svarer ingenting å flette: allerede oppdatert eller flettingen stoppet: noen filer er i konflikt. «Historikk…» lister commitene: den korte hashen, emnet, forfatteren og datoen. Margen til venstre tegner grafen, hver linje på sin egen, og en fletting legger streken sin mot nabokolonnen. Et dobbeltklikk åpner detaljene til en commit: hele meldingen og filene den har rørt.

Merge request-treet

Merge request-tre… i menyen til GIT-knappen tegner de åpne MR-ene i GitLab-prosjektet remoten peker på. Hver står under grenen den går ut fra, rykket ett trinn inn som en innholdsfortegnelse: trinnet viser rekkefølgen for godkjenning, og et klikk på et kort åpner MR-en i nettleseren.

• Opprinnelsen leses i commitene. En MR som er laget fra en annen, står under den, selv når begge sikter mot main: «etter !28» sier hvilken som skal godkjennes først, og «mål main» varsler at den fortsatt sikter mot main — å flette den først ville ta med den andres commiter.
• Merkene viser tilstanden ifølge GitLab: utkast, konflikter, må rebases, må godkjennes, åpne diskusjoner, pipeline kjører, klar.
• Knappen Checkout øverst til høyre på hvert kort bytter arbeidskopien til grenen til MR-en, for å prøve eller lese den før godkjenning. Grenen hentes først fra serveren; pågående arbeid kan legges til side, som ved ethvert grenbytte. En hake markerer grenen du allerede er på.
• Det personlige tilgangstokenet med rettigheten read_api opprettes i GitLab: User settings › Access › Personal access tokens › Generate token. Meneaufile ber om det én gang og lagrer det i hvelvet, i en egen oppføring; en NET-oppføring med kontopassordet tas ikke for et token.

Utveksle med fjernlageret

«Pull» og «Push», med antall commiter det gjelder ved siden av betegnelsen – null skrives ikke. En gren som ennå ikke finnes på den andre siden, sendes med sin upstream. Fjernlagrene legges inn og fjernes fra den samme menyen. Når serveren ber om legitimasjon, spør Meneaufile på sin side i stedet for å stå fast uten å si noe.

Legge til side

«Stash…» setter unna arbeidet som pågår uten å committe det, med en valgfri beskrivelse. «Stasher» – Arbeid lagt til side – lister det som venter, og derfra gjenopptar eller forkaster du. «Merkelapper…» legger til og fjerner merkelapper på samme måte.

Hvem som skrev denne linjen

«Linjehistorikk», i menyen til en fil, tilskriver hver linje til sin commit og sin forfatter. Det er spørsmålet man stiller seg foran en overraskende linje, og en liste over commiter svarer ikke på det.

Konfliktene

En fil i konflikt åpnes på versjonene sine: den felles versjonen, vår, deres og resultatet du bygger. «Ta alt» tar hele én side, «Løs» lagrer – og filen forlater kategorien i konflikt.

Klone

Fra en mappe: adressen (https://… eller git@vert:org/lager.git), navnet på mappen som skal opprettes, og en fullstendig eller grunn historikk – de N siste commitene.

Bundlene

En .bundle-fil er et Git-lager pakket inn i én enkelt fil: nok til å ta med et prosjekt på en minnepinne, eller gi det til noen, uten server. Et dobbeltklikk viser hva den inneholder – grenene, merkelappene – og Klon her… gjør den til et vanlig lager, ved siden av den, uten nettverk. I et lager pakker Opprett en bundle… i GIT-menyen hele lageret inn i mappen i den andre visningen.

Hvis git mangler

Meneaufile kaller systemets git. Hvis det er fraværende eller utenfor PATH, sier den det i stedet for å mislykkes uten grunn.

Meneaufile-håndbok, på norsk.