Vai al contenuto
code-to-code

Apro l'indice…

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

Git2. Il giro di ogni giornop. 29

Il giro di ogni giorno, esercizi spiegati

Cinque esempi, un comando alla volta

  • 20 minuti di lettura

Cinque esempi sul tabellone di Lucia Ferri, dal più semplice. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi i comandi e scrivi su un foglio cosa dirà Git. Prima di aprire la risposta.
  2. In italiano: cosa è successo, a parole.
  3. Passo per passo: dove sta ogni file, comando per comando.
  4. Cosa portiamo a casa: la cosa da ricordare.

Puoi rifare ogni esempio sul tuo computer. Scompatta lo zip della palestra (la pagina dopo), e dalla sua cartella principale:

Terminale
bash esempi/prepara.sh
cd esempi/progetto

Nasce il tabellone di Lucia, con i suoi tre commit: 5c2c617, 1ece7ce, b12df3f. I codici dei commit che farai tu saranno diversi da quelli scritti qui: dipendono da chi sei e da quando li fai.

Gli esempi A, B, C e D vanno fatti in fila, nello stesso repository: ognuno parte da dove finisce quello prima. Se fai un pasticcio, bash esempi/prepara.sh di nuovo e ricominci.


A · Cosa c'è di nuovo sulla scrivania

Lucia aggiunge la corsa delle 6:36 agli orari e comincia una bozza di avviso.

Terminale
git status
echo "06:36 M18 per Piazza Query" >> orari.txt
echo "Da lunedì Vecchia Fiera resta chiusa anche di sera." > bozza-avvisi.txt
git status
git diff

(echo "…" >> file scrive una riga in fondo al file; con > un solo segno il file nasce, o viene riscritto da capo.)

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Il primo git status:

On branch main
nothing to commit, working tree clean

Il secondo:

On branch main
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

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

no changes added to commit (use "git add" and/or "git commit -a")

E git diff:

