Il debugger di GX-TXT · Corso in 10 moduli

Quando il debugger si ferma su una chiamata, la prossima azione dipende dalla domanda: interessa vedere il risultato nel chiamante oppure seguire il calcolo dentro la funzione? Confrontiamo i tre comandi di avanzamento, poi usiamo lo stack per leggere lo stato in cicli, condizioni e progetti con file separati.

Scarica gli esempi Python e GNU Octave (ZIP). Estrai tutte le cartelle dell’archivio e mantieni insieme i file degli esempi multifile.

D13 — Step Over su una sequenza

Step Over esegue l’istruzione corrente e, nel caso ordinario di una chiamata di funzione, torna alla riga successiva del chiamante senza fermarsi all’interno della funzione chiamata.

Preparare l’esempio

Importa nested.py in Python Scripts, salva nello scope session e imposta un breakpoint su adjusted = adjust(sample). L’esempio distribuito con GX-TXT somma i valori 1, 2, 3, 4 e 5: il risultato atteso è NESTED_RESULT 15. Il corrispondente nested.m usa lo stesso calcolo in Octave.

Avvia View → Debugger → Start Debug. Se la pausa iniziale è prima del breakpoint, premi Continue per raggiungerlo. Nella prima iterazione sample vale 0 e total vale 0. Premi Step Over sulla chiamata adjust(sample).

Valori nel chiamante dopo Step Over.
Il debugger Python dopo Step Over: adjusted vale 1 e la prossima riga aggiorna total.

La freccia si sposta sulla riga total += adjusted. Il pannello mostra adjusted = 1, mentre total = 0: l’aggiornamento del totale deve ancora essere eseguito. Un ulteriore Step Over esegue la somma. Il punto rosso sulla chiamata rimane e può fermare nuovamente le iterazioni successive.

Esercizio

Alla prima iterazione quale sarà total dopo aver eseguito total += adjusted?

Soluzione ragionata

Vale 1: il totale precedente è 0 e adjusted vale 1. La riga evidenziata nello screenshot non è ancora stata eseguita.

Indice del corso · Lezione precedente

D14 — Step Into nelle funzioni

Step Into permette di seguire una chiamata dentro una funzione del linguaggio. È il comando utile quando l’ipotesi riguarda il calcolo interno, anziché il suo solo risultato.

Entrare in adjust

Usa nested.py registrato nella Session. Imposta un breakpoint sulla riga adjusted = adjust(sample) e avvia il debug. Alla pausa sulla chiamata, premi Step Into. Se parti dalla prima pausa del programma, usa Continue per raggiungere il breakpoint.

Nella prova illustrata ci troviamo alla seconda iterazione: sample vale 1. Il debugger entra nella funzione adjust, mostra la riga increment = value + 1 e la variabile locale value = 1.

Funzione adjust dopo Step Into.
Debugger Python dentro adjust con value uguale a 1 e stack delle chiamate.

Il pannello Call Stack mostra adjust, accumulate e il livello dello script. value è l’argomento locale della funzione chiamata; sample appartiene invece al chiamante. Alla prima iterazione i valori corrispondenti sono 0, perché range(5) comincia da 0.

Esercizio

Se sample vale 1, quale valore restituirà adjust dopo aver eseguito increment = value + 1?

Soluzione ragionata

Restituirà 2. Prima di eseguire l’assegnazione, il debugger si trova sulla riga del calcolo e value è 1.

Indice del corso · Lezione precedente

D15 — Step Out e ritorno

Dopo aver ispezionato una funzione, Step Out ne prosegue l’esecuzione fino al ritorno nel chiamante. In questo modo non è necessario seguire manualmente ogni istruzione rimasta nella funzione.

Uscire da adjust

Apri nested.py, metti un breakpoint sulla chiamata adjust(sample) e usa Step Into come nella D14. Quando sei fermo in adjust, premi Step Out.

Ritorno al chiamante dopo Step Out.
Ritorno al chiamante dopo Step Out: adjusted vale 2 nella seconda iterazione.

Nella prova, alla seconda iterazione, il debugger torna in accumulate sulla riga total += adjusted. Il pannello mostra sample = 1, adjusted = 2 e total = 1: il valore restituito è stato assegnato, ma l’aggiornamento di total è ancora da eseguire. Nella prima iterazione adjusted sarebbe 1 e il totale precedente 0.

Un eventuale breakpoint incontrato nel percorso può influire sulla successiva pausa: controlla sempre freccia, stack e stato, invece di presumere il punto raggiunto.

Esercizio

Dopo lo screenshot, quanto varrà il totale quando verrà eseguita la riga evidenziata?

Soluzione ragionata

Varrebbe 3: il totale precedente è 1 e il valore restituito dalla seconda chiamata è 2.

Indice del corso · Lezione precedente

D16 — Call Stack e frame selezionato

La pila delle chiamate descrive come l’esecuzione è arrivata al punto in pausa. Ogni riga rappresenta un frame, con la funzione, il file e la posizione associati.

Confrontare funzione e chiamante

Con nested.py, fermati in adjust usando il breakpoint sulla chiamata e Step Into, come nella D14. Lo stack contiene adjust, il suo chiamante accumulate e il livello dello script.

