Vai al contenuto
code-to-code

Apro l'indice…

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

Git3. Branch e mergep. 55

Branch e merge, esercizi spiegati

Cinque esempi, un comando alla volta

  • 20 minuti di lettura

Cinque esempi sul tabellone di Lucia, uno per argomento. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi i comandi e scrivi su un foglio cosa succede. Prima di aprire la risposta.
  2. In italiano: cosa fanno, a parole.
  3. Passo per passo: dove stanno HEAD e le etichette dopo ogni comando.
  4. Cosa portiamo a casa: la cosa da ricordare.

Puoi rifare ogni esempio sul tuo computer. Nello zip della palestra (la pagina dopo) c'è la cartella esempi/: dalla cartella principale dello zip lancia bash esempi/prepara.sh, poi cd esempi/progetto. Nasce il tabellone con i suoi tre commit, con i codici 5c2c617, 1ece7ce, b12df3f. Gli esempi vanno in fila: ognuno parte da dove finisce il precedente. Se ti perdi, rilancia prepara.sh e ricomincia dall'esempio A.


A · Il primo branch

Marta Villa prova le corse della notte, senza toccare main.

Terminale
git switch -c notturno
echo "23:40 M12 per Piazza Query" >> orari.txt
git add orari.txt
git commit -m "Aggiunge la corsa delle 23:40"
git log --oneline --graph --all
git switch main
cat orari.txt
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo git switch main, la riga delle 23:40 è ancora in orari.txt? E dove sono le due etichette?

$ git log --oneline --graph --all
* f4addf2 (HEAD -> notturno) Aggiunge la corsa delle 23:40
* b12df3f (main) Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone
$ git switch main
Switched to branch 'main'
$ cat orari.txt
06:00 M12 per Piazza Query
06:12 M14 per Piazza Query
06:24 M16 per Piazza Query
  • Nel log, HEAD -> notturno vuol dire «tu sei qui, e qui c'è l'etichetta notturno». main è un commit indietro.
  • Tornando su main la riga non c'è: la scrivania mostra la foto del commit di main, e quella foto non ha la corsa delle 23:40.
  • La riga non è sparita: è dentro il commit f4addf2, e torna quando fai git switch notturno.

In italiano. Nasce un'etichetta sul commit dove sono e ci vado sopra. Scrivo la corsa, la metto sul set, scatto la foto: la foto nuova è del branch su cui sono, e main non la vede. Poi torno su main: il file è quello di main.

Passo per passo.

