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 tabelloneIl 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 mattinoLa 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 ◀── C3C1 è 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 ◀── mainQuando 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 ◀── nottemain è 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 ◀── HEADQui sei su notte. Dentro la cartella .git il segnaposto è un file di una riga:
$ cat .git/HEAD
ref: refs/heads/notteCambiare 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.
- Un commit, una volta creato, non si sposta e non si cancella.
- Le frecce puntano sempre al genitore, cioè all'indietro.
- Il nuovo commit nasce dove punta HEAD, e quel branch avanza con lui.
- Un merge crea un commit con due frecce: una per ogni genitore.
- 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
▲
notteIl 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 ◀──────┘
▲
notteGuarda 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 tabelloneNon 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.
| Comando | Nel disegno |
|---|---|
git commit | Un post-it nuovo sopra HEAD; l'etichetta su cui sta HEAD avanza (regola 3) |
git switch -c notte | Un'etichetta nuova sul commit dove sei, e HEAD ci sale sopra |
git switch main | HEAD passa sull'etichetta main. Nessun commit si muove |
git merge notte | Dal branch dove sei, porta dentro notte: o l'etichetta salta, o nasce un commit con due genitori |
git branch -d notte | Toglie 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:
- Un post-it per ogni commit. Numerali nell'ordine in cui nascono: C1, C2, C3… anche il commit di merge.
- Una freccia da ogni commit al suo genitore. Il commit di merge ne ha due.
- Un'etichetta per ogni branch. Dopo ogni riga della storia, sposta le etichette che si muovono (regola 3 e 5).
- 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.