Seleziona accumulate nel pannello Call Stack per esaminare il chiamante. Nel frame della funzione chiamata trovi value; nel chiamante puoi confrontare sample, total e gli altri locali presenti in quel momento.

Frame del chiamante nello stack.
Frame del chiamante selezionato nello stack durante la pausa.

Selezionare una riga dello stack non esegue il programma e non sposta il suo vero punto di esecuzione. Cambia il contesto che stai esaminando; per riprendere con i comandi di esecuzione, controlla il frame attivo e la freccia mostrata. Un frame esterno può riferirsi a un altro file: leggi sempre il percorso e il numero di riga.

Esercizio

Se selezioni il chiamante mentre adjust è in pausa, la funzione adjust è già tornata?

Soluzione ragionata

No. La selezione serve a osservare un altro frame. Per far proseguire la funzione occorre un comando di esecuzione, per esempio Step Out.

Indice del corso · Lezione precedente

D17 — Cicli e condizioni

Un breakpoint dentro un ciclo può fermare l’esecuzione più volte sulla stessa riga. Per capire quale iterazione stiamo osservando dobbiamo leggere i valori delle variabili, non soltanto il numero di riga.

Un filtro semplice

Importa e registra filter_sum.py in Python Scripts. I dati sintetici sono 1, 2, 3 e 4; lo script somma soltanto i valori maggiori di 2. Il risultato atteso è FILTERED_TOTAL 7.

Imposta un breakpoint sulla riga if sample > threshold: e avvia Start Debug. Se l’esecuzione si ferma prima, premi Continue per raggiungere il punto. Alla prima iterazione sample è 1 e threshold è 2: la condizione è falsa e il corpo dell’if non viene eseguito.

Prima pausa sulla condizione del ciclo.
Primo passaggio al controllo della soglia nel ciclo Python.

Premi Continue per raggiungere la stessa riga nelle iterazioni successive. Alla terza iterazione sample vale 3: premi Step Over sulla condizione. La riga successiva è total += sample, perché 3 è maggiore di 2:

Ramo vero della condizione con sample uguale a tre.
Il debugger entra nel ramo della condizione con sample uguale a 3.

La riga evidenziata non ha ancora aggiornato total, che nello screenshot vale 0. Proseguendo, anche il valore 4 supera la soglia. Al termine il totale è 7. Un breakpoint ordinario si ripete a ogni passaggio della riga: non lo stiamo descrivendo come un breakpoint condizionale.

Esercizio

Quali valori entrerebbero nel totale se la condizione fosse sample >= threshold? Quale risultato ti aspetteresti?

Soluzione ragionata

Entrerebbero 2, 3 e 4, per un totale di 9. Modifica e salva una copia dello script e aggiorna l’asserzione prima di verificarla.

Indice del corso · Lezione precedente

D18 — File e frame esterni

Un progetto può separare il punto di ingresso e le funzioni di supporto in file diversi. Il debugger deve mostrare il file e la riga del frame effettivamente selezionato: seguire soltanto il numero della riga non basta.

Creare il progetto

I due file di esempio sono main.py e helpers.py. main.py chiama adjust(4), definita in helpers.py; il risultato atteso è ADJUSTED 5.

In Python Scripts scegli Project → New Project, assegna nome e ID, usa lo scope session e conserva main.py come entrypoint. Inserisci nel file principale il contenuto del file allegato. Con Project → New file crea helpers.py e inserisci il contenuto della funzione. Usa File → Save All per salvare l’intero progetto.

Progetto Python con main.py e helpers.py.
Workspace Python con i due file del progetto.

Seguire la chiamata fra i file

Apri helpers.py dall’albero del progetto e metti un breakpoint sulla riga increment = value + 1. Apri il debugger e avvia Start Debug. Se il programma si ferma inizialmente nel file principale, premi Continue per raggiungere il breakpoint nel file di supporto.

Debugger fermo nella funzione del file helpers.py.
Debugger fermo in helpers.py con il frame adjust e il valore quattro.

Nella prova GX-TXT mostra la scheda helpers.py, la riga 4 e value = 4; nello stack compare anche il chiamante nel file principale. Selezionando i frame puoi confrontare i rispettivi percorsi e righe. Una funzione di libreria esterna al progetto può avere un percorso diverso: usa quello mostrato dal debugger e non attribuire la sua riga al file attualmente visibile.

Premi Continue per terminare: il programma deve produrre ADJUSTED 5. Una successiva modifica di un file richiede di salvare il progetto e avviare una nuova prova con breakpoint coerenti con la revisione.

Esercizio

Se il frame adjust indica la riga 4 di helpers.py e il chiamante la riga 5 di main.py, sono la stessa posizione?

Soluzione ragionata

No. Sono righe di due file diversi: il primo contiene la funzione chiamata, il secondo la chiamata. Lo stack collega le due posizioni.

Indice del corso · Lezione precedente

L’avanzamento porta al punto giusto. Il modulo successivo mostra come leggere lo stato del frame e separarlo dall’output e dagli errori del programma.

Modulo 02 precedente · Indice dei 10 moduli · Modulo 04 successivo

#debugger #GNU Octave #GX-TXT #Python

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *