Le entità, se qualcosa va storto
Le entità che non tornano, i test rossi
Gli errori di questo capitolo non arrivano dal terminale: sono sintomi di un riquadro 6 malato. Per ognuno: cosa vedi, cosa vuol dire, cosa fai. In fondo, i test rossi tipici della palestra.
Sintomi nel tuo canvas
| Vedi | Vuol dire | Cosa fai |
|---|---|---|
| Hai otto entità (o dieci) | Hai tabellato tutto quello che ha un nome: colori, stati, giorni, categorie | Rifai la prova a ognuna, con le quattro domande, fermandoti al primo «no». La maggior parte sono attributi: colonne |
| Hai una sola entità | Hai messo tutto in una tabella: i dati di chi fa la cosa, di quello che fa, di quando | Per ogni cosa che si ripete dentro la riga (lo stesso nome in molte righe), c'è un'entità nascosta |
C'è una tabella utenti che contiene tutti | Hai unito persone con dati e permessi diversi: chi lavora, chi chiede | Una domanda: «l'app deve riconoscerlo quando torna?». Chi sì ha la sua tabella; chi no, sono colonne dentro l'evento |
Una colonna con una lista dentro ('ombrelli, borse') | Dentro una casella hai messo tante cose: è un'entità nascosta | Una tabella con una riga per ogni cosa. È una delle dieci domande del capitolo Disegnare un database |
| Un'azione scrive qualcosa e non sai in quale tabella | Manca un'entità, quasi sempre un evento (prenotazione, restituzione, prestito) | Dagli un nome, falla passare dalla prova: ha un quando e un chi? È un'entità |
Una tabella categorie con sei righe, per sempre le stesse | Hai fatto una tabella di una lista fissa | Una colonna con CHECK ... IN (...). Tabella solo se la lista cambia o ogni voce ha dati suoi |
| La tua entità ha un solo dato (il nome) e nessuna freccia verso o da altre | Forse è un attributo di un'altra cosa | Se nessuna azione la cerca per conto suo, è una colonna. Provalo: c'è una schermata che la mostra da sola? |
| Un molti a molti disegnato come una freccia | Una tabella non può contenere una lista di chiavi | Un ponte, con una riga per ogni coppia: spesso è un evento con un nome vero (iscrizione, prenotazione) |
| Una freccia per ogni coppia di entità | Hai inventato relazioni che nessuna azione usa | Tieni solo quelle che il riquadro 7 usa: se nessuno cerca «le stazioni di un addetto», niente freccia |
| Il tuo compagno ti chiede «perché questa è una tabella?» e non sai rispondere | La prova non l'hai fatta, o l'hai fatta a occhio | Scrivi accanto a ogni entità le quattro risposte, in quattro parole. Se una è «boh», rifalla |
Le entità che cambiano idea
Capita che la prova dia un risultato oggi e un altro tra un mese. Non è un errore: la prova dipende da cosa l'app fa. Se aggiungi una funzione, rifai la prova ai nomi che avevi scartato. Il passeggero di Ritrovato non è un'entità finché nessuno deve riconoscerlo; se Nives chiedesse «quante volte è tornato questo passeggero?», lo diventa.
Prima di scrivere codice, cambiare il canvas costa un minuto. Dopo che hai le tabelle, costa giorni.
I test rossi della palestra
Gli errori che vedrai più spesso nei test del capitolo.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
assert None == 'entità' (o == "poche", == 4) | La funzione non restituisce niente: c'è ancora pass, manca il return, o c'è un print al posto del return | return alla fine, e non print. In una funzione con tanti if, ogni ramo deve avere il suo return |
assert 'attributo' == 'valore' | La funzione dice «attributo» dove ci si aspetta «valore» | Hai saltato il caso gruppo_fisso. Controllalo prima di restituire "attributo" |
assert 'fuori' == 'attributo' (o il contrario) | Hai controllato serve nel punto sbagliato | "fuori" si decide per primo: se l'app non la usa, le altre risposte non contano |
KeyError: 'cose_sue' | Il dizionario della scheda non ha quella chiave | Controlla il nome: le chiavi sono serve, tante, distinte, cose_sue, gruppo_fisso. Maiuscole e trattino basso contano |
assert 'uno a molti' == 'molti a uno' | Hai letto la direzione al contrario | Il primo argomento dice quanti B ha un A. Se A ha molti B e ogni B ha un solo A, A è l'uno: «uno a molti» |
assert 'corse' == 'autisti' | La chiave va dalla parte sbagliata | La chiave sta nella tabella del molti: nell'uno a molti è b, nel molti a uno è a |
assert 3 == 4 (in quante_tabelle) | Non hai contato il ponte | Una tabella in più per ogni "molti a molti". Non per le altre relazioni |
assert [...] == [...] in cose_senza_tabella, stessi elementi in ordine diverso | Hai ordinato la lista, oppure hai usato un set | L'ordine è quello in cui trovi le cose: lista vuota e append, non sorted |
KeyError: 'insegnanti_allievi' in le_tabelle | Il nome del ponte è nell'ordine sbagliato | È a_b con a e b nell'ordine della relazione: f"{a}_{b}" |
TypeError: 'NoneType' object is not subscriptable | Una funzione ha restituito None e ci hai fatto [...] sopra | Come il primo: manca il return |
Gli errori che non danno errori
I più difficili sono quelli senza messaggio: il test è rosso e il codice sembra giusto. In questo capitolo sono quasi sempre uno di questi due.
L'ordine degli if. In classifica il primo if che scatta vince. Se metti gruppo_fisso prima di serve, un vassoio che l'app non usa diventa un «valore». Parti sempre dal caso che toglie di mezzo.
I limiti compresi. «Da 3 a 6» include il 3 e il 6: < e <= non sono la stessa cosa. Scrivi sempre a mano i casi sui limiti (2, 3, 6, 7), come fanno i test.
Per trovarli, il debugger: un breakpoint nella prima riga della funzione, e in WATCH la scheda o la lista. Come si fa: Il debugger, passo per passo.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'classifica': non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.