Il pannello di controllo
Sei funzioni piccole, una dentro l'altra
- 90–120 minuti di lavoro
Milano, lunedì 7 dicembre, ore 4:40. Centrale della Linea Menta, sotto Piazza Query.
Alle 5:30 deve uscire il primo treno della giornata. A decidere quale treno esce, e da quale deposito, è il pannello di controllo: un programma che guarda i treni e dice chi è pronto.
Stanotte il pannello si è spento, e non si riaccende. Era un programma vecchio, scritto tutto a print: mostrava i numeri sullo schermo, ma nessun pezzo poteva usare il risultato di un altro. Ieri sera qualcuno ha provato a sistemarlo e l'ha rotto del tutto. Dei suoi pezzi restano solo i nomi e le descrizioni.
Marta Villa, la capostazione, ha i dati dei treni e il regolamento. Il commissario Mapelli, che dalla notte della Chiave Rossa passa in centrale ogni mattina, guarda l'orologio.
«Rifacciamolo», dice. «A pezzi piccoli. Ogni pezzo lo proviamo, e ogni pezzo consegna il suo risultato al pezzo dopo.»
Gli esercizi da scaricare
Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.
Lo zip è lo stesso della palestra: la storia è nella cartella storia/.
Come si incastrano i pezzi
Ogni livello è una funzione. Dal livello 4 in poi, ogni funzione usa quelle dei livelli prima: se un pezzo sotto è sbagliato, l'errore sale fino in cima.
tabellone livello 6
│ │
▼ ▼
primo_in_uscita targhetta livelli 5 e 1
│
▼
puo_uscire livello 4
│ │
▼ ▼
semaforo km_alla_revisione livelli 2 e 3Il regolamento
Sta in dati.py, con i nomi in maiuscolo: nelle funzioni usa sempre i nomi, mai i numeri.
| Regola | Nome in dati.py |
|---|---|
| Sotto il 20% di carica il treno non si muove | CARICA_MINIMA |
| Sotto il 50% deve prima ricaricare | CARICA_PIENA |
| La revisione arriva ogni 12000 km | LIMITE_REVISIONE |
| I treni da 6 vagoni in su sono treni lunghi, e per loro la revisione arriva a 9000 km | VAGONI_TRENO_LUNGO, LIMITE_TRENI_LUNGHI |
| Una giornata normale sono 300 km | GIRO_NORMALE |
Un treno, nei dati, è un dizionario:
{"codice": "M10", "vagoni": 4, "deposito": "Porta Codice", "carica": 96, "km": 5000, "porte_ok": False}km sono i chilometri fatti dall'ultima revisione; porte_ok dice se le porte si chiudono tutte. I treni sono in fila: in ogni deposito esce prima chi è più avanti nella lista.
I file
| File | Cosa c'è | Si tocca? |
|---|---|---|
dati.py | TRENI, DEPOSITI e il regolamento | No, si legge |
pannello.py | Sei funzioni, una per livello. In fondo, il pannello acceso | Sì, solo questo |
test_pannello.py | I test. Usano treni di prova (X1, X2, …): nessun test ti dice la risposta | No |
verifica.py | La capostazione controlla il codice del treno che le dai | No |
Come si gioca
Un livello alla volta, sempre così:
- Leggi cosa deve sapere il pannello e la cosa nuova del livello.
- In
pannello.py, al posto dipass, scrivi la funzione. pytest storia -v -k livello_1(poilivello_2, …) finché è verde.python storia/pannello.py: il pannello si accende e ti mostra cosa dicono le tue funzioni sui treni veri.
Livello 1 · La targhetta
«Prima di tutto, il pannello deve dire chi è chi.»
targhetta(treno): il codice, i vagoni e la carica, in una riga.
targhetta({"codice": "X1", "vagoni": 4, "carica": 80, ...}) # "X1 · 4 vagoni · 80%"La cosa nuova: return. Il vecchio pannello stampava la targhetta e la perdeva; la tua la consegna, perché al livello 6 servirà al tabellone. Esempio A.
Aiutino 1
f"{treno['codice']} · …". Per le chiavi usa le virgolette semplici: le doppie dentro le doppie funzionano solo da Python 3.12 in su.Livello 2 · Il semaforo
«Verde esce, giallo ricarica, rosso resta fermo.»
semaforo(treno): "rosso" se le porte non si chiudono o la carica è sotto CARICA_MINIMA; "giallo" se la carica è sotto CARICA_PIENA; "verde" in tutti gli altri casi.
La cosa nuova: più return, in rami diversi. Il primo che Python incontra vince, quindi l'ordine conta. Esempio C.
Aiutino 1
Aiutino 2
<. Con il 50% esatto il treno è già verde.Livello 3 · I chilometri
«Quanta strada può fare prima della revisione?»
km_alla_revisione(treno, limite=LIMITE_REVISIONE): il limite meno i km già fatti.
La cosa nuova: un parametro con un valore di default. Chi chiama può non passare il limite, e allora vale 12000; oppure può passarlo, anche con il suo nome: km_alla_revisione(treno, limite=9000). Esempio D.
Quando funziona, il pannello ti mostra lo stesso treno lungo con e senza il suo limite. Guarda la differenza.
Aiutino 1
limite, il parametro, non LIMITE_REVISIONE: se usi la costante, il limite che passa chi chiama non conta più niente.Livello 4 · Può uscire?
«Allora: questo treno può fare il giro di oggi, sì o no?»
puo_uscire(treno, km_da_fare=GIRO_NORMALE): True se il semaforo è verde e i km alla revisione sono almeno km_da_fare.
La cosa nuova: una funzione che usa le tue funzioni. Non rifare i conti del semaforo e dei chilometri: chiedili a semaforo e a km_alla_revisione. Esempio E.
Aiutino 1
False: un return subito, e il resto non serve.Aiutino 2
VAGONI_TRENO_LUNGO vagoni, chiama km_alla_revisione(treno, limite=LIMITE_TRENI_LUNGHI), altrimenti senza limite. Salva il risultato in una variabile, poi confrontala con km_da_fare.Aiutino 3
semaforo(treno) == "verde", con le tonde. semaforo == "verde" confronta la funzione con un testo: è sempre falso, e nessun errore te lo dice.Livello 5 · Il primo della fila
«Da Porta Codice, chi esce per primo?»
primo_in_uscita(treni, deposito, km_da_fare=GIRO_NORMALE): il primo treno della lista che sta in quel deposito e che puo_uscire. Nessuno? None.
La cosa nuova: il return dentro il for. Appena lo trovi, lo consegni: gli altri treni non servono. Esempio B.
Aiutino 1
and: il deposito è quello giusto, e puo_uscire(treno, km_da_fare). Passa km_da_fare alla funzione sotto: è così che il giro lungo arriva fino a lei.Aiutino 2
return None va dopo il for. Un else: return None dentro il ciclo farebbe uscire la funzione al primo treno che non va bene.Livello 6 · Il tabellone
«Una riga per deposito. E se un deposito non ha niente da mandare, lo voglio leggere, non un errore.»
tabellone(treni, depositi, km_da_fare=GIRO_NORMALE): per ogni deposito, "Porta Codice: X1 · 4 vagoni · 80%", oppure "Vecchia Fiera: nessun treno".
La cosa nuova: il None che arriva da un'altra funzione. primo_in_uscita può rispondere None, e chi la chiama deve controllare prima di usare il risultato.
Aiutino 1
for sui depositi, append, e il return dopo il for.Aiutino 2
if treno is None:. Se lo passi a targhetta senza controllare, targhetta prova a leggere None["codice"]: TypeError: 'NoneType' object is not subscriptable.Il finale
Il pannello è acceso. Marta Villa legge il tabellone, poi si gira verso di voi.
«Stamattina il primo treno da Porta Codice non fa il giro normale. Porta la squadra dei tecnici fino in fondo alla linea e ritorno: è il giro lungo,
GIRO_LUNGOchilometri. Quale treno mando?»
Il pannello sa già rispondere: ti manca solo la chiamata giusta. Scrivila in fondo a pannello.py, dove c'è il commento IL FINALE, dentro un print, e rilancia il pannello. Ti basta una funzione che hai già scritto, e un argomento passato con il suo nome.
Quando hai il codice del treno:
python storia/verifica.py CODICESe è sbagliato, per le piste più probabili la capostazione ti dice dove hai preso la strada sbagliata.