Le domande da farsi, se qualcosa va storto
I sintomi di un canvas malato, e i test rossi della palestra
In questo capitolo gli errori sono di due tipi: quelli del canvas (che nessun programma ti segnala) e quelli dei test della palestra, che invece ti dicono tutto. Cominciamo dal canvas.
I sintomi di un canvas malato
Un canvas sbagliato non dà errori: ti sembra a posto, e i guai arrivano giorni dopo, quando sono costosi. Per questo si riconosce dai sintomi, quasi sempre dal compagno che lo rilegge.
| Il sintomo | Vuol dire | Cosa fai |
|---|---|---|
| Il compagno non sa spiegare la tua app in un minuto | La frase o le funzioni non sono chiare | Falla riscrivere a lui, a voce, con le sue parole: dove si inceppa, lì c'è il riquadro da rifare. Ricomincia dalla frase |
| «Ho nove funzioni» | Hai messo tutti i desideri, non le funzioni indispensabili | Per ognuna: «se manca, il problema resta?». Tre restano, due aspettano, le altre vanno nel «NON» |
| Una funzione è un nome, non una frase («gestione utenti», «ricerca») | Non dice chi fa cosa: non sai che azione sarà, né che rotta | Riscrivila con un verbo: «cerco gli oggetti, per stazione» |
| Una schermata che non fa fare nessuna funzione | È una pagina in più: «chi siamo», «la home» | Tagliala, o accorpala alla schermata che usa |
| Una funzione senza schermata | Chi la usa non sa dove andare | Aggiungi la schermata, o scrivi la funzione tra le «se avanza» |
| Il problema non lo vive nessuno | Hai scritto la tua soluzione («manca un'app») | Chiedi: chi, quando, cosa fa oggi? Se non sai dare un nome, parlaci prima |
| «Per tutti» | Non hai scelto: ogni funzione sembra utile | Scegli uno o due tipi di persone, e riscrivi le funzioni per loro |
| Il «NON» è vuoto | Qualunque idea, tra due settimane, sembra possibile | Scrivi le tre cose che qualcuno ti chiederà e che non farai, con il perché |
| Il «NON» contiene «veloce», «sicura», «senza errori» | Sono qualità, non funzioni | Togli: nel «NON» vanno le cose che l'app non fa |
| Le schermate sono sette o più | Il progetto è troppo grande | Rileggi le funzioni: quali schermate servono davvero alle tre indispensabili? |
| Mettere il login tra le tre funzioni | Il login protegge una funzione: non risolve il problema di nessuno | Lascialo fuori dalle tre; sarà una schermata e una riga del riquadro 8 |
Gli errori che non danno errori
Sono i più difficili: il canvas gira, e i guai si vedono dopo. In questo capitolo sono quasi sempre uno di questi tre.
La frase che parla di tecnologia. «Una piattaforma web con database e API per…»: non dice a chi serve né a cosa. Se la togli e la frase non cambia significato, il pezzo era inutile.
Il problema che è una soluzione. «Manca un'app per gli oggetti smarriti» non è un problema: è la tua app. Un problema si racconta senza nominare l'app.
Troppe funzioni indispensabili. Se sono quattro, una non lo è. Una funzione è indispensabile solo se, senza, il problema resta.
I test rossi della palestra
I test si leggono dal basso. La riga con assert dice cosa ha restituito la tua funzione, e cosa si aspettava il test.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
assert None is True (o == [], == {…}) | La funzione non restituisce niente: c'è ancora pass, manca il return, o c'è un print al posto del return | return alla fine della funzione, fuori dal for se devi guardare tutta la lista |
KeyError: 'non_fa' | Hai scritto una chiave con un nome diverso da quello del canvas | Le chiavi sono "indispensabili", "se_avanza", "non_fa", con il trattino basso. Controlla in palestra/coro.py |
KeyError: 0 (o 1, 2…) | Hai trattato come lista un dizionario: canvas["schermate"] ha come chiavi i nomi delle schermate, non le posizioni | Scorri con .items() o .values(): la mossa è nel capitolo I dizionari |
TypeError: 'in <string>' requires string as left operand, not list | Hai confrontato una lista con un testo | Guarda cosa contiene la variabile: una lista di funzioni non è una funzione |
assert False is True su un canvas giusto | Il confronto è troppo stretto: estremi esclusi (< al posto di <=), o "tutti" cercato come parola intera | «Da 3 a 5» è 3 <= n <= 5. Rileggi la consegna: quali parole sono «tutti»? |
assert [...] == [...] con gli stessi elementi in un altro ordine | I risultati devono uscire nell'ordine del canvas (o crescente, per i numeri) | Scorri la lista del canvas, non una tua copia ordinata; per i numeri, i controlli vanno scritti in ordine |
assert [2] == [2, 5, 7] nel revisore | Hai scritto elif al posto di if | Sette if separati: le domande sono indipendenti |
| Il test dice «il canvas ricevuto non si tocca» | Hai modificato il canvas (un append, un pop, un sort) invece di leggerlo | Il revisore legge: costruisci liste nuove, mai modificare quella ricevuta |
ModuleNotFoundError: No module named 'coro' | Hai lanciato pytest da un'altra cartella, o hai spostato i file | cd nella cartella dello zip, poi pytest |
Se invece di un messaggio non succede niente (pytest non parte, No module named pytest, il pannello Testing vuoto), il problema è l'ambiente: ha una pagina sua nel Pronto soccorso, pytest non parte, o non trova niente. Come si leggono i messaggi di un test fallito: Leggere un traceback.