Vai al contenuto
code-to-code

Apro l'indice…

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

Git6. Rimettere a postop. 145

La cucina di Ottavio

Un quaderno di ricette, sei livelli

  • 90–120 minuti di lavoro

Mensa del deposito, Linea Menta. Lunedì mattina.

Lo chef Ottavio Brambilla ti chiama dalla cucina con il mestolo in mano. «Venerdì sera c'è la cena per i cinquant'anni della Linea. Le mie ricette sono sparse in un quaderno, tre taccuini e la testa di Pina. Voglio tutto in Git, prima di venerdì. Siamo in tre a lavorarci: io, Pina Galli e tu.»

Poi aggiunge, abbassando la voce: «E tienimi fuori le foto, che pesano. E i miei appunti, che sono miei.»

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

git-rimettere-a-posto.zip48 KB

Lo zip è lo stesso della palestra: la storia è nella cartella storia/.

I file

FileCosa c'èSi tocca?
livello-1/ … livello-6/In ognuno: prepara.sh (costruisce il quaderno), il test; il livello 6 ha anche unisci-pr.shSolo progetto/, dopo prepara.sh
cucina.shCom'è il quaderno all'inizio di ogni livelloNo
mensa.bundleLa storia del GitHub della mensa, per i livelli 5 e 6No, non si apre
verifica.pyOttavio controlla il nome che gli dai alla fineNo
README.mdLe consegne di tutti i livelli, in breveSi legge

Come si gioca

Un livello alla volta, dalla cartella principale dello zip:

Terminale
cd storia/livello-1
bash prepara.sh          # nasce progetto/ (e, dal livello 5, github.git/)
cd progetto
git status               # e poi i comandi del livello
cd ..
pytest -v                # oppure, dalla cartella principale: pytest storia -k livello_1

Ogni livello comincia dal quaderno com'era alla fine del livello prima, fatto giusto: se sbagli un livello, il prossimo parte comunque da una base buona. Pasticcio? bash prepara.sh di nuovo.


Livello 1 · Il primo commit

«Foto e appunti restano fuori. Il resto, nel quaderno.»

La cartella progetto/ ha dentro le ricette (ricette/), un menu.txt, un README.md, le foto (foto/) e gli appunti-di-ottavio.txt. Non è ancora un repository.

La cosa nuova: git init -b main e il .gitignore prima del primo git add .. È l'esempio F.

Cosa fai. Dentro progetto/, crea il repository sul branch main. Scrivi un .gitignore che nasconda la cartella foto/ e il file appunti-di-ottavio.txt. Fai il primo commit con tutto il resto, .gitignore compreso.

Aiutino 1
git init con -b main crea il repository e chiama il branch main. Dopo, git status elenca tutto come «Untracked».
Aiutino 2
Prima il .gitignore, poi git status: foto/ e gli appunti devono sparire dall'elenco. Solo allora git add ..

Livello 2 · Il sale e lo zucchero

«Pina ha messo il sale al posto dello zucchero nel tiramisù. E la panna cotta, non so cos'abbia fatto. Il risotto invece l'ha sistemato bene.»

Pina ha lavorato sul tuo computer e ha scritto git add . senza guardare: sul set ci sono tre file, di cui uno solo giusto.

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   ricette/panna-cotta.txt
        modified:   ricette/risotto.txt
        modified:   ricette/tiramisu.txt

La cosa nuova: git restore insieme a git restore --staged. È l'esempio A.

Cosa fai. Il tiramisù e la panna cotta tornano com'erano (né sulla scrivania né nel set). Nella foto nuova va solo il risotto (il brodo a 14 litri).

Aiutino 1
I due file sbagliati sono sul set: prima li togli da lì, e solo dopo la scrivania può tornare com'era.
Aiutino 2
Se git restore da solo sembra non fare niente, è perché il set è uguale alla scrivania: serve --staged. Poi, git status prima del commit.

Livello 3 · Il cassetto

«Il menu della cena lo stai scrivendo? Bene. Ma vedo che il secondo del menu normale è scritto male: "arosto". Correggilo subito, su main.»

Sei sul branch cena, con il menu della cena a metà sulla scrivania. Se provi a passare su main:

error: Your local changes to the following files would be overwritten by checkout:
        menu.txt
Please commit your changes or stash them before you switch branches.
Aborting

La cosa nuova: lo stash, quando Git te lo chiede. È l'esempio C.

Cosa fai.

  1. Metti da parte il lavoro a metà, passa su main e correggi il secondo: Secondo: arrosto con patate (con due r). Fai il commit.
  2. Torna su cena, riprendi il lavoro a metà, e finisci il menu: resta la riga Caffè: espresso e amaretti che avevi cominciato. Fai il commit.
  3. Torna su main e unisci cena.

Alla fine il cassetto è vuoto, sei su main, e il menu su main è:

Menu della cena dei cinquant'anni
Primo: risotto alla milanese
Secondo: arrosto con patate
Dolce: tiramisù
Bevande: acqua e vino della casa
Caffè: espresso e amaretti
Aiutino 1
Il messaggio di Git nomina il comando: stash. Dopo, git status deve dire che non c'è niente da committare.
Aiutino 2
Il cassetto va svuotato con un comando che ha pop nel nome. Poi non dimenticare il commit: il menu è sulla scrivania, non ancora nell'album.
Aiutino 3
Il merge si lancia da main, il branch che riceve. main e cena hanno cambiato righe diverse di menu.txt: nessun conflitto.

