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.

Pausa dopo lo slice Python.
Debugger Python dopo lo slice con window lunga tre elementi.

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.

Liste condivise prima della copia.
Le due variabili original e alias dopo append hanno entrambe lunghezza quattro.

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.

Parametri estratti dal dizionario.
Dizionario e valori estratti in pausa prima del calcolo.

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

  1. 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.

Eccezione ValueError catturata.
Debugger in pausa nel blocco except con un ValueError gestito.

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:

Frame della funzione chiamata.
Argomento value nel frame della funzione adjust.

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:

Frame del chiamante.
Contesto del chiamante accumulate durante la chiamata.

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:

Debug Job Python in esecuzione con Pause disponibile.
Job Python in esecuzione con Pause disponibile.

Premi Pause. Nella prova lo stato passa a PAUSED e le variabili mostrano count = 21 e index = 20:

Debug Job Python in pausa durante il ciclo.
Job Python in pausa dopo la richiesta asincrona.

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

#debugger #GX-TXT #Python

Altre tappe del progetto

Lascia un commento

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