GX-TXT Python Script Workspace: modificare il codice, cercare e navigare fra le righe

L’editor Python di GX-TXT riunisce la scrittura del sorgente, la selezione del testo, la cronologia delle modifiche, la ricerca e la navigazione fra righe e blocchi. Conoscere questi strumenti permette di lavorare su programmi scientifici senza confondere una modifica locale con il salvataggio di uno Script registrato o con l’esecuzione di un Job.

In questa guida utilizziamo una bozza sintetica non eseguita. Il codice è soltanto un esempio per riconoscere funzioni, righe, colori e blocchi: non vengono richiesti strumenti di laboratorio, dati sperimentali o Dataset.

1. Aprire il documento nell’editor

Dalla finestra Python Script Workspace aprire o creare una scheda Python. Per una nuova bozza utilizzare File → New Script.

Il codice compare nell’area centrale. La scheda untitled.py indica che il documento non ha ancora un’identità registrata. Se il testo viene modificato, un asterisco accanto al nome della scheda segnala la presenza di cambiamenti locali.

2. Un’area di codice ampia e leggibile

Durante l’editing è preferibile lasciare chiusi Explorer, Snippets, Debugger e gli altri pannelli non necessari. Utilizzare View → Focus source / restore panes per riservare quasi tutta la finestra al codice.

La superficie Source può usare il tema High Contrast Dark, con fondo nero autentico e colorazione della sintassi. La cornice Tk e i menu possono rimanere chiari: non è necessario applicare un tema scuro artificiale a tutta la finestra.

3. Un esempio Python sintetico

Per seguire i comandi possiamo utilizzare questo codice, i cui commenti sono in inglese:

# P06 synthetic example (not executed)
from math import sqrt

def calibration(value):
    gain = 2.0
    if value > 0:
        result = gain * sqrt(value)
    else:
        result = 0.0
    return result

samples = [1.0, 4.0, 9.0]
for sample in samples:
    print(calibration(sample))

La funzione, il ramo condizionale e il ciclo illustrano la struttura del sorgente. Il testo non viene eseguito aprendo la scheda.

4. Evidenziazione sintattica Python

L’editor riconosce elementi come commenti, parole chiave, definizioni, identificatori, funzioni e numeri. La colorazione viene applicata direttamente alla superficie Source originale.

La colorazione aiuta a leggere il codice, ma non equivale alla sua esecuzione e non garantisce che tutti gli input siano scientificamente appropriati. Le API pubbliche e i contratti dei risultati si verificano separatamente.

Editor Python GX-TXT High Contrast Dark con codice sintetico, highlighting colorato e gutter numerato da 1 a 15
Figura 1. La superficie Source mostra parole chiave, numeri, funzioni e numeri di riga nel tema originale High Contrast Dark.

5. Il margine con i numeri di riga

A sinistra del testo si trova il gutter, che visualizza i numeri delle righe fisiche del sorgente. Questo riferimento è utile durante la ricerca degli errori, nella navigazione e nella consultazione delle istruzioni.

Il numero di una riga del sorgente non è una riga di Dataset e non cambia perché un blocco viene temporaneamente nascosto tramite folding.

6. Posizione del cursore: riga e colonna

La barra inferiore riporta informazioni come Ln 6, Col 1, riferite alla posizione attuale del cursore nel testo.

La riga è numerata a partire da 1. Quando il sorgente termina con un carattere di nuova riga, il cursore può trovarsi anche all’inizio di una riga finale vuota: questo non significa che sia comparsa una nuova istruzione Python.

7. Selezionare il testo con Ctrl+A

Per selezionare l’intero documento usare Ctrl+A quando il focus è nell’area del codice. La selezione viene evidenziata senza modificare il contenuto.

Se il focus si trova invece nel campo Find o in un campo di metadati, Ctrl+A agisce sul controllo che possiede il focus. Prima di selezionare o copiare il sorgente, fare clic direttamente sul codice.

Editor Python originale con selezione completa del codice mediante Ctrl+A evidenziata in blu
Figura 2. Ctrl+A seleziona il testo della bozza nell’editor senza modificare gli Script registrati.

8. Il menu Edit e le scorciatoie

Il menu Edit raccoglie Undo, Redo, Cut, Copy, Paste e Select all, oltre a Find, Find next, Find previous, Go to line e ai comandi per ripiegare i blocchi.

Le scorciatoie indicate sono Ctrl+Z, Ctrl+Y, Ctrl+X, Ctrl+C, Ctrl+V e Ctrl+A. La disponibilità di una voce dipende dalla selezione, dal focus e dalla cronologia del documento attivo.