diff
diff --git a/orari.txt b/orari.txt
index c172a6e..e514476 100644
--- a/orari.txt
+++ b/orari.txt
@@ -1,3 +1,4 @@
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
+06:36 M18 per Piazza Query
  • Prima: tutto pulito, main è fermo sull'ultima foto.
  • Poi orari.txt è modified (Git lo conosce, è cambiato) e bozza-avvisi.txt è Untracked (Git non l'ha mai visto).
  • git diff mostra solo orari.txt: la bozza è un file nuovo, non ha una versione vecchia con cui confrontarla.

In italiano.

  1. Guardo: è tutto pulito.
  2. Cambio un file e ne creo uno.
  3. Guardo di nuovo: Git distingue il file cambiato da quello nuovo.
  4. Chiedo le righe: c'è una riga con il + in fondo a orari.txt.

Passo per passo.

ComandoScrivaniaSetAlbum
(all'inizio)pulitavuoto3 commit
le due echoorari.txt modificato, bozza-avvisi.txt nuovovuoto3 commit
git status, git diffuguale: guardare non cambia nientevuoto3 commit

Cosa portiamo a casa. git status è la bussola, git diff la lente. Nessuno dei due cambia niente.


B · Dal set all'album

Lucia mette sul set solo gli orari, poi scatta.

Terminale
git add orari.txt
git status
git diff
git diff --staged
git commit -m "Aggiunge la corsa delle 6:36"
git status
git log --oneline
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo git add, git status:

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   orari.txt

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

git diff non scrive niente. git diff --staged:

diff
diff --git a/orari.txt b/orari.txt
index c172a6e..e514476 100644
--- a/orari.txt
+++ b/orari.txt
@@ -1,3 +1,4 @@
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
+06:36 M18 per Piazza Query

Il commit:

[main 00d5f85] Aggiunge la corsa delle 6:36
 1 file changed, 1 insertion(+)

Poi git status:

On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

nothing added to commit but untracked files present (use "git add" to track)

E git log --oneline:

00d5f85 Aggiunge la corsa delle 6:36
b12df3f Aggiunge gli orari del mattino
1ece7ce Aggiunge le fermate della Linea Menta
5c2c617 Primo commit: il README del tabellone
  • git diff è vuoto perché la modifica ha cambiato posto: non è più sulla scrivania, è sul set. È la sorpresa più comune.
  • 1 file changed: la foto contiene un file solo. La bozza è rimasta fuori, ed è per questo che nel secondo git status è ancora Untracked.
  • Il log ha una riga in più, in cima.

In italiano.

  1. Metto orari.txt sul set.
  2. Guardo la scrivania (git diff): non c'è più niente da vedere.
  3. Guardo il set (git diff --staged): c'è la riga delle 6:36.
  4. Scatto: la foto prende quello che c'è sul set.
  5. Guardo: sul set non c'è più niente, e la bozza è ancora lì, fuori.

Il disegno.

inizio git status passo git add orari.txt passo git diff --staged passo git commit passo git status fine la bozza resta fuorigit statusgit add orari.txtgit diff --stagedgit commitgit statusla bozza resta fuori
Il giro: guardare, scegliere, scattare

Passo per passo.

ComandoScrivaniaSetAlbum
(all'inizio)orari.txt modificato, bozza-avvisi.txt nuovovuoto3 commit
git add orari.txtbozza-avvisi.txt nuovoorari.txt3 commit
git commit -m "…"bozza-avvisi.txt nuovovuoto4 commit

Cosa portiamo a casa. Il commit fotografa il set, non la scrivania. La bozza è rimasta fuori perché non l'ho scelta, non perché sia stata «dimenticata».


C · Ho messo sul set il file sbagliato

Lucia aggiunge Vecchia Fiera alle fermate, poi si accorge che la stazione è chiusa al pubblico: non deve comparire. Ha già fatto git add.

Terminale
echo "Vecchia Fiera" >> fermate.txt
git add fermate.txt
git restore --staged fermate.txt
git status
git restore fermate.txt
git status
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo git restore --staged fermate.txt, git status:

On branch main
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:   fermate.txt

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

no changes added to commit (use "git add" and/or "git commit -a")

Dopo git restore fermate.txt:

On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

nothing added to commit but untracked files present (use "git add" to track)
  • Il primo restore (con --staged) ha tolto fermate.txt dal set, ma il file è ancora modificato: la riga «Vecchia Fiera» c'è ancora.
  • Il secondo (senza --staged) ha buttato la modifica: fermate.txt è tornato com'era nell'ultima foto, e sparisce anche da git status. Ora la riga non c'è più, e non c'è modo di riaverla.

In italiano.

  1. Cambio il file e lo metto sul set.
  2. restore --staged: lo tolgo dal set. È tornato sulla scrivania, con la modifica dentro.
  3. restore: butto la modifica. Il file torna com'era nell'ultima foto.

Passo per passo.

ComandoScrivaniaSetAlbum
echo "Vecchia Fiera" >> fermate.txtfermate.txt modificatovuoto4 commit
git add fermate.txt—fermate.txt4 commit
git restore --staged fermate.txtfermate.txt modificatovuoto4 commit
git restore fermate.txtfermate.txt com'era nell'albumvuoto4 commit

Cosa portiamo a casa. Due comandi quasi uguali, effetti opposti: con --staged non perdi niente, senza --staged butti il lavoro. Se non sei sicuro di quello che stai per buttare, guarda prima con git diff.


D · Due cose in un file

Lucia cambia orari.txt in due punti: una corsa nuova in cima (5:48) e una in fondo (6:48). Sono due fatti diversi, vuole due foto.

Terminale
cat > orari.txt <<'FINE'
05:48 M10 per Piazza Query
06:00 M12 per Piazza Query
06:12 M14 per Piazza Query
06:24 M16 per Piazza Query
06:36 M18 per Piazza Query
06:48 M20 per Piazza Query
FINE
git add -p orari.txt

Git mostra le modifiche a pezzi. Questi due sono vicini (ci sono solo quattro righe in mezzo), quindi Git li propone come un pezzo solo. Per separarli si risponde s, poi y al primo e n al secondo.

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Quello che vedi sul terminale, con in fondo ai prompt il tasto che hai premuto:

diff --git a/orari.txt b/orari.txt
index e514476..9e6d06a 100644
--- a/orari.txt
+++ b/orari.txt
@@ -1,4 +1,6 @@
+05:48 M10 per Piazza Query
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
 06:36 M18 per Piazza Query
+06:48 M20 per Piazza Query
(1/1) Stage this hunk [y,n,q,a,d,s,e,p,?]? s
Split into 2 hunks.
@@ -1,4 +1,5 @@
+05:48 M10 per Piazza Query
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
 06:36 M18 per Piazza Query
(1/2) Stage this hunk [y,n,q,a,d,j,J,g,/,e,p,?]? y
@@ -1,4 +2,5 @@
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
 06:36 M18 per Piazza Query
+06:48 M20 per Piazza Query
(2/2) Stage this hunk [y,n,q,a,d,K,g,/,e,p,?]? n

Ora git status:

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   orari.txt

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

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        bozza-avvisi.txt

orari.txt compare due volte: una per il pezzo sul set, una per il pezzo rimasto sulla scrivania.

Il resto del giro:

Terminale
git diff --staged
git diff
git commit -m "Aggiunge la corsa delle 5:48"
git add orari.txt
git commit -m "Aggiunge la corsa delle 6:48"
git log --oneline --graph
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

git diff --staged mostra solo la corsa delle 5:48:

diff
diff --git a/orari.txt b/orari.txt
index e514476..2ee870f 100644
--- a/orari.txt
+++ b/orari.txt
@@ -1,3 +1,4 @@
+05:48 M10 per Piazza Query
 06:00 M12 per Piazza Query
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query

git diff mostra solo la corsa delle 6:48:

diff
diff --git a/orari.txt b/orari.txt
index 2ee870f..9e6d06a 100644
--- a/orari.txt
+++ b/orari.txt
@@ -3,3 +3,4 @@
 06:12 M14 per Piazza Query
 06:24 M16 per Piazza Query
 06:36 M18 per Piazza Query
+06:48 M20 per Piazza Query

E alla fine il log ha due foto nuove:

* dfa2860 Aggiunge la corsa delle 6:48
* d863b9d Aggiunge la corsa delle 5:48
* 00d5f85 Aggiunge la corsa delle 6:36
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone

In italiano.

  1. git add -p mi fa scegliere pezzo per pezzo cosa mettere sul set.
  2. Spezzo il pezzo grande in due (s), prendo il primo (y), lascio il secondo (n).
  3. Il set ha una modifica, la scrivania ne ha un'altra: lo vedo con i due diff.
  4. Scatto la prima foto, poi metto sul set quello che resta (git add orari.txt ora prende tutto, ed è solo la seconda modifica) e scatto la seconda.

Il disegno.

inizio git add -p orari.txt passo s per spezzare il pezzo per ogni pezzo se è la corsa delle 5:48 sì: y, va sul set no: n, resta sulla scrivania passo git commit per le 5:48 passo git add orari.txt passo git commit per le 6:48 finegit add -p orari.txts per spezzare il pezzoper ogni pezzoè la corsa delle5:48n, resta sulla scrivaniay, va sul setgit commit per le 5:48git add orari.txtgit commit per le 6:48finenosìfiniti
Scegliere i pezzi con git add -p

Passo per passo.

ComandoScrivaniaSetAlbum
(all'inizio)orari.txt con 5:48 e 6:48vuoto4 commit
git add -p orari.txt (s, y, n)orari.txt con solo il 6:48 ancora da scattareorari.txt con il 5:484 commit
git commit -m "…5:48"orari.txt con il 6:48vuoto5 commit
git add orari.txtpulitaorari.txt con il 6:485 commit
git commit -m "…6:48"pulitavuoto6 commit

Cosa portiamo a casa. Il set non è fatto di file interi: è fatto di pezzi. git add -p ti fa scegliere quali, e una foto per ogni fatto rende la storia leggibile.


E · Una cartella nuova

Nadia Russo tiene gli oggetti smarriti di Largo Lista in un file di testo. La cartella non è ancora un repository. Per provarlo crea una cartella nuova, fuori dallo zip:

Terminale
mkdir ~/smarriti
cd ~/smarriti
echo "ombrello blu · trovato a Largo Lista, banco 2" > oggetti.txt

Poi:

Terminale
git status
git init -b main
git status
git add oggetti.txt
git commit -m "Primo commit: gli oggetti smarriti"
git status
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Il primo git status, prima di git init:

fatal: not a git repository (or any of the parent directories): .git

Dopo git init -b main:

Initialized empty Git repository in /private/tmp/tu/smarriti/.git/

E git status:

On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        oggetti.txt

nothing added to commit but untracked files present (use "git add" to track)

Il commit:

[main (root-commit) 97f567d] Primo commit: gli oggetti smarriti
 1 file changed, 1 insertion(+)
 create mode 100644 oggetti.txt

E l'ultimo git status:

On branch main
nothing to commit, working tree clean
  • Il percorso dopo Initialized empty Git repository in sarà il tuo.
  • Prima di git init non c'è nessun album: Git lo dice con fatal. È normale.
  • No commits yet: l'album c'è, ma è vuoto. oggetti.txt è Untracked come qualunque file nuovo.
  • root-commit vuol dire «la foto radice»: la prima, quella senza genitore.

In italiano.

  1. Chiedo a Git: non conosce la cartella.
  2. git init -b main: nasce l'album, sul branch main.
  3. Il file c'è ma non è mai stato fotografato.
  4. Lo metto sul set e scatto: ecco la prima foto.

Passo per passo.

ComandoScrivaniaSetAlbum
(all'inizio)oggetti.txt—non c'è
git init -b mainoggetti.txt nuovovuotovuoto
git add oggetti.txt—oggetti.txtvuoto
git commit -m "…"pulitavuoto1 commit

Cosa portiamo a casa. git init si fa una volta sola per progetto, dentro la cartella giusta. Poi il giro è sempre lo stesso: status, add, commit.

Quando hai finito puoi cancellare la cartella di prova: rm -r ~/smarriti.