Le domande da farsi, la palestra
Il revisore del canvas, con i test
- 60–90 minuti di lavoro
Nella teoria hai riletto dei canvas con le dieci domande, a mano. Qui insegni a un programma a farlo: il revisore del canvas. Otto funzioni in Python, dal ★ al ★★★, ognuna controlla una delle domande che una macchina sa controllare. La ★★★ le mette tutte insieme.
Poi c'è un nono esercizio, senza codice e senza test: il canvas del tuo progetto.
Gli esercizi da scaricare
Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.
Prima di iniziare
Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install, code .. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta.
Ogni esercizio, sempre gli stessi quattro passi:
- Apri il file in
palestra/. In alto: la storia, cosa fai, come provi. - Al posto di
passscrivi il codice. La docstring ha gli esempi di cosa deve uscire. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.- Rosso? Leggi l'ultima riga del messaggio. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.
Un canvas è un dizionario
Il canvas è un dizionario Python, con la stessa forma in tutti gli esercizi: ogni riquadro (dal 1 al 6) ha la sua chiave. Il canvas del coro dei ferrovieri, che i test usano per quasi tutto, è in palestra/coro.py. Qui lo vedi accorciato (nel vero canvas ci sono anche il problema, le schermate e le funzioni «se avanza»):
Come si legge:
| Riquadro | La chiave | Cosa c'è dentro |
|---|---|---|
| 1 · La frase | canvas["frase"] | un testo |
| 2 · Per chi | canvas["per_chi"] | una lista di testi |
| 4 · Le funzioni | canvas["funzioni"] | un dizionario con tre liste: "indispensabili", "se_avanza", "non_fa" |
| 5 · Le schermate | canvas["schermate"] | un dizionario: il nome della schermata → un dizionario con la lista delle "funzioni" che fa fare e la lista dei "dati" che usa |
| 6 · I dati | canvas["dati"] | una lista di nomi: le «cose» |
Il riquadro 3 (il problema) c'è nel canvas ma nessun esercizio lo controlla: se è vero lo giudica un compagno. È la domanda 3 delle dieci.
| # | Esercizio | Controlla | Difficoltà |
|---|---|---|---|
| 1 | La frase del torneo | la forma «… aiuta … a …» | ★ |
| 2 | Per chi gioca | uno o due tipi, non «tutti» | ★ |
| 3 | Le funzioni del torneo | al massimo tre indispensabili | ★ |
| 4 | Cosa il torneo NON fa | che il «NON» non sia vuoto | ★ |
| 5 | Il coro conta le sue cose | schermate da 3 a 5, cose da 3 a 6 | ★★ |
| 6 | Una funzione che non si vede | ogni funzione ha la sua schermata | ★★ |
| 7 | Una schermata vuota | ogni schermata usa dei dati | ★★ |
| 8 | Il revisore del canvas | tutto insieme: quali domande non passano | ★★★ |
| 9 | Il tuo CANVAS.md | a mano, senza test | — |
1 · La frase del torneo ★
palestra/frase_valida.py
Il torneo di scacchi in stazione ha una frase scritta sul canvas. Il revisore controlla che abbia la forma «… aiuta … a …», con del testo nei tre posti.
frase_valida("TorneoMenta aiuta chi ama gli scacchi a trovare un avversario") # True
frase_valida("Un'app per organizzare tornei di scacchi") # False
frase_valida("TorneoMenta aiuta gli scacchisti") # FalseCome provi: pytest palestra/test_frase_valida.py -v
Aiutino 1
.partition(" aiuta "): quello che c'è prima, il separatore, quello che c'è dopo. Se il separatore non c'è, il secondo pezzo è vuoto.Aiutino 2
.partition(" a "). Il test «la a prima di aiuta non conta» ti dice perché si divide dopo, non su tutta la frase.Aiutino 3
2 · Per chi gioca ★
palestra/per_chi_valido.py
Il riquadro «Per chi» del torneo è una lista: i tipi di persone che usano l'app. Ne servono uno o due, e nessuno può essere «tutti».
per_chi_valido(["chi gioca", "chi organizza"]) # True
per_chi_valido(["tutti"]) # False
per_chi_valido([]) # FalseCome provi: pytest palestra/test_per_chi_valido.py -v
Aiutino 1
1 <= len(per_chi) <= 2.Aiutino 2
strip) e le maiuscole (lower) prima di confrontare. «Tutti» sono solo le voci uguali a "tutti", "per tutti", "chiunque": una voce che comincia con «tutti» ma dice di più va bene.3 · Le funzioni del torneo ★
palestra/funzioni_ok.py
Il riquadro 4 ha tre liste: le funzioni indispensabili, quelle «se avanza tempo» e quello che l'app NON fa. Il revisore conta: le indispensabili da 1 a 3, le «se avanza» al massimo 2.
funzioni = {
"indispensabili": ["iscrivo un giocatore", "pubblico gli accoppiamenti", "registro un risultato"],
"se_avanza": ["vedo la classifica"],
"non_fa": ["non gestisce i pagamenti"],
}
funzioni_ok(funzioni) # TrueCome provi: pytest palestra/test_funzioni_ok.py -v
Aiutino 1
len(...) su due delle tre liste. La terza, "non_fa", qui non si guarda.Aiutino 2
False: un'app senza funzioni non serve a nessuno.4 · Cosa il torneo NON fa ★
palestra/ha_un_non.py
Un canvas senza la lista del «NON» promette tutto. Il revisore vuole almeno una riga vera: una voce vuota, o fatta di soli spazi, non lo è.
ha_un_non({"non_fa": ["non gestisce i pagamenti"]}) # True
ha_un_non({"non_fa": []}) # False
ha_un_non({"non_fa": ["", " "]}) # FalseCome provi: pytest palestra/test_ha_un_non.py -v
Aiutino 1
for sulla lista, e un return True appena trovi una voce che non è vuota.Aiutino 2
" " ha tre caratteri, ma non è una voce vera: " ".strip() che cosa dà?5 · Il coro conta le sue cose ★★
palestra/quantita_giuste.py
Il coro dei ferrovieri ha riempito il suo canvas. Il revisore comincia dai numeri: le schermate devono essere da 3 a 5, le «cose» del riquadro 6 da 3 a 6. Estremi compresi.
canvas = canvas_del_coro()
quantita_giuste(canvas) # {"schermate": True, "dati": True}Se le schermate fossero due, il risultato sarebbe {"schermate": False, "dati": True}.
Come provi: pytest palestra/test_quantita_giuste.py -v
Aiutino 1
canvas["schermate"] è un dizionario: len ti dà quante sono. canvas["dati"] è una lista.Aiutino 2
return.Aiutino 3
6 · Una funzione che non si vede ★★
palestra/funzioni_senza_schermata.py
Il coro ha una funzione che nessuna schermata permette di fare: chi la usa non sa dove cliccare. Il revisore le cerca. Contano solo le funzioni indispensabili: quelle «se avanza tempo» possono aspettare, e non hanno ancora una schermata.
Se al canvas del coro togli la schermata «una prova», nessuno permette più di dire «dico se ci sono»:
funzioni_senza_schermata(canvas) # ["dico se ci sono"]Le funzioni escono nell'ordine in cui stanno nel canvas. Se ogni indispensabile ha la sua schermata, il risultato è la lista vuota.
Come provi: pytest palestra/test_funzioni_senza_schermata.py -v
Aiutino 1
Aiutino 2
in e not in. Lo schema è il «setaccio» dei dizionari: lista vuota, for, if, append.Aiutino 3
7 · Una schermata vuota ★★
palestra/schermate_senza_dati.py
Una schermata del coro non mostra e non chiede niente di quello che l'app ricorda. Il revisore le trova: sono le schermate che non usano nemmeno un dato del riquadro 6.
Una schermata è segnalata se la sua lista "dati" è vuota, oppure se nessuno dei suoi nomi sta in canvas["dati"]. Basta un dato giusto per essere a posto.
Se al canvas del coro aggiungi una schermata «il saluto» con la lista "dati" vuota:
schermate_senza_dati(canvas) # ["il saluto"]I nomi escono nell'ordine del canvas.
Come provi: pytest palestra/test_schermate_senza_dati.py -v
Aiutino 1
canvas["schermate"].items() ti dà il nome della schermata e i suoi dettagli, insieme.Aiutino 2
Aiutino 3
"dati" non vuota non basta: i nomi devono stare in canvas["dati"].8 · Il revisore del canvas ★★★
palestra/revisore.py
Ora metti tutto insieme. revisore(canvas) restituisce i numeri delle domande (delle dieci) che il canvas non supera, in ordine crescente, oppure [] se le passa tutte.
| Domanda | Cosa controlla |
|---|---|
| 1 | la frase ha la forma «… aiuta … a …» |
| 2 | per chi: uno o due tipi, nessuno «tutti» |
| 4 | le funzioni indispensabili sono da 1 a 3 |
| 5 | c'è almeno un «NON» |
| 6 | ogni funzione indispensabile ha una schermata |
| 7 | ogni schermata usa almeno un dato del riquadro 6 |
| 8 | le cose del riquadro 6 sono da 3 a 6 |
Le domande 3, 9 e 10 le giudica un compagno. Anche il numero delle schermate qui non si controlla: è l'esercizio 5.
revisore(canvas_del_coro()) # []Un canvas con «per tutti», senza il «NON» e con una schermata senza dati dà [2, 5, 7].
Il file è autonomo: scrivi tutto dentro revisore.py, anche ricopiando quello che hai fatto negli altri. Non serve importare niente.
Come provi: pytest palestra/test_revisore.py -v
Aiutino 1
non_passano = [], e per ogni domanda un if che, se la domanda non passa, fa non_passano.append(<numero>). Alla fine return non_passano.Aiutino 2
if separati, uno sotto l'altro: non una catena di elif. Con elif, appena una domanda non passa le altre non vengono più guardate, e il canvas «tutto sbagliato» ne segnala una sola.Aiutino 3
9 · Il tuo CANVAS.md (a mano)
Non c'è un file Python, e non c'è un test. Nello zip c'è CANVAS.md: il modello del canvas, con i riquadri dall'1 al 5 e le loro domande. Riempilo per il tuo progetto.
- Scegli l'idea. Se non ne hai una, parti dalla cosa che ti fa perdere più tempo ogni settimana.
- Compila i riquadri nell'ordine: la frase, per chi, il problema, le funzioni, le schermate. Per le schermate fai anche il disegno a mano, su un foglio.
- Rileggilo con le dieci domande: le prime sei, che si possono fare adesso.
- Dallo a un compagno. Prendi il suo. Spiegatevi le app a vicenda, in un minuto.
- Dove il compagno non ha capito, correggi. Il canvas non è finito finché lui non sa spiegare la tua app.
Il CANVAS.md va nella cartella del progetto: nel capitolo La cartella del progetto vedrai dove. I riquadri 6, 7 e 8 li compili nei capitoli che seguono.
Quando i test sono verdi e il tuo CANVAS.md ha passato il compagno, ti aspettano le soluzioni e, se qualcosa non va, la pagina se qualcosa va storto. Il passo dopo è Le entità: da dove arrivano le tabelle.