Vai al contenuto
code-to-code

Apro l'indice…

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

Python6. Le funzionip. 171

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.

python-funzioni.zip19 KB

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 3

Il regolamento

Sta in dati.py, con i nomi in maiuscolo: nelle funzioni usa sempre i nomi, mai i numeri.

RegolaNome in dati.py
Sotto il 20% di carica il treno non si muoveCARICA_MINIMA
Sotto il 50% deve prima ricaricareCARICA_PIENA
La revisione arriva ogni 12000 kmLIMITE_REVISIONE
I treni da 6 vagoni in su sono treni lunghi, e per loro la revisione arriva a 9000 kmVAGONI_TRENO_LUNGO, LIMITE_TRENI_LUNGHI
Una giornata normale sono 300 kmGIRO_NORMALE

Un treno, nei dati, è un dizionario:

Python
{"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

FileCosa c'èSi tocca?
dati.pyTRENI, DEPOSITI e il regolamentoNo, si legge
pannello.pySei funzioni, una per livello. In fondo, il pannello accesoSì, solo questo
test_pannello.pyI test. Usano treni di prova (X1, X2, …): nessun test ti dice la rispostaNo
verifica.pyLa capostazione controlla il codice del treno che le daiNo

Come si gioca

Un livello alla volta, sempre così:

  1. Leggi cosa deve sapere il pannello e la cosa nuova del livello.
  2. In pannello.py, al posto di pass, scrivi la funzione.
  3. pytest storia -v -k livello_1 (poi livello_2, …) finché è verde.
  4. 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.

Python
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
Una f-string con tre pezzi del dizionario: 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
Parti dal caso più grave: il rosso. Un treno con le porte aperte è rosso anche con la batteria piena.
Aiutino 2
«Sotto» vuol dire <. 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
Una riga sola. Usa 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
Se il semaforo non è verde puoi già rispondere False: un return subito, e il resto non serve.
Aiutino 2
Per i km: se il treno ha almeno 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
Due condizioni con 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
Il 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
È un accumulatore di righe: lista vuota, for sui depositi, append, e il return dopo il for.
Aiutino 2
Salva il primo in uscita in una variabile, poi 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_LUNGO chilometri. 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:

Terminale
python storia/verifica.py CODICE

Se è sbagliato, per le piste più probabili la capostazione ti dice dove hai preso la strada sbagliata.