Vai al contenuto
code-to-code

Apro l'indice…

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

Il progetto1. Le domande da farsip. 16

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.

progetto-le-domande.zip15 KB

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:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi.
  2. Al posto di pass scrivi il codice. La docstring ha gli esempi di cosa deve uscire.
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.
  4. 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»):

canvas = {"frase": "AgendaCoro…", "per_chi": ["corista"], "funzioni": {"non_fa": ["niente quote"]}, "dati": ["prove"]}canvasdict"frase""AgendaCoro…""per_chi""funzioni""dati"list"corista"0dict"non_fa"list"niente quote"0list"prove"0
Un canvas, accorciato

Come si legge:

RiquadroLa chiaveCosa c'è dentro
1 · La frasecanvas["frase"]un testo
2 · Per chicanvas["per_chi"]una lista di testi
4 · Le funzionicanvas["funzioni"]un dizionario con tre liste: "indispensabili", "se_avanza", "non_fa"
5 · Le schermatecanvas["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 daticanvas["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.

#EsercizioControllaDifficoltà
1La frase del torneola forma «… aiuta … a …»★
2Per chi giocauno o due tipi, non «tutti»★
3Le funzioni del torneoal massimo tre indispensabili★
4Cosa il torneo NON fache il «NON» non sia vuoto★
5Il coro conta le sue coseschermate da 3 a 5, cose da 3 a 6★★
6Una funzione che non si vedeogni funzione ha la sua schermata★★
7Una schermata vuotaogni schermata usa dei dati★★
8Il revisore del canvastutto insieme: quali domande non passano★★★
9Il tuo CANVAS.mda 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.

Python
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")                              # False

Come provi: pytest palestra/test_frase_valida.py -v

Aiutino 1
Una stringa si divide in tre con .partition(" aiuta "): quello che c'è prima, il separatore, quello che c'è dopo. Se il separatore non c'è, il secondo pezzo è vuoto.
Aiutino 2
Poi dividi anche quello che c'è dopo, con .partition(" a "). Il test «la a prima di aiuta non conta» ti dice perché si divide dopo, non su tutta la frase.
Aiutino 3
Alla fine tre pezzi non devono essere vuoti, e i due separatori devono esserci. Ricordati di togliere gli spazi ai lati della frase prima di cominciare.

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».

Python
per_chi_valido(["chi gioca", "chi organizza"])  # True
per_chi_valido(["tutti"])                       # False
per_chi_valido([])                              # False

Come provi: pytest palestra/test_per_chi_valido.py -v

Aiutino 1
Due controlli: la lunghezza della lista, e poi ogni voce. Per la lunghezza, un confronto concatenato: 1 <= len(per_chi) <= 2.
Aiutino 2
Per ogni voce togli gli spazi (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.

Python
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)   # True

Come provi: pytest palestra/test_funzioni_ok.py -v

Aiutino 1
Ti basta len(...) su due delle tre liste. La terza, "non_fa", qui non si guarda.
Aiutino 2
Il caso con nessuna indispensabile è 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 è.

Python
ha_un_non({"non_fa": ["non gestisce i pagamenti"]})   # True
ha_un_non({"non_fa": []})                             # False
ha_un_non({"non_fa": ["", "   "]})                    # False

Come provi: pytest palestra/test_ha_un_non.py -v

Aiutino 1
Un for sulla lista, e un return True appena trovi una voce che non è vuota.
Aiutino 2
Il test «solo voci vuote» è rosso? " " 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.

Python
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
Il risultato è un dizionario con due chiavi, scritto direttamente nel return.
Aiutino 3
Se i test degli estremi sono rossi, guarda i confronti: «da 3 a 5» comprende il 3 e il 5.

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»:

Python
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
Prima raccogli, scorrendo le schermate, tutte le funzioni che qualche schermata fa fare, in una lista. Poi scorri le indispensabili e tieni quelle che non ci sono.
Aiutino 2
Per sapere se una cosa sta in una lista: in e not in. Lo schema è il «setaccio» dei dizionari: lista vuota, for, if, append.
Aiutino 3
Se un test dice che il canvas del coro è «a posto» ma tu restituisci qualcosa, stai guardando anche le «se avanza», o solo la prima schermata.

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:

Python
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
Per ogni schermata parti da «non usa dati» e cambi idea appena un dato è giusto. È lo schema del booleano che si accende.
Aiutino 3
Il test «un nome che nel riquadro 6 non c'è» è rosso? Una lista "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.

DomandaCosa controlla
1la frase ha la forma «… aiuta … a …»
2per chi: uno o due tipi, nessuno «tutti»
4le funzioni indispensabili sono da 1 a 3
5c'è almeno un «NON»
6ogni funzione indispensabile ha una schermata
7ogni schermata usa almeno un dato del riquadro 6
8le 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.

Python
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
Parti da una lista vuota, 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
Sono sette 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
Procedi per numeri: scrivi il controllo della domanda 1, lancia i test, poi la 2, e così via. Ogni test si accende quando scrivi la domanda giusta.

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.

  1. Scegli l'idea. Se non ne hai una, parti dalla cosa che ti fa perdere più tempo ogni settimana.
  2. 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.
  3. Rileggilo con le dieci domande: le prime sei, che si possono fare adesso.
  4. Dallo a un compagno. Prendi il suo. Spiegatevi le app a vicenda, in un minuto.
  5. 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.