ComandoDove sta HEADDove sta mainDove sta notturnoCommit nuovi
(all'inizio)mainb12df3fnon c'è0
git switch -c notturnonotturnob12df3fb12df3f0
git commit -m "…"notturnob12df3ff4addf21
git switch mainmainb12df3ff4addf20

Cosa portiamo a casa. switch -c non copia niente e non cambia nessun file: sposta HEAD su un'etichetta nuova. Il commit avanza l'etichetta su cui sei, non le altre.


B · Il fast-forward

Marta è contenta delle corse della notte. Sei su main.

Terminale
git merge notturno
git log --oneline --graph --all
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Nasce un commit nuovo? Dove punta main alla fine?

$ git merge notturno
Updating b12df3f..f4addf2
Fast-forward
 orari.txt | 1 +
 1 file changed, 1 insertion(+)
$ git log --oneline --graph --all
* f4addf2 (HEAD -> main, notturno) Aggiunge la corsa delle 23:40
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone
  • No, nessun commit nuovo: Git dice Fast-forward e Updating b12df3f..f4addf2, cioè «l'etichetta passa da b12df3f a f4addf2».
  • main e notturno ora sono sullo stesso commit, f4addf2. Il disegno è una riga sola.

In italiano. Sono su main, che è ancora dove era nato notturno. Quindi la strada è dritta, e Git non deve unire niente: sposta main in avanti, fino al commit di notturno.

Passo per passo.

ComandoDove sta HEADDove sta mainDove sta notturnoCommit nuovi
(all'inizio)mainb12df3ff4addf20
git merge notturnomainf4addf2f4addf20

Cosa portiamo a casa. Il merge lo lanci da chi riceve, e ti chiedi prima: main è andato avanti? Se no, è un fast-forward, e il «merge» è solo un'etichetta che salta (regola 5).


C · Le strade si dividono

Marta prepara gli orari dei festivi su un branch nuovo. Mentre lavora, Lucia aggiunge la corsa delle 6:36 su main.

Terminale
git switch -c festivi
echo "Festivi: prima corsa alle 07:00 M12" > festivi.txt
git add festivi.txt
git commit -m "Aggiunge gli orari dei festivi"
git switch main
echo "06:36 M18 per Piazza Query" >> orari.txt
git add orari.txt
git commit -m "Aggiunge la corsa delle 6:36"
git merge festivi --no-edit
git log --oneline --graph --all
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo l'ultimo git merge, nasce un commit nuovo? Quanti genitori ha? Cosa c'è nel log, dall'alto?

$ git merge festivi --no-edit
Merge made by the 'ort' strategy.
 festivi.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 festivi.txt
$ git log --oneline --graph --all
*   d08a791 (HEAD -> main) Merge branch 'festivi'
|\  
| * 4687ccb (festivi) Aggiunge gli orari dei festivi
* | bec4515 Aggiunge la corsa delle 6:36
|/  
* f4addf2 Aggiunge la corsa delle 23:40
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone
  • Sì: main è andato avanti dopo che è nato festivi, quindi serve un commit di merge. Il messaggio lo scrive Git: Merge branch 'festivi'.
  • Ha due genitori: bec4515 (la strada di main) e 4687ccb (quella di festivi). Nel log sono le due linee |\ che si separano e |/ che si riuniscono.
  • Il punto da cui le strade partono è f4addf2: è lì che le due linee si toccano in basso.
  • festivi non si è mosso: ha ancora il suo commit, e main lo raggiunge.

In italiano. festivi e main hanno fatto un commit ciascuno a partire dallo stesso punto. Non si può spostare un'etichetta in avanti, perché nessuna delle due strade contiene l'altra. Git fa una foto nuova, con le due strade come genitori, e l'etichetta main passa su quella.

Il disegno.

inizio git merge festivi se main è andato avanti sì: commit di merge, due genitori no: fast-forward, l'etichetta salta finegit merge festivimain è andato avantifast-forward, l'etichettasaltacommit di merge, duegenitorifinenosì
Fast-forward o commit di merge

Passo per passo.

ComandoDove sta HEADDove sta mainDove sta festiviCommit nuovi
git switch -c festivifestivif4addf2f4addf20
commit di Martafestivif4addf24687ccb1
git switch main e commit di Luciamainbec45154687ccb1
git merge festivi --no-editmaind08a7914687ccb1 (il merge)

Cosa portiamo a casa. Se main è andato avanti, il merge crea un commit con due genitori (regola 4). Si legge nel log: due linee che si dividono e poi si riuniscono. E --no-edit ti evita l'editor.


D · Il merge al contrario

Marta scrive un avviso su un branch, avvisi. Intanto Lucia aggiunge la corsa delle 6:48 su main. Marta vuole le novità di Lucia prima di continuare.

Terminale
git switch -c avvisi
echo "Ponte Ciclo: scala mobile ferma fino a giovedì." > avvisi.txt
git add avvisi.txt
git commit -m "Aggiunge l'avviso della scala mobile"
git switch main
echo "06:48 M20 per Piazza Query" >> orari.txt
git add orari.txt
git commit -m "Aggiunge la corsa delle 6:48"
git switch avvisi
git merge main --no-edit
git switch main
cat avvisi.txt
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo il merge, dove punta main? Cosa risponde l'ultimo cat?

$ git merge main --no-edit
Merge made by the 'ort' strategy.
 orari.txt | 1 +
 1 file changed, 1 insertion(+)
$ git log --oneline --graph --all
*   6a26a27 (HEAD -> avvisi) Merge branch 'main' into avvisi
|\  
| * 2386230 (main) Aggiunge la corsa delle 6:48
* | 660faa6 Aggiunge l'avviso della scala mobile
|/  
*   d08a791 Merge branch 'festivi'
|\  
| * 4687ccb (festivi) Aggiunge gli orari dei festivi
* | bec4515 Aggiunge la corsa delle 6:36
|/  
* f4addf2 Aggiunge la corsa delle 23:40
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone
$ git switch main
Switched to branch 'main'
$ cat avvisi.txt
cat: avvisi.txt: No such file or directory
  • main è rimasto su 2386230: il merge ha mosso solo avvisi, che ha chiesto di ricevere.
  • Il commit di merge, 6a26a27, ha due genitori: 660faa6 (l'avviso di Marta) e 2386230 (la corsa di Lucia). Il messaggio dice 'main' into avvisi: main dentro avvisi.
  • Su main il file avvisi.txt non c'è: l'avviso sta solo sul branch di Marta.

In italiano. Sono sul mio branch e chiedo a Git di portarmi dentro tutto quello che ha main. Chi riceve si muove: avvisi avanza con un commit di merge, main resta dov'è.

Passo per passo.

ComandoDove sta HEADDove sta mainDove sta avvisiCommit nuovi
commit di Marta su avvisiavvisid08a791660faa61
commit di Lucia su mainmain2386230660faa61
git switch avvisiavvisi2386230660faa60
git merge main --no-editavvisi23862306a26a271 (il merge)
git switch mainmain23862306a26a270

Cosa portiamo a casa. Il merge al contrario serve a ricevere le novità, non a darle. Dopo, il tuo branch ha tutto, e main non sa ancora niente del tuo lavoro.


E · Il branch sbagliato, e la pulizia

Marta aggiunge la corsa delle 23:55, ma si accorge solo dopo di essere su main. Poi pulisce i branch.

Terminale
echo "23:55 M14 per Piazza Query" >> orari.txt
git status
git switch -c ultima-corsa
git add orari.txt
git commit -m "Aggiunge la corsa delle 23:55"
git switch main
git branch -d notturno
git branch -d festivi
git branch -d avvisi
git branch -d ultima-corsa
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Cosa dice git status dopo git switch -c ultima-corsa? Quali dei quattro -d funzionano?

$ git switch -c ultima-corsa
Switched to a new branch 'ultima-corsa'
$ git status
On branch ultima-corsa
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   orari.txt

no changes added to commit (use "git add" and/or "git commit -a")
$ git branch -d notturno
Deleted branch notturno (was f4addf2).
$ git branch -d festivi
Deleted branch festivi (was 4687ccb).
$ git branch -d avvisi
error: the branch 'avvisi' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D avvisi'
hint: Disable this message with "git config set advice.forceDeleteBranch false"
$ git branch -d ultima-corsa
error: the branch 'ultima-corsa' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D ultima-corsa'
hint: Disable this message with "git config set advice.forceDeleteBranch false"
  • La modifica è venuta con te: la riga è ancora «modified», ora sul branch nuovo. main non ha visto niente.
  • notturno e festivi sono già dentro main: si cancellano. Git dice anche dov'erano, was f4addf2: se ti penti, quel codice basta per rifare l'etichetta.
  • avvisi e ultima-corsa hanno commit che main non raggiunge: Git si rifiuta, per non farti perdere lavoro. Il suggerimento -D forzerebbe, ma butterebbe quei commit.

In italiano. Faccio nascere il branch dove sono, con le modifiche ancora sulla scrivania, e le fotografo lì. Poi tolgo le etichette che non servono: Git me le lascia togliere solo se il lavoro è già dentro main.

Per cancellare ultima-corsa il lavoro va prima unito:

Terminale
git merge ultima-corsa
git branch -d ultima-corsa
git branch
$ git merge ultima-corsa
Updating 2386230..9686b42
Fast-forward
 orari.txt | 1 +
 1 file changed, 1 insertion(+)
$ git branch -d ultima-corsa
Deleted branch ultima-corsa (was 9686b42).
$ git branch
  avvisi
* main

Un fast-forward, perché main non si era mosso. Rimane avvisi: il suo avviso non è ancora in main, e nemmeno la sua etichetta si può togliere.

Il disegno.

inizio git branch -d nome se il branch è già dentro main sì: Git cancella l'etichetta no: errore not fully merged finegit branch -d nomeil branch è giàdentro mainnot fully mergedGit cancella l'etichettafinenosì
Il freno di git branch -d

Passo per passo (dove sono le modifiche):

ComandoScrivaniaSetBranch su cui sei
echo … >> orari.txtorari.txt modificatovuotomain
git switch -c ultima-corsaorari.txt modificatovuotoultima-corsa
git add orari.txtpulitaorari.txtultima-corsa
git commit -m "…"pulitavuotoultima-corsa
git switch mainpulitavuotomain

Cosa portiamo a casa. Due cose. Una: se hai scritto sul branch sbagliato e non hai ancora fatto il commit, git switch -c porta con sé le modifiche. Due: git branch -d è un freno di sicurezza, e il suo rifiuto non è un guaio: vuol dire «questo lavoro non è ancora in main».