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.
Lo zip è lo stesso della palestra: la storia è nella cartella storia/.
I file
| File | Cosa c'è | Si tocca? |
|---|---|---|
livello-1/ … livello-6/ | In ognuno: prepara.sh (costruisce il quaderno), il test; il livello 6 ha anche unisci-pr.sh | Solo progetto/, dopo prepara.sh |
cucina.sh | Com'è il quaderno all'inizio di ogni livello | No |
mensa.bundle | La storia del GitHub della mensa, per i livelli 5 e 6 | No, non si apre |
verifica.py | Ottavio controlla il nome che gli dai alla fine | No |
README.md | Le consegne di tutti i livelli, in breve | Si legge |
Come si gioca
Un livello alla volta, dalla cartella principale dello zip:
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_1Ogni 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
.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.txtLa 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
Aiutino 2
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.
AbortingLa cosa nuova: lo stash, quando Git te lo chiede. È l'esempio C.
Cosa fai.
- Metti da parte il lavoro a metà, passa su
maine correggi il secondo:Secondo: arrosto con patate(con due r). Fai il commit. - Torna su
cena, riprendi il lavoro a metà, e finisci il menu: resta la rigaCaffè: espresso e amarettiche avevi cominciato. Fai il commit. - Torna su
maine uniscicena.
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 amarettiAiutino 1
stash. Dopo, git status deve dire che non c'è niente da committare.Aiutino 2
pop nel nome. Poi non dimenticare il commit: il menu è sulla scrivania, non ancora nell'album.Aiutino 3
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 litriSalvalo 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
main, il commit nasce in un altro posto.Aiutino 3
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
git pull, git status dice both modified: ricette/risotto.txt. Il conflitto è su una riga sola, quella dello zafferano.Aiutino 2
======= 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
bash ../unisci-pr.sh via-il-peperoncinodalla 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
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/:
git log -p ricette/tiramisu.txtLa 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:
python storia/verifica.py "Nome Cognome"Se è sbagliato, per le piste più probabili Ottavio ti dice dove hai preso la strada sbagliata.