Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Git1. Il grafop. 1

Il grafo

Fotografie, etichette e un «tu sei qui»

  • 10 minuti di lettura

Git non si impara a comandi. Si impara guardando un disegno.

Prima di scrivere un solo comando, ti serve una figura in testa: cosa c'è dentro un progetto Git e cosa succede quando lo cambi. Con quella figura, i comandi dei capitoli dopo sono solo verbi. Senza, sono formule da copiare.

Il commit è una fotografia

Un commit (in italiano: «consegna») è una fotografia di tutto il progetto, scattata in un momento preciso. Non salva «le modifiche»: salva com'è fatto ogni file adesso.

Ogni fotografia ha quattro cose:

  • un codice che la riconosce, come b12df3f;
  • un messaggio, scritto da chi l'ha scattata;
  • l'autore e la data;
  • una freccia verso la foto precedente, il genitore.

Il tabellone delle partenze di Porta Codice, tenuto da Lucia Ferri, ha tre fotografie. Ecco come le elenca Git:

$ git log --oneline
b12df3f Aggiunge gli orari del mattino
1ece7ce Aggiunge le fermate della Linea Menta
5c2c617 Primo commit: il README del tabellone

Il più recente è in alto. E questo è l'interno dell'ultimo (puoi ignorare la riga tree: è la foto dei file):

$ git cat-file -p HEAD
tree 94f86e9d4c29391c2741244cf6fa3955365d6055
parent 1ece7ce642bcfa6f50505da4266870784d010d2a
author Lucia Ferri <lucia.ferri@lineamenta.example> 1794812520 +0100
committer Lucia Ferri <lucia.ferri@lineamenta.example> 1794812520 +0100

Aggiunge gli orari del mattino

La riga parent è la freccia: il genitore di b12df3f è 1ece7ce.

Il disegno

Un commit è un post-it. La freccia va dal commit al suo genitore, cioè all'indietro. I tre commit di Lucia:

C1 ◀── C2 ◀── C3

C1 è 5c2c617, C2 è 1ece7ce, C3 è b12df3f. Il primo commit non ha genitore: la freccia parte da C2, mai da C1.

Questa storia di frecce, che si ramifica e a volte si ricongiunge, si chiama grafo. Tutto Git è questo.

Il branch è un'etichetta

Un branch (in italiano: «ramo») è un'etichetta attaccata a un commit. Non è una copia dei file: è un nome che punta a una foto.

Il branch principale si chiama main. L'etichetta sta in fondo al disegno e punta all'indietro, al commit:

C1 ◀── C2 ◀── C3 ◀── main

Quando scatti una foto nuova, l'etichetta si sposta con lei. Per questo un branch «avanza». Se Lucia fa un commit, main passa da C3 a C4.

Un secondo branch è una seconda etichetta. Lucia ne crea uno, notte (git switch -c notte) e ci scatta una foto, C4:

C1 ◀── C2 ◀── C3 ◀── main
              ▲
              └── C4 ◀── notte

main è rimasto dov'era. notte ha una foto in più. Creare un branch non costa niente: è solo un'etichetta nuova.

HEAD: «tu sei qui»

Ti manca un pezzo: quando scatti una foto, a quale etichetta la attacchi? A quella dove sei tu. Per saperlo Git ha HEAD, che vuol dire «tu sei qui». Di solito HEAD sta sopra un branch:

C1 ◀── C2 ◀── C3 ◀── main
              ▲
              └── C4 ◀── notte ◀── HEAD

Qui sei su notte. Dentro la cartella .git il segnaposto è un file di una riga:

$ cat .git/HEAD
ref: refs/heads/notte

Cambiare branch (git switch main) vuol dire una cosa sola: spostare HEAD. I commit non si muovono.

Le cinque regole d'oro

Con commit, etichette e HEAD puoi spiegare tutto quello che Git fa. Le regole sono cinque. Il resto del libro le cita per numero.

  1. Un commit, una volta creato, non si sposta e non si cancella.
  2. Le frecce puntano sempre al genitore, cioè all'indietro.
  3. Il nuovo commit nasce dove punta HEAD, e quel branch avanza con lui.
  4. Un merge crea un commit con due frecce: una per ogni genitore.
  5. Se chi riceve non è andato avanti, niente commit nuovo: si sposta solo l'etichetta (fast-forward).