Livello 4 · In visita al quaderno di lunedì

«Voglio rivedere il quaderno com'era lunedì mattina, prima che Pina lo toccasse. E lì sopra scrivi il minestrone, che c'era e lo voglio tenere.»

Il commit di lunedì è il primo del quaderno: lo trovi con git log --oneline, in fondo.

La cosa nuova: la HEAD staccata. È l'esempio D.

Cosa fai. Vai sul primo commit, scrivi ricette/minestrone.txt con questo testo e fai il commit:

Minestrone
Per 50 persone
Verdure miste: 10 kg
Fagioli: 1 kg
Brodo: 8 litri

Salvalo nel branch minestrone, torna su main e uniscilo. Alla fine sei su main, e minestrone esiste ancora.

Aiutino 1
git switch --detach seguito dal codice del primo commit. Il codice lo trovi in fondo a git log --oneline.
Aiutino 2
Il test vuole il commit del minestrone subito sopra il primo commit, quello di lunedì. Se scrivi il file e committi su main, il commit nasce in un altro posto.
Aiutino 3
Prima di tornare su main, un branch sul commit appena fatto: git switch -c minestrone. Poi git switch main e il merge.

Livello 5 · Lo zafferano di Pina

«Il quaderno adesso sta sul GitHub della mensa. Pina ha già lavorato, e anche tu: guarda lo zafferano.»

Il quaderno è sul GitHub della mensa (il GitHub finto: la cartella github.git/). Pina ha cambiato la dose di zafferano del risotto e ha raccolto i dolci sul suo branch dolci, poi ha fatto il push. Tu, intanto, hai cambiato la stessa riga. Il tuo git push:

To ../github.git
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to '../github.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

La cosa nuova: il conflitto che nasce da git pull. Il conflitto lo conosci dal capitolo I conflitti; il push respinto, dal capitolo GitHub e le pull request.

La regola di Ottavio per scegliere: tra due dosi di zafferano, si tiene sempre la più piccola: costa più dell'oro.

Cosa fai. Lancia git pull: si ferma sul conflitto in ricette/risotto.txt. Risolvilo con la regola di Ottavio, chiudi il merge e fai git push. Con il pull arrivano anche i dolci di Pina.

Aiutino 1
Dopo git pull, git status dice both modified: ricette/risotto.txt. Il conflitto è su una riga sola, quella dello zafferano.
Aiutino 2
Nel file, sopra ======= c'è la tua riga, sotto quella che arriva da GitHub. Quella che arriva ha il codice del commit di Pina, al posto del nome di un branch. Tieni la dose più piccola e togli i tre segni.
Aiutino 3
git add sul file, poi git commit (con -m), poi git push. Non forzare il push: sovrascriveresti il lavoro di Pina.

Livello 6 · Il peperoncino

«Cena di prova. Il tiramisù... brucia. Qualcuno ci ha messo un cucchiaino di peperoncino. Toglilo, ma come si deve: main è protetto.»

main sul GitHub della mensa è protetto: ci si arriva solo con una pull request. Se provi a fare git push da main:

remote: error: GH006: Protected branch update failed for refs/heads/main.
remote: main è protetto: ci si arriva solo con una pull request.
remote: Fai un branch tuo (git switch -c nome), poi git push -u origin nome.
To ../github.git
 ! [remote rejected] main -> main (pre-receive hook declined)
error: failed to push some refs to '../github.git'

La cosa nuova: niente. È il giro del capitolo GitHub e le pull request, con il GitHub finto.

Cosa fai. Su un branch che si chiama via-il-peperoncino, togli solo la riga del peperoncino da ricette/tiramisu.txt; il resto del file resta com'è. Fai il commit e il push del branch. Poi la pull request: Ottavio la approva e la unisce quando lanci

Terminale
bash ../unisci-pr.sh via-il-peperoncino

dalla cartella progetto/. Infine aggiorna il tuo main.

Aiutino 1
git switch -c via-il-peperoncino, poi apri ricette/tiramisu.txt e cancella la riga. Controlla con git diff: deve esserci una sola riga con il -.
Aiutino 2
git push -u origin via-il-peperoncino manda il branch sul GitHub. La pull request la fa lo script: Ottavio unisce verso main.
Aiutino 3
Il tuo main non sa ancora niente della pull request: git switch main, poi git pull.

Il finale

Il tiramisù non brucia più, ma Ottavio vuole un nome. «Il peperoncino non cade dal cielo. Qualcuno l'ha scritto nel quaderno.»

Il quaderno ricorda tutto: ogni riga ha il suo commit, e ogni commit ha il suo autore. Dal livello 6, dentro progetto/:

Terminale
git log -p ricette/tiramisu.txt

La cosa nuova: -p mostra, commit per commit, anche le righe cambiate (quelle con il + sono aggiunte, quelle con il - tolte). Cerca il commit che ha aggiunto il peperoncino, e leggi la riga Author.

Occhio ai sospetti più comodi:

  • Chi ha unito il branch dei dolci e ha fatto il push, non per forza ha scritto quella riga.
  • Chi ha toccato il tiramisù, non per forza ha toccato il peperoncino.
  • Chi ha unito la tua pull request non c'entra con la riga che togli.

Quando hai un nome:

Terminale
python storia/verifica.py "Nome Cognome"

Se è sbagliato, per le piste più probabili Ottavio ti dice dove hai preso la strada sbagliata.