Il debugger di GX-TXT · Corso in 10 moduli

Una schermata in pausa raccoglie informazioni di natura diversa. Per interpretarla, conviene chiedersi prima quale frame è selezionato, poi cosa proviene dal programma e cosa è stato registrato dal debugger. Gli esempi del modulo mettono in relazione scope, riepiloghi, output e stato finale del Job.

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

D19 — Locals e Globals

Una variabile locale appartiene al contesto di una funzione; una globale è visibile a livello del programma secondo le regole del linguaggio. Il debugger mostra un riepilogo dei valori associati al frame selezionato.

Osservare due frame

Importa nested.py, imposta il breakpoint sulla chiamata adjust(sample) e, quando è raggiunto, premi Step Into. Nella seconda iterazione il frame adjust mostra locals.value = 1:

Argomento locale nella funzione.
Argomento locale value nel frame adjust.

Seleziona accumulate nello stack: il pannello cambia contesto e mostra, fra gli altri, locals.sample = 1 e locals.total = 1 nella prova. Se un nome è preceduto da globals, si riferisce alle informazioni globali mostrate dal debugger per quel contesto.

Variabili del frame chiamante.
Variabili del chiamante accumulate nel medesimo momento.

La selezione di un frame è un’operazione di lettura: non aggiorna il totale né completa la funzione. Il contenuto del pannello può essere più lungo dello spazio visibile; scorri o ridimensiona prima di concludere che un nome sia assente.

Esercizio

Perché nello stesso istante leggi value in un frame e sample nell’altro?

Soluzione ragionata

sample è una variabile del chiamante; il suo valore è passato come argomento value alla funzione chiamata. I due nomi appartengono a contesti diversi.

Indice del corso · Lezione precedente

D20 — Dati grandi e visualizzazione limitata

Il pannello delle variabili è un riepilogo: tipo, forma e contenuto mostrato aiutano a orientarsi, ma uno spazio visibile limitato non dimostra che tutto il contenuto sia stato visualizzato.

Leggere un elenco

Usa filter_sum.py, ferma il debugger sulla condizione e raggiungi la terza iterazione. Nella prova Python il pannello indica che samples è una lista di lunghezza 4, mentre sample, threshold e total sono interi.

Lista e scalari nel pannello delle variabili.
Riepilogo della lista e degli scalari nel debugger Python.

La colonna Value può essere più stretta del testo che contiene. Ridimensiona i pannelli o scorri quando possibile; se un oggetto è più grande del riepilogo disponibile, una parte dei valori può non comparire. Non interpretare una visualizzazione abbreviata come un elenco completo.

Per una verifica più mirata, prepara nello script una variabile intermedia, per esempio first_sample = samples[0], salva e riavvia il debug. In alternativa stampa esplicitamente ciò che serve e consulta l’output del programma, distinguendolo dalle informazioni del debugger. Per dati reali evita di stampare o mostrare informazioni riservate.

Esercizio

Il riepilogo della lista è tagliato a destra. Puoi concludere che la lista contiene solo gli elementi visibili?

Soluzione ragionata

No. Controlla la forma dichiarata e usa una verifica mirata sullo script. Uno spazio di visualizzazione ridotto non modifica la struttura dei dati.

Indice del corso · Lezione precedente

D21 — Sola lettura e assenza di Watch

Nel debugger di riferimento il pannello Locals / Globals presenta riepiloghi dei valori del frame selezionato. Non è una console di valutazione arbitraria e non va presentato come un pannello Watch in cui inserire espressioni o cambiare i valori in esecuzione.

Preparare un valore da osservare

Nello script Octave temperature_fixed.m, le variabili celsius, offset e kelvin sono già esplicite. Ferma il debugger sulla stampa: dopo aver ridimensionato i pannelli, la prova mostra 20, 273,15 e 293,15.

Variabili calcolate nello script Octave.
Valori già calcolati nello script Octave e mostrati dal debugger.

Se ti serve osservare un’espressione più complessa, inserisci una variabile intermedia significativa nel sorgente, salva e avvia un nuovo Debug Job. Per esempio, una copia potrebbe assegnare difference = kelvin - celsius; prima della stampa. Questo cambia il programma sorgente della nuova prova: non modifica interattivamente il Job già in pausa.

Esercizio

Vuoi vedere la differenza fra kelvin e Celsius senza presumere un Watch. Quale procedura puoi usare?

Soluzione ragionata

Aggiungi un’assegnazione intermedia a una copia dello script, salva e avvia un nuovo Job fermandoti dopo quella riga. Per l’esempio la differenza attesa è 273,15.

Indice del corso · Lezione precedente

D22 — Output del debugger e del programma