Menu Edit originale di Python Script Workspace con scorciatoie, Find, Go to line e Fold all
Figura 3. Il menu Edit raccoglie Undo, Redo, Cut, Copy, Paste, ricerca, navigazione per riga e folding.

9. Copy e Cut non sono equivalenti

Copy copia il testo selezionato negli appunti lasciandolo nel documento. Cut trasferisce la selezione negli appunti e la rimuove dal buffer.

Prima di usare Cut verificare che la selezione riguardi il documento previsto. Una selezione sull’intero sorgente è un’operazione potente e può svuotare temporaneamente la scheda, senza tuttavia cancellare direttamente un record del Registry.

10. Paste e ripristino della selezione

Paste inserisce il contenuto degli appunti nel punto corrente o sostituisce il testo selezionato. L’editor tratta la sostituzione come un’operazione locale sul buffer.

Se si incolla il codice appena tagliato, il contenuto può tornare identico a prima. La cronologia delle operazioni rimane distinta dalla revisione dello Script registrato, che cambia solo dopo un successivo salvataggio.

11. Undo con Ctrl+Z

Ctrl+Z annulla una modifica recente del testo. Per esempio, dopo aver aggiunto un commento temporaneo, Undo può riportare il codice esattamente alla forma precedente.

Il comando agisce sul contenuto locale della scheda, non sulla cronologia del Registry. Per tornare a una revisione già registrata occorre usare gli strumenti di gestione dello Script.

12. Redo con Ctrl+Y

Ctrl+Y ripristina una modifica appena annullata, quando la cronologia del buffer lo consente.

Un ciclo modifica → Undo → Redo → Undo permette di controllare la differenza fra testo temporaneamente cambiato e testo originale. Anche dopo un ripristino del contenuto, verificare sempre lo stato saved o modified prima di chiudere la scheda.

13. Aprire Find con Ctrl+F

Premere Ctrl+F per portare il focus al campo Find. Digitare una parola presente nel sorgente, per esempio calibration.

La ricerca è una funzione di navigazione: evidenzia una corrispondenza e sposta la posizione di lettura senza aggiungere istruzioni né eseguire il codice.

14. Cercare in avanti con F3

F3 porta alla corrispondenza successiva. Se la parola compare nella definizione di una funzione e anche nelle chiamate, si può passare dall’una alle altre.

La corrispondenza viene evidenziata nella superficie Source e rimane un riferimento di testo, non un risultato di calcolo.

Editor Python con campo Find calibration e corrispondenza evidenziata nella definizione di funzione
Figura 4. Ctrl+F e F3 evidenziano le occorrenze di calibration; Shift+F3 torna al risultato precedente.

15. Cercare indietro con Shift+F3

Shift+F3 percorre i risultati della ricerca nella direzione opposta. È utile quando si è passati a una chiamata e si desidera ritornare alla definizione della funzione.

La ricerca è indipendente dalle righe visibili in quel momento: per leggere un risultato all’interno di un blocco ripiegato può essere necessario riaprire il blocco.

16. Tornare al codice dopo la ricerca

Normalmente si può scegliere il punto del codice al quale tornare semplicemente facendo clic nell’editor. Anche il tasto Escape può essere previsto per uscire dal campo di ricerca.

Nota per la versione P005: dopo la creazione o chiusura di altre schede, Escape nel campo Find può non restituire correttamente il focus all’editor attivo e può mostrare un errore della finestra. Per continuare, selezionare direttamente il testo nella scheda corrente. Non serve salvare o riavviare il framework per il solo ritorno del focus.

17. Aprire Go to line con Ctrl+G

Premere Ctrl+G oppure scegliere Edit → Go to line. Compare un piccolo dialogo con il campo Line, il pulsante Go e Cancel.

Il numero richiesto è quello della riga fisica del sorgente. Il comando non si riferisce ai record di un Dataset, ai parametri del programma o alla posizione di un punto in un grafico.

Dialogo originale Go to line del Python Script Workspace con campo Line e pulsanti Go Cancel
Figura 5. Ctrl+G apre il dialogo Go to line, nel quale si digita un numero di riga fisica.

18. Raggiungere una riga specifica

Inserire un intero positivo, per esempio 6, e confermare con Go. Il cursore viene posizionato alla prima colonna della riga indicata.

Nell’esempio la sesta riga contiene un’istruzione condizionale Python. La barra di stato consente di verificare la posizione raggiunta senza modificare il codice.

19. Gestire un numero non valido o fuori intervallo

Se si inserisce un valore non numerico o inferiore a 1, il dialogo non esegue lo spostamento. È necessario correggere il campo o scegliere Cancel.

Se invece si inserisce un intero positivo superiore all’ultima riga, il Viewer porta il cursore alla fine del sorgente. Il documento rimane invariato.

20. Che cosa significa folding

Il folding consente di nascondere temporaneamente il corpo di una funzione, una struttura condizionale o un ciclo, lasciando visibile la riga che identifica il blocco.

Non è una cancellazione del codice. Lo scopo è ridurre il numero delle righe visualizzate quando si sta esaminando la struttura di un programma più lungo.

21. Ripiegare il blocco corrente

Posizionare il cursore in una funzione e scegliere Edit → Fold current block. Il corpo viene nascosto e nel gutter compare un indicatore che permette di riconoscere il blocco ripiegato.

Nella schermata, la funzione definita alla riga 4 resta visibile, mentre le righe del corpo sono temporaneamente nascoste. Dopo la funzione si continua a vedere la numerazione fisica originale.

Python Script Workspace con funzione calibration ripiegata e gutter che conserva i numeri fisici 4 e 11
Figura 6. Fold current block nasconde temporaneamente il corpo della funzione senza cancellare le righe fisiche.

22. Ripiegare tutti i blocchi

Il comando Edit → Fold all applica il ripiegamento a tutti i blocchi riconosciuti dalla struttura Python del documento.

È utile per ottenere una vista d’insieme di funzioni, cicli e strutture annidate. Il contenuto del sorgente rimane identico: vengono applicate soltanto regole di visualizzazione.

Editor Python originale dopo Fold all con corpi def e for nascosti e indicatori del gutter
Figura 7. Fold all compatta i blocchi della funzione e del ciclo, preservando esattamente il codice.

23. Ripristinare tutte le righe con Unfold all

Per tornare al testo completo scegliere Edit → Unfold all. I blocchi tornano visibili nelle rispettive posizioni originarie.

Il documento recupera la leggibilità di ogni istruzione senza richiedere Undo o un nuovo Save. Unfold all è una modifica della presentazione, non del codice.

Editor Python GX-TXT dopo Unfold all con tutti i blocchi e numeri delle righe originali visibili
Figura 8. Unfold all ripristina la visibilità di tutte le righe, senza modificare il sorgente.

24. I numeri nel gutter non vengono rinumerati

Quando una funzione viene ripiegata, nel gutter si possono vedere salti nella sequenza, per esempio dalla riga 4 alla riga 11. Le righe intermedie esistono ancora, ma non vengono disegnate.

Questo comportamento preserva il riferimento alle righe fisiche del file. Per leggere o modificare una riga nascosta, espandere prima il blocco corrispondente.

25. Scrivere codice e salvarlo sono operazioni diverse

Se si modifica una bozza, il Workspace può mostrare modified e SHA-256 pending, perché non esiste ancora una registrazione del nuovo testo nel Registry.

L’evidenziazione, la ricerca, i comandi del menu e il folding non producono un Job. Per conservare uno Script occorre impostarne correttamente Scope, Script ID e metadati, poi eseguire una vera operazione Save.

26. Non confondere lexer e validazione scientifica

Il riconoscimento di commenti, parole chiave, blocchi e numeri avviene nell’editor ed è utile anche per sorgenti non ancora registrati.

Questa analisi lessicale non sostituisce la verifica dei contratti delle API pubbliche, degli input, delle unità, dei parametri o dei risultati. Un programma può avere un aspetto sintattico ordinato e comunque richiedere correzioni scientifiche.

27. Chiudere una bozza di esercizio

Se il testo è stato creato soltanto per esercitarsi, Close tab richiede di scegliere come gestire le modifiche non salvate.

Cancel conserva la bozza; No la scarta senza registrarla. Prima di scegliere No verificare che il dialogo si riferisca proprio alla scheda temporanea e non a uno Script con modifiche importanti.

L’editor Python offre selezione e appunti, Undo/Redo, ricerca avanti e indietro, Go to line e comandi per ripiegare i blocchi. La sintassi colorata, il gutter e l’ampia superficie Source aiutano a leggere programmi più lunghi.

Il testo rimane indipendente dagli altri documenti aperti: solo un’operazione esplicita di registrazione modifica il Registry. Nel capitolo successivo vedremo come importare ed esportare file Python mantenendo coerenti contenuto e identità dello Script.