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:
- Prevedi: leggi i comandi e scrivi su un foglio cosa succede. Prima di aprire la risposta.
- In italiano: cosa fanno, a parole.
- Passo per passo: dove stanno
HEADe le etichette dopo ogni comando. - 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.
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.txtPrevedi 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 -> notturnovuol dire «tu sei qui, e qui c'è l'etichettanotturno».mainè un commit indietro. - Tornando su
mainla riga non c'è: la scrivania mostra la foto del commit dimain, 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.
| Comando | Dove sta HEAD | Dove sta main | Dove sta notturno | Commit nuovi |
|---|---|---|---|---|
| (all'inizio) | main | b12df3f | non c'è | 0 |
git switch -c notturno | notturno | b12df3f | b12df3f | 0 |
git commit -m "…" | notturno | b12df3f | f4addf2 | 1 |
git switch main | main | b12df3f | f4addf2 | 0 |
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.
git merge notturno
git log --oneline --graph --allPrevedi 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-forwardeUpdating b12df3f..f4addf2, cioè «l'etichetta passa da b12df3f a f4addf2». mainenotturnoora 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.
| Comando | Dove sta HEAD | Dove sta main | Dove sta notturno | Commit nuovi |
|---|---|---|---|---|
| (all'inizio) | main | b12df3f | f4addf2 | 0 |
git merge notturno | main | f4addf2 | f4addf2 | 0 |
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.
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 --allPrevedi 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 è natofestivi, 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 difestivi). 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.
festivinon si è mosso: ha ancora il suo commit, emainlo 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.
Passo per passo.
| Comando | Dove sta HEAD | Dove sta main | Dove sta festivi | Commit nuovi |
|---|---|---|---|---|
git switch -c festivi | festivi | f4addf2 | f4addf2 | 0 |
| commit di Marta | festivi | f4addf2 | 4687ccb | 1 |
git switch main e commit di Lucia | main | bec4515 | 4687ccb | 1 |
git merge festivi --no-edit | main | d08a791 | 4687ccb | 1 (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.
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.txtPrevedi 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 directorymainè rimasto su 2386230: il merge ha mosso soloavvisi, 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
mainil fileavvisi.txtnon 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.
| Comando | Dove sta HEAD | Dove sta main | Dove sta avvisi | Commit nuovi |
|---|---|---|---|---|
commit di Marta su avvisi | avvisi | d08a791 | 660faa6 | 1 |
commit di Lucia su main | main | 2386230 | 660faa6 | 1 |
git switch avvisi | avvisi | 2386230 | 660faa6 | 0 |
git merge main --no-edit | avvisi | 2386230 | 6a26a27 | 1 (il merge) |
git switch main | main | 2386230 | 6a26a27 | 0 |
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.
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-corsaPrevedi 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.
mainnon ha visto niente. notturnoefestivisono già dentromain: si cancellano. Git dice anche dov'erano,was f4addf2: se ti penti, quel codice basta per rifare l'etichetta.avvisieultima-corsahanno commit chemainnon raggiunge: Git si rifiuta, per non farti perdere lavoro. Il suggerimento-Dforzerebbe, 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:
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
* mainUn 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.
Passo per passo (dove sono le modifiche):
| Comando | Scrivania | Set | Branch su cui sei |
|---|---|---|---|
echo … >> orari.txt | orari.txt modificato | vuoto | main |
git switch -c ultima-corsa | orari.txt modificato | vuoto | ultima-corsa |
git add orari.txt | pulita | orari.txt | ultima-corsa |
git commit -m "…" | pulita | vuoto | ultima-corsa |
git switch main | pulita | vuoto | main |
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».