Debugger GX-TXT · Modulo 05 — Python: casi fondamentali
Il debugger di GX-TXT · Corso in 10 moduli
In Python molte sorprese nascono da operazioni che il linguaggio considera valide: uno slicing può restituire meno elementi di quanto immaginiamo, e due nomi possono riferirsi alla stessa lista. Mettiamo le ipotesi alla prova con esempi piccoli, poi osserviamo eccezioni, ambiti e pausa asincrona.
Scarica gli esempi Python e GNU Octave (ZIP). Estrai tutte le cartelle dell’archivio e mantieni insieme i file degli esempi multifile.
D25 — Indici e slicing Python
Gli indici Python partono da zero. In uno slice
samples[start:stop], il limite iniziale è incluso e quello
finale è escluso: una differenza di un’unità può cambiare un’intera
finestra di dati.
Fermarsi dopo uno slice
Importa e salva slices.py in Python
Scripts. La lista contiene [10, 20, 30, 40, 50];
samples[1:4] seleziona gli elementi con indici 1, 2 e 3,
cioè [20, 30, 40].
Imposta un breakpoint sulla stampa, avvia Start
Debug e usa Continue se compare la pausa
iniziale. Quando sei alla stampa, la riga dello slice è già stata
eseguita: nel pannello delle variabili la prova mostra
samples con lunghezza 5 e window con lunghezza
3.
Continua e confronta l’output WINDOW [20, 30, 40] con
l’asserzione. Se ti aspettavi anche l’elemento di indice 4, il limite
finale dello slice era stato interpretato come inclusivo. Per un accesso
a un solo indice fuori intervallo consulta la D23.
Esercizio
Quale slice seleziona 20 e 30 dalla stessa lista?
Soluzione ragionata
samples[1:3]: include gli indici 1 e 2 ed esclude
l’indice 3.
Indice del corso · Lezione precedente
D26 — Liste e alias
Assegnare alias = original non crea una nuova lista: i
due nomi si riferiscono allo stesso oggetto. Una modifica attraverso uno
dei nomi diventa visibile anche attraverso l’altro.
Seguire la modifica
Importa e registra alias.py. Imposta
un breakpoint sulla riga independent = original.copy() e
avvia il debug. In caso di pausa iniziale usa Continue
per raggiungere il punto.
Nella prova original e alias hanno entrambi
lunghezza 4: alias.append(40) ha modificato la lista
condivisa. La riga evidenziata crea successivamente una copia
superficiale indipendente; l’aggiunta di 50 a independent
non aggiunge un quinto elemento a original.
Continua fino alla fine e controlla le stampe:
ORIGINAL [10, 20, 30, 40] e
INDEPENDENT [10, 20, 30, 40, 50]. La copia superficiale è
sufficiente per questa lista di interi; se gli elementi fossero oggetti
mutabili annidati, andrebbero considerate anche le loro
condivisioni.
Esercizio
Cosa cambia se, prima di append(40), scrivi
alias = original.copy()?
Soluzione ragionata
L’aggiunta riguarda la copia e original rimane
[10, 20, 30]. Modifica le asserzioni per riflettere il
nuovo risultato prima di ripetere la prova.
Indice del corso · Lezione precedente
D27 — Dizionari e valori assenti
Un dizionario associa chiavi a valori. Se un calcolo dipende da una chiave, il debugger aiuta a controllare che il valore ottenuto sia quello previsto prima che venga usato.
Verificare i parametri
Importa e registra parameters.py.
Lo script usa scale = 2.0, offset = 1.0 e
sample = 4.0. Imposta un breakpoint su
result = sample * scale + offset, avvia il debugger e
raggiungi il punto con Continue dopo l’eventuale pausa
iniziale.
Il pannello mostra un dizionario con due elementi e i tre scalari
sample, scale e offset. La riga
evidenziata non ha ancora eseguito il calcolo: il risultato atteso è
9.0. Usa Step Over, poi controlla result e
continua.
Se una chiave obbligatoria manca, l’accesso
parameters["scale"] produce un KeyError. Usare
get con un default ha senso soltanto se quel valore
predefinito è previsto dai requisiti; altrimenti rischia di nascondere
un parametro mancante.
Esercizio
Quale risultato ottieni con sample = 4,
scale = 2 e offset = 1?
Soluzione ragionata
- Prima si moltiplica 4 per 2, poi si aggiunge 1.
Indice del corso · Lezione precedente
D28 — Eccezioni e gestione
Un’eccezione può essere gestita dal programma oppure propagarsi fino a far fallire il Job. I due casi richiedono letture diverse dell’output e dello stato finale.
Una conversione gestita
Importa parse_input.py e salvalo
nella Session. La stringa not-a-number non può essere
convertita con float, ma lo script cattura esplicitamente
ValueError. Imposta un breakpoint sulla stampa nel blocco
except, avvia il debugger e raggiungi il punto con
Continue dopo l’eventuale pausa iniziale.
Nella prova il pannello mostra text = not-a-number e
error di tipo ValueError. Continua: il
programma deve stampare INPUT_ERROR ValueError. L’eccezione
è un input errato intenzionale dell’esempio, non un problema di
GX-TXT.
Confronta con la D23, dove un
IndexError non catturato ha portato a FAILED e
alla traccia in stderr. Catturare l’eccezione appropriata permette una
risposta esplicita; un generico silenzio su ogni errore renderebbe più
difficile la diagnosi.
Esercizio
Cosa viene stampato se text è "2.5"?
Soluzione ragionata
La conversione riesce e viene eseguito il ramo else, che
stampa VALUE 2.5.
Indice del corso · Lezione precedente
D29 — Funzioni annidate e ambito
I valori che vediamo dipendono dal frame selezionato. In questo esempio una funzione chiama un’altra funzione: ciascuna ha argomenti e variabili locali proprie.
Confrontare i contesti
Usa nested.py. Fermati
sulla chiamata adjust(sample), poi entra con Step
Into. Alla seconda iterazione il frame adjust
mostra value = 1:
Seleziona accumulate nello stack. Qui osservi
sample = 1, total = 1 e il valore di
adjusted conservato dall’iterazione precedente; la chiamata
corrente non è ancora tornata:
sample viene passato a adjust come
argomento value. Il valore di ritorno della chiamata
corrente sarà assegnato ad adjusted solo dopo il ritorno.
Selezionare il frame del chiamante non esegue l’assegnazione.
Esercizio
Alla seconda iterazione, mentre adjust(1) non è ancora
tornata, perché adjusted nel chiamante può valere ancora
1?
Soluzione ragionata
È il valore assegnato nell’iterazione precedente. L’assegnazione
corrente riceverà 2 solo dopo il ritorno di adjust.
Indice del corso · Lezione precedente
D30 — Pause asincrono Python
In Python il comando Pause può richiedere una pausa mentre un Debug Job è in esecuzione. La posizione esatta dipende da quando l’interprete può elaborare la richiesta: non è un breakpoint prefissato.
Un ciclo breve e controllato
Importa e registra slow_counter.py. Lo script esegue 150
incrementi, con una breve attesa per iterazione; se portato a termine
stampa COUNT 150. Non imposta breakpoint.
Apri il debugger e premi Start Debug. Nella prova
iniziale il debugger si è fermato all’inizio dello script; premi
Continue e attendi che lo stato diventi
RUNNING. Il pulsante Pause è disponibile
durante l’esecuzione:
Premi Pause. Nella prova lo stato passa a
PAUSED e le variabili mostrano count = 21 e
index = 20:
I valori esatti variano con il momento della richiesta. Puoi usare Continue per riprendere fino alla fine oppure Stop per annullare. Questo comportamento riguarda l’adapter Python della versione di prova: il manuale dell’adapter Octave descrive la pausa asincrona come non disponibile; per Octave useremo breakpoint e passi.
Esercizio
Perché un’altra esecuzione può fermarsi con un valore di
count diverso da 21?
Soluzione ragionata
La richiesta arriva durante un ciclo in corso e il momento effettivo dell’arresto dipende dai tempi di esecuzione. Un breakpoint impostato su una riga è più adatto quando serve una posizione precisa.
Indice del corso · Lezione precedente
Nel passaggio a Octave cambiano alcune convenzioni. Conviene rifare gli stessi controlli su indice, forma dei dati e comportamento delle funzioni.
Modulo 04 precedente · Indice dei 10 moduli · Modulo 06 successivo
Altre tappe del progetto
- Debugger GNU Octave in GX-TXT: breakpoint, variabili e API pubbliche
- Debugger GX-TXT · Modulo 09 — Casi pratici integrati
- Debugger GX-TXT · Modulo 10 — Autonomia e progetto conclusivo
- Debugger GX-TXT · Modulo 01 — Fondamenti e primo Debug Job
- Debugger GX-TXT · Modulo 02 — Breakpoint e sorgente
- Debugger GX-TXT · Modulo 03 — Controllo del flusso e stack