La scheda Debugger output e l’output scritto dallo script rispondono a domande differenti. La prima aiuta a seguire gli stati e i comandi di debug; il secondo contiene ciò che il programma stampa.

Due viste della stessa prova

Esegui in debug il progetto multifile della D18, fermati nella funzione adjust e poi premi Continue. Apri la scheda Debugger output: la prova mostra messaggi come pausa, riconoscimento dei comandi e completamento.

Messaggi del debugger.
Messaggi di stato e comandi nel pannello Debugger output.

Apri invece Program output / diagnostics e seleziona Program output. Il testo del programma è ADJUSTED 5:

Output del programma.
Output ADJUSTED 5 nella finestra dei dettagli del programma.

Nei dettagli del Job puoi anche controllare stderr e stato. Se stai esaminando più esecuzioni, verifica l’identità del Job selezionato: un output precedente non dimostra il risultato della prova corrente.

Esercizio

In quale vista cerchi la stringa stampata da print? Dove cerchi un messaggio di avvenuta pausa del debugger?

Soluzione ragionata

La stringa del programma è in Program output; gli stati e le ricevute dei comandi sono in Debugger output.

Indice del corso · Lezione precedente

D23 — Errori e tracce

Un messaggio di errore è un punto di partenza: indica che cosa è successo e dove cercare. Per capire la causa, confrontiamo la traccia con i dati e con lo stato osservato prima dell’istruzione problematica.

Un indice intenzionalmente errato

Importa index_error.py in Python Scripts e salvalo nella Session. La lista contiene tre elementi, ma il programma chiama read_sample(samples, 3). Gli indici validi sono 0, 1 e 2.

Metti un breakpoint su return samples[index] e avvia il debugger. Dopo l’eventuale pausa iniziale, usa Continue per arrivare alla funzione. Nella prova il pannello mostra una lista di lunghezza 3 e index = 3:

Pausa prima dell’accesso fuori intervallo.
Pausa nella funzione con lunghezza della lista tre e indice tre.

Premi Continue. Il Job termina con FAILED, perché l’accesso supera l’ultimo indice. Apri Program output / diagnostics e seleziona Program stderr:

Traccia Python in stderr.
Traccia Python con IndexError list index out of range.

La traccia riporta la chiamata, l’istruzione di accesso e IndexError: list index out of range. Le righe dell’ambiente di esecuzione fanno parte della traccia; individua soprattutto quelle che rimandano al tuo codice. Una volta che il Job è terminato, lo stack in pausa non è più uno stato vivo.

Correggere e verificare

La copia index_fixed.py usa l’indice 2 e stampa SAMPLE 30. È una correzione adeguata se l’obiettivo era leggere l’ultimo elemento. Se l’indice dipendesse da input esterni, servirebbero controlli coerenti con i requisiti del programma.

Esercizio

Perché l’indice 3 è errato per una lista Python lunga 3?

Soluzione ragionata

La numerazione parte da 0: i tre elementi hanno indici 0, 1 e 2. L’indice 3 richiederebbe un quarto elemento.

Indice del corso · Lezione precedente

D24 — Stati e risultati del Job

Lo stato di un Job riassume come si è conclusa la prova. Va interpretato insieme al programma, all’output e alle azioni che abbiamo compiuto.

Tre esiti da distinguere

  • COMPLETED: nella prova del progetto multifile, il programma è arrivato alla fine e ha stampato ADJUSTED 5.
  • CANCELLED: nella prova della D06, abbiamo premuto Stop mentre il programma era in pausa.
  • FAILED: nella D23, l’indice fuori intervallo ha prodotto un’eccezione non gestita.
Job annullato.
Debugger dopo l’annullamento esplicito della prova.
Job fallito.
Debugger dopo il fallimento dell’esempio con indice errato.
Job completato.
Dettagli di un Job completato con il relativo output.

Una conclusione COMPLETED non prova da sola che un risultato scientifico sia corretto: confronta il risultato con un’attesa indipendente. FAILED richiede di leggere diagnosi e stderr; non supporre automaticamente che ogni fallimento abbia la stessa causa. CANCELLED segnala l’annullamento della prova, non una verifica completa.

Esercizio

Un programma stampa un numero sbagliato ma termina con COMPLETED. Il problema è risolto?

Soluzione ragionata

No. COMPLETED descrive la conclusione dell’esecuzione, non la correttezza del risultato. Riproduci il caso, controlla dati, ipotesi e passaggi, e confronta con il valore atteso.

Indice del corso · Lezione precedente

Questa lettura diventa più utile quando la applichiamo agli errori tipici dei singoli linguaggi. Cominciamo da Python.

Modulo 03 precedente · Indice dei 10 moduli · Modulo 05 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 *