Vai al contenuto
code-to-code

Apro l'indice…

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

Git2. Il giro di ogni giornop. 24

Il giro di ogni giorno

Guarda, scegli, scatta

  • 10 minuti di lettura

Nel capitolo precedente hai visto cosa c'è dentro Git: fotografie (i commit) legate l'una all'altra. Adesso impari a scattarle.

Quasi tutto il lavoro con Git è sempre lo stesso giro, tutti i giorni:

  1. guardi cosa è cambiato (git status, git diff);
  2. scegli cosa mettere nella prossima foto (git add);
  3. scatti (git commit).

Pochi comandi, più due per rimediare agli errori: git restore e git restore --staged.

I quattro posti

Un file, prima di entrare nell'album, passa da tre posti. Uno lo conosci già: è la cartella dove lavori.

SCRIVANIA ──── git add ────▶ SET ──── git commit ────▶ ALBUM ──── git push ────▶ ALBUM ONLINE
          ◀── git restore --staged ──                  (le foto scattate)          (capitolo 5)
PostoCos'èCome lo guardi
ScrivaniaI tuoi file, come sono adesso. Li modifichi con VS Codegit diff
SetQuello che entrerà nella prossima fotogit diff --staged
AlbumLe foto già scattate, sul tuo computergit log
Album onlineLa copia su GitHub. Per ora solo il nome: ci arriviamo nel capitolo 5—

Il set esiste per un motivo: ti permette di scegliere. Hai cambiato tre file ma ne vuoi fotografare uno? Metti sul set solo quello.

Il set si chiama anche staging area (staged vuol dire «sul set»): lo troverai scritto così nei messaggi di Git.

git status: la bussola

git status ti dice dove sta ogni file. Lancialo prima e dopo ogni comando: è gratis, e non cambia niente.

Questo è il tabellone di Lucia con tre cose in corso: orari.txt è già sul set, fermate.txt è modificato solo sulla scrivania, bozza-avvisi.txt è un file nuovo.

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

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

Tre blocchi, tre posti:

Il blocco diceVuol direDov'è il file
Changes to be committedEntrerà nella prossima fotoSul set
Changes not staged for commitGià nell'album, ma cambiato: non entreràSulla scrivania
Untracked filesUn file nuovo che Git non conosceSulla scrivania, mai fotografato

E le righe tra parentesi? Sono i suggerimenti di Git: ti dicono già il comando per spostare il file. Leggile.

I file Untracked possono restare dove sono: se non li metti sul set, non entrano mai nell'album. Come non vederli più in git status lo impari nel capitolo 6.

Una cartella nuova: git init

Per far seguire a Git una cartella che non è ancora un repository, lo scrivi una volta sola, dentro la cartella:

Terminale
git init -b main
Initialized empty Git repository in /private/tmp/tu/smarriti/.git/

(Il percorso sarà il tuo.) Nasce la cartella nascosta .git: è l'album. -b main dà il nome main al branch.

git add: scegli cosa fotografare

Terminale
git add orari.txt        # un file
git add orari.txt fermate.txt   # due file
git add .                # tutto quello che è cambiato, in questa cartella
git add -p orari.txt     # un pezzo alla volta

git add . è comodo ma non sceglie: mette sul set tutto, anche la bozza a metà e il file che non doveva uscire. Guarda sempre git status prima.

git add -p (p come patch, «pezzo») fa vedere le modifiche un pezzo alla volta, e per ogni pezzo chiede cosa fare:

TastoCosa fa
ySì: questo pezzo va sul set
nNo: questo pezzo resta sulla scrivania
sSpezza il pezzo in pezzi più piccoli (se ci sono righe invariate in mezzo)
qBasta: esci, quello che hai già scelto resta sul set

Serve quando in un file hai fatto due cose diverse e vuoi due foto diverse.

git commit: scatta

Terminale
git commit -m "Aggiunge la corsa delle 6:36"
[main 00d5f85] Aggiunge la corsa delle 6:36
 1 file changed, 1 insertion(+)

Il commit fotografa quello che è sul set, non quello che è sulla scrivania. 00d5f85 è il codice della foto: i tuoi codici saranno diversi, perché dipendono da chi sei e da quando scatti.

Il messaggio, dopo -m, tra virgolette. Un buon messaggio dice cosa fa il commit, come se completasse la frase «questo commit…»:

Così sìCosì no
Aggiunge la corsa delle 6:36modifiche
Corregge l'orario del M14fix
Toglie Vecchia Fiera dalle fermateAggiunto cose varie.

Verbo alla terza persona, maiuscola, niente punto, una cosa sola.

git log: le foto scattate

Terminale
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

Una riga per foto, la più recente in alto: il codice corto e il messaggio. Con --graph Git disegna anche le frecce, in verticale. Finché la storia è dritta è una colonna di asterischi:

* 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

Con i branch diventa un disegno vero: lo vedi nel capitolo 3. Il git log senza opzioni mostra anche autore e data, e se è lungo apre una schermata che si chiude con q.

git diff: cosa è cambiato, riga per riga

git status dice quali file. git diff dice quali righe. Ci sono due versioni, una per posto:

ComandoConfrontaRisponde a
git diffscrivania con set«Cosa ho cambiato e non ho ancora messo sul set?»
git diff --stagedset con album«Cosa c'è sul set, cioè cosa entrerà nella foto?»
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

Come si legge: le righe con il + sono aggiunte, quelle con il - sono tolte, quelle senza segno sono solo il contesto, per farti capire dove siamo. La riga con @@ dice a che altezza del file.

git restore: tornare indietro di un passo

Due comandi, per due errori diversi. Non confonderli.

Hai fattoComandoCosa succede
Un file è finito sul set per sbagliogit restore --staged fermate.txtTorna sulla scrivania. Le tue modifiche restano nel file
Una modifica sulla scrivania è sbagliatagit restore fermate.txtIl file torna com'era nell'ultima foto. Le modifiche si perdono

Il giro, in una tabella

Voglio…Comando
Sapere dove sta ogni filegit status
Vedere le righe cambiate sulla scrivaniagit diff
Vedere le righe che sono sul setgit diff --staged
Mettere un file sul setgit add file
Mettere sul set un pezzo alla voltagit add -p file
Scattare la fotogit commit -m "Messaggio"
Vedere le foto scattategit log --oneline --graph
Togliere un file dal setgit restore --staged file
Buttare le modifiche di un filegit restore file

Ricorda

  • Quattro posti: scrivania, set, album, album online. Il commit fotografa il set.
  • git status prima e dopo ogni comando: è la bussola.
  • git add sceglie; git add . non sceglie, mette tutto.
  • Un messaggio dice cosa fa il commit: «Aggiunge…», «Corregge…», mai «modifiche».
  • git diff guarda la scrivania, git diff --staged guarda il set.
  • restore --staged toglie dal set e non perde niente; restore senza --staged butta le modifiche.