La regola 1 è quella che ti toglie la paura: se sbagli un commit non lo cancelli, ne fai uno nuovo sopra che lo corregge. La storia non si riscrive, si allunga.

Unire due storie: il merge

Fare un merge (in italiano: «unire») vuol dire portare le fotografie di un branch dentro un altro. Si lancia dal branch che riceve. Ci sono due casi, e li decide la regola 5.

Il caso facile: l'etichetta salta. Se main non è andato avanti da quando è nato notte, Git non ha niente da cucire: sposta l'etichetta main sull'ultimo commit di notte. È il fast-forward («avanzamento veloce»). Non nasce nessun commit.

C1 ◀── C2 ◀── main ◀── HEAD
       ▲
       └── C3 ◀── notte

         git merge notte, lanciato da main

C1 ◀── C2 ◀── C3 ◀── main ◀── HEAD
              ▲
              notte

Il caso con due strade. Se invece main è andato avanti per conto suo, le storie si sono divise e Git non può solo spostare un'etichetta. Crea un commit di merge, con due frecce: una per ogni genitore (regola 4).

Qui Lucia ha fatto C4 su notte, e intanto Marta Villa ha fatto C5 su main (un avviso dell'ascensore). Poi Lucia unisce notte in main: nasce C6.

C1 ◀── C2 ◀── C3 ◀── C5 ◀── C6 ◀── main ◀── HEAD
              ▲             │
              └── C4 ◀──────┘
                  ▲
                  notte

Guarda cosa si è mosso: solo main (da C5 a C6). notte è ancora su C4: l'hai solo letta, non l'hai toccata. Chi riceve si muove, chi dà resta fermo.

Lo stesso disegno, nel terminale

Git sa disegnare il grafo per te, in verticale. Lo fai con git log --oneline --graph --all --decorate: ecco la storia qui sopra (il tempo va dal basso verso l'alto).

*   0920aa1 (HEAD -> main) Merge branch 'notte'
|\
| * c5ea134 (notte) Aggiunge la corsa delle 6:36
* | 14c50cb Aggiunge l'avviso dell'ascensore
|/
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone

Non devi impararlo adesso. Serve a vedere che il disegno sul foglio e quello del terminale sono la stessa cosa: 0920aa1 è C6, c5ea134 è C4, 14c50cb è C5. I comandi veri sono il tema dei prossimi capitoli: Il giro di ogni giorno e Branch e merge.

I verbi degli scenari

Nelle storie degli esercizi compaiono cinque comandi. Per ora sono solo verbi: cosa cambiano nel disegno.

ComandoNel disegno
git commitUn post-it nuovo sopra HEAD; l'etichetta su cui sta HEAD avanza (regola 3)
git switch -c notteUn'etichetta nuova sul commit dove sei, e HEAD ci sale sopra
git switch mainHEAD passa sull'etichetta main. Nessun commit si muove
git merge notteDal branch dove sei, porta dentro notte: o l'etichetta salta, o nasce un commit con due genitori
git branch -d notteToglie l'etichetta notte. I commit restano

Come si scrivono davvero e cosa rispondono è il lavoro dei capitoli dopo.

Come si disegna uno scenario

Ti daranno storie in cinque o sei righe («Nadia fa un commit, crea un branch, torna su main…») e tre domande. Il metodo è sempre lo stesso:

  1. Un post-it per ogni commit. Numerali nell'ordine in cui nascono: C1, C2, C3… anche il commit di merge.
  2. Una freccia da ogni commit al suo genitore. Il commit di merge ne ha due.
  3. Un'etichetta per ogni branch. Dopo ogni riga della storia, sposta le etichette che si muovono (regola 3 e 5).
  4. HEAD è dove sta Nadia adesso.

Disegna dopo ogni riga, non alla fine. È lì che si impara: dopo ogni riga, chiediti quale etichetta si è mossa.

Con il disegno in mano, le domande («dove punta main?», «nasce un commit nuovo?») diventano un'occhiata. Le trovi nella palestra di questo capitolo.

Ricorda

  • Un commit è una fotografia dell'intero progetto, con una freccia al genitore.
  • Un branch è un'etichetta su un commit: avanza quando fai un commit su di lui.
  • HEAD è «tu sei qui»: di solito sta sopra un branch.
  • Le frecce vanno sempre all'indietro, e un commit non cambia mai.
  • Un merge o sposta solo un'etichetta (fast-forward), o crea un commit con due genitori.
  • Si muove solo il branch che riceve.