Vai al contenuto
code-to-code

Apro l'indice…

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

Il progetto1. Le domande da farsip. 29

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 sintomoVuol direCosa fai
Il compagno non sa spiegare la tua app in un minutoLa frase o le funzioni non sono chiareFalla 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 indispensabiliPer 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 rottaRiscrivila 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 schermataChi la usa non sa dove andareAggiungi la schermata, o scrivi la funzione tra le «se avanza»
Il problema non lo vive nessunoHai 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 utileScegli uno o due tipi di persone, e riscrivi le funzioni per loro
Il «NON» è vuotoQualunque idea, tra due settimane, sembra possibileScrivi le tre cose che qualcuno ti chiederà e che non farai, con il perché
Il «NON» contiene «veloce», «sicura», «senza errori»Sono qualità, non funzioniTogli: nel «NON» vanno le cose che l'app non fa
Le schermate sono sette o piùIl progetto è troppo grandeRileggi le funzioni: quali schermate servono davvero alle tre indispensabili?
Mettere il login tra le tre funzioniIl login protegge una funzione: non risolve il problema di nessunoLascialo 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.

LeggiVuol direCosa fai
assert None is True (o == [], == {…})La funzione non restituisce niente: c'è ancora pass, manca il return, o c'è un print al posto del returnreturn 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 canvasLe 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 posizioniScorri con .items() o .values(): la mossa è nel capitolo I dizionari
TypeError: 'in <string>' requires string as left operand, not listHai confrontato una lista con un testoGuarda cosa contiene la variabile: una lista di funzioni non è una funzione
assert False is True su un canvas giustoIl 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 ordineI 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 revisoreHai scritto elif al posto di ifSette 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 leggerloIl 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 filecd 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.