Il grafo, se qualcosa va storto
Errori di disegno e messaggi del test
In questo capitolo non c'è niente che si rompa: non lanci comandi, disegni. Gli errori sono di due tipi: nel disegno, e nel file delle risposte. Per ognuno: cosa vedi, cosa vuol dire, cosa fai.
Errori di disegno
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
| Nel tuo disegno una freccia va da C2 a C3 | Hai disegnato le frecce in avanti | Rileggi la regola 2: la freccia parte da chi è nato dopo e punta al genitore |
| Il commit di merge ha una freccia sola | Hai dimenticato che il merge ha due genitori | Regola 4: una freccia per ogni genitore. Se hai un solo genitore, forse era un salto in avanti: chiediti chi riceve |
| Dopo un merge, tutte e due le etichette sono sul commit nuovo | Hai spostato anche l'etichetta del branch che dà | Si muove solo chi riceve: l'altra resta dov'era |
| Dopo un commit, l'etichetta è rimasta indietro | Hai dimenticato di spostarla | Regola 3: il branch su cui sta HEAD avanza con il commit nuovo |
| Hai dato un numero al salto in avanti | Hai disegnato un commit che non esiste | Regola 5: se chi riceve non è andato avanti, niente commit nuovo |
| Hai scritto HEAD come un commit (C5, C6…) | HEAD non è una foto: è «tu sei qui» | Disegna HEAD come un'etichetta che punta a un'etichetta |
| Il conto dei commit non torna | Hai contato commit di un altro branch, o hai dimenticato di contare il punto di partenza | Da quell'etichetta torna indietro seguendo le frecce, una alla volta |
Messaggi del test
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Domanda 2: manca la risposta in risposte.txt | Dopo «domanda 2:» non c'è niente, oppure non hai salvato il file | Scrivi la risposta sulla stessa riga, dopo i due punti, e salva (in VS Code, un pallino sulla scheda dice che non è salvato) |
Domanda 3: … e un consiglio | La risposta è sbagliata. Il test non dice quale sia quella giusta | Leggi il consiglio, ridisegna lo scenario riga per riga, poi riprova |
Non trovo risposte.txt accanto al test | Il file è stato cancellato o rinominato | Rimettilo nella cartella dello scenario con il suo nome: risposte.txt. Se l'hai perso, scompatta di nuovo lo zip in un'altra cartella e copia quello |
no tests ran | pytest non trova il test | Come sopra: dalla cartella di uno scenario, poi pytest -v |
pytest: command not found | Il venv è spento | source .venv/bin/activate dalla cartella principale dello zip. Tutto il resto: pytest non parte, o non trova niente |
| Il pannello Testing di VS Code è vuoto | VS Code è aperto su una cartella più in alto | File → Open Folder e scegli proprio la cartella git-grafo |
Un errore con git nel messaggio, o git: command not found | I test usano Git vero per rifare lo scenario, e sul computer Git non c'è (o è troppo vecchio) | git --version deve rispondere. Se no, installa Git: Pronto soccorso |
Sei sicuro del disegno ma il test è rosso?
Succede. Prima di fidarti troppo, ricontrolla tre cose:
- Il formato della risposta. I commit si scrivono con la C davanti:
C4, non4. I numeri sono numeri:4, non «quattro». Sì e no:sìono. - L'ordine dei numeri. C1, C2, C3… seguono l'ordine in cui i commit nascono, anche quello di merge. Un commit di merge in mezzo sposta tutti i numeri dopo.
- La domanda. «Dove punta
main?» non è «dove sta HEAD?». Rileggi le parole della domanda, una per una.
Se hai fatto tutto e il test è ancora rosso, passa allo scenario dopo e torna a questo più tardi. Con la testa riposata il disegno si vede meglio.