GX-TXT Python Script Workspace: menu e scorciatoie da tastiera

Python Script Workspace riunisce in un’unica barra i comandi di gestione dei sorgenti, modifica del codice, progetti, disposizione dei pannelli e accesso al Runner e alla documentazione. Questa guida presenta i menu realmente disponibili e le principali operazioni da tastiera, distinguendo ciò che si può utilizzare già con una bozza da ciò che richiede uno Script registrato o una Session scientifica.

1. Riconoscere la barra dei menu

Nella parte superiore del Viewer compaiono, nell’ordine, File, Edit, Project, View, Run e Help. Non si tratta di sei programmi separati: tutti agiscono sul contesto del Python Script Workspace.

Le immagini mostrano una bozza di codice nell’editor, senza uno Script già registrato. È per questo che alcune voci risultano disabilitate. Quando si passa a un documento registrato, a un progetto o a una schermata Notes, lo stato dei menu può cambiare.

2. Perché lo stato dei comandi è importante

Un comando grigio non indica necessariamente un difetto: spesso manca un oggetto sul quale operare. Per esempio, non si può eliminare uno Script registrato quando il documento corrente è ancora una semplice bozza senza identità.

D’altra parte, una voce visibile e abilitata non dimostra che una procedura scientifica possa essere completata in qualsiasi contesto. Esecuzione, debugging e pubblicazione dei risultati prevedono ulteriori controlli e una Session valida.

3. Raggiungere la barra con F10

Premere F10 per trasferire il focus alla barra dei menu del Workspace. È un’alternativa al mouse utile quando si lavora prevalentemente da tastiera.

F10 non salva il sorgente e non avvia un Job. Sposta soltanto il punto di interazione verso i controlli della finestra.

4. Spostarsi con le frecce

Quando il focus si trova sui menu, Freccia destra e Freccia sinistra permettono di passare ai gruppi adiacenti. È un modo rapido per raggiungere Edit o Project senza usare il puntatore.

Il nome del menu evidenziato aiuta a capire dove si trova il focus. Il movimento fra i menu non modifica il codice presente nella scheda sorgente.

5. Accedere direttamente con Alt

Le scorciatoie Alt+F, Alt+E, Alt+P, Alt+V, Alt+R e Alt+H richiamano rispettivamente File, Edit, Project, View, Run e Help.

È importante usare il nome e la lettera del menu effettivamente visibile nella propria versione del Viewer. Il comportamento va distinto dai collegamenti delle singole voci, ad esempio Ctrl+F per la ricerca.

6. Aprire e chiudere un menu dalla tastiera

Con il focus su un gruppo, Spazio oppure Freccia giù apre il menu relativo. Escape lo richiude senza selezionare un comando.

Questa sequenza consente di esplorare le voci disponibili mantenendo il sorgente inalterato. Se si desidera soltanto conoscere i comandi, evitare di attivare accidentalmente Save, Delete, Runner o altre operazioni che richiedono un contesto specifico.

7. Il menu File

File raccoglie le operazioni principali su documenti e identità degli Script: New Script, Import .py, Save, Save All, Save As, Export .py, Delete, Copy ID, Close tab e Close.

Le scorciatoie esposte comprendono Ctrl+N, Ctrl+O, Ctrl+S, Ctrl+Shift+S e Ctrl+W. Questi nomi sono quelli mostrati dal menu; i rispettivi flussi di scrittura e salvataggio saranno approfonditi nei capitoli dedicati.

Menu File originale di Python Script Workspace con New Script, Import, Save e Close tab
Figura 1. Menu File aperto nell’editor originale: sono visibili New Script, Import .py, Save e le scorciatoie.

8. New, Import, Save e Save All hanno scopi differenti

New Script prepara una nuova bozza. Import .py riguarda un file Python esterno, mentre Save registra o aggiorna il documento corrente nel contesto corretto.

Save All è destinato alle modifiche dei diversi documenti o file sorgente gestiti dal Workspace. È un’operazione distinta da Save e da Export .py; non va confusa con l’esecuzione di un programma.

9. Save As, Export e chiusura

Save As prepara una copia con una distinta identità registrata, secondo le regole del Registry. Export .py serve a scrivere un file sorgente Python, non a pubblicare un Dataset scientifico.

Close tab chiude la scheda corrente, mentre Close chiude la finestra Workspace. Le schede modificate possono richiedere una scelta esplicita per preservare il lavoro non salvato. Prima di usare questi comandi, verificare lo stato della bozza e della relativa identità.

10. Perché Delete e Copy ID possono essere disabilitati

In una bozza iniziale senza Script ID registrato, Delete e Copy ID risultano disabilitati. Non esiste ancora un record registrato da eliminare o un identificativo da copiare.

Dopo il salvataggio di uno Script, la disponibilità dei comandi può cambiare. Questa distinzione è un primo esempio di come la GUI separi un buffer modificabile da un documento registrato.

11. Il menu Edit

Il menu Edit offre Undo, Redo, Cut, Copy, Paste, Select all, Manage imports, Find, Find next, Find previous e Go to line. Contiene inoltre i comandi di folding e le funzioni Notes disponibili nel contesto appropriato.

L’immagine mostra uno stato iniziale nel quale Undo, Redo, Cut e Copy sono disabilitati, mentre ricerca e navigazione sono disponibili. I comandi Notes dipendono dal tipo di scheda attiva.

Menu Edit originale Python con Find, Go to line, Manage imports e comandi disabilitati
Figura 2. Menu Edit nella bozza iniziale, con ricerca attiva e Undo/Redo, Cut e Copy disabilitati.

12. Selezione, copia e cronologia delle modifiche

Le scorciatoie riportate dal menu comprendono Ctrl+Z per Undo, Ctrl+Y per Redo, Ctrl+X per Cut, Ctrl+C per Copy, Ctrl+V per Paste e Ctrl+A per Select all.

Queste azioni dipendono dal widget che possiede il focus. Prima di intervenire su un sorgente scientifico è utile verificare che il cursore si trovi davvero nell’editor e non in un campo come Script ID, Name o Description.

13. Il menu Project

Project raccoglie New Project, Open Project, Import Project, Manage Project e il sottomenu Public APIs, oltre alle operazioni sui singoli file del progetto.

Nello stato iniziale, senza un progetto aperto, voci come Open project file, New file, Rename/move file, Remove file, Set entrypoint e Return to code sono disabilitate.

Menu Project originale con New Project, Open Project e funzioni sui file non ancora disponibili
Figura 3. Menu Project: le funzioni del progetto sono distinte dai comandi sui file, inizialmente disabilitati.

14. Creare un progetto non equivale ad aprire uno Script

New Project apre il percorso di preparazione di un progetto Python, con il proprio insieme di file e un eventuale entrypoint. Le operazioni sui file diventano pertinenti quando esiste un progetto attivo.

Il percorso diretto Project → New Project è distinto dall’apertura di uno Script singolo. L’uso completo del Project Canvas, la creazione effettiva dei file e il salvataggio saranno illustrati più avanti, dopo le relative verifiche.

15. Il sottomenu Public APIs

La voce Public APIs contiene comandi per l’inventario delle API associate a un progetto, come Saved Public APIs, Preview draft APIs, Open implementation e Cancel API inventory.

Queste operazioni riguardano un contesto di progetto e non sono un invito a richiamare API interne direttamente dal codice scientifico. Gli Script Python dovranno usare soltanto le API pubbliche documentate e disponibili per la versione installata.

16. Il menu View

View gestisce la disposizione dell’interfaccia. Comprende Script Explorer, GX-TXT Bridge Snippets, API Browser, Debugger, Call Stack, Variables / Locals, Debug Output / Console e Breakpoints, oltre ai controlli delle proprietà e di Notes.

Qui si trovano anche Focus source / restore panes e Reset editor layout, utili per adattare la finestra alla fase del lavoro.

Menu View originale di Python Script Workspace con Explorer, Snippets e Focus source
Figura 4. Menu View: Focus source / restore panes e i controlli dei pannelli opzionali.

17. Focus source: più spazio per il codice

Durante la scrittura conviene mantenere chiusi i pannelli che non servono. Con View → Focus source / restore panes l’area centrale può occupare quasi tutta la larghezza del Workspace.

Explorer, snippets, parametri, proprietà e strumenti di debug vanno riaperti quando devono essere consultati o modificati. La disposizione dell’interfaccia non altera di per sé il sorgente registrato.

18. I pannelli di debug non sono un Job attivo

La presenza delle voci Debugger, Call Stack, Variables / Locals, Debug Output e Breakpoints nel menu View non significa che esista già un’esecuzione in corso.

Sono superfici di lavoro o consultazione che acquisiscono significato quando una Session, uno Script e un processo di debugging sono effettivamente disponibili. Per evitare confusione, non aprirle tutte contemporaneamente durante la normale modifica del sorgente.

19. Il menu Run

Run presenta gli ingressi a Debug Session script, Open Script Runner e Script Jobs Manager. Sono percorsi distinti che richiedono una verifica dell’identità e dello stato dello Script prima di arrivare all’esecuzione.

Un elemento inizialmente abilitato può comunque mostrare un messaggio o rifiutare un’operazione se non esistono Session o Script idonei. Aprire un menu non avvia automaticamente alcun Job.

Menu Run originale con Debug Session script, Open Script Runner e Script Jobs Manager
Figura 5. Menu Run: sono visibili gli accessi al Runner e al debugger; nessuna esecuzione è stata avviata.

20. Non confondere menu Run ed esecuzione

Il Runner è il punto nel quale si potrà controllare lo Script registrato, la revisione e gli eventuali parametri prima di avviare un Job. Il debugger è un procedimento separato; il Jobs Manager serve a consultare e gestire i Job esistenti.

Nella versione qui illustrata può comparire anche una voce Script Library. Non è necessaria per apprendere questi menu e non viene utilizzata nei percorsi di questa guida. Per i progetti seguiremo le funzioni dirette del Python Script Workspace dopo averle verificate.

21. Il menu Help

Help contiene Script Bridge help, Viewer manual / Debugger guide e About. La scorciatoia indicata per il manuale è F1.

È opportuno consultare la guida prima di usare nuove funzioni di gestione del Registry o del debugger: il fatto che un comando sia disponibile in un menu non equivale a conoscerne le precondizioni.

Menu Help originale Python con Script Bridge help, Viewer manual F1 e About
Figura 6. Menu Help: Script Bridge help, manuale del Viewer tramite F1 e informazioni sul modulo.

22. Cercare una parola con Ctrl+F

Ctrl+F trasferisce il focus al campo Find. Dopo aver inserito il termine ricercato, F3 passa al risultato successivo e Shift+F3 torna a quello precedente.

Il testo trovato viene evidenziato nel sorgente. Queste operazioni sono utili per navigare fra importazioni, definizioni e chiamate alle funzioni senza modificare il programma.

23. Raggiungere una riga con Ctrl+G

Ctrl+G apre il dialogo Go to line. Nel campo Line si indica un numero di riga e si conferma con Go; Cancel chiude il dialogo senza cambiare il testo.

Il numero della riga serve per raggiungere la posizione all’interno del file. Non è il numero di una riga di Dataset e non viene interpretato come un parametro scientifico.

Editor Python originale con dialogo Go to line aperto mediante la scorciatoia Ctrl G
Figura 7. Il dialogo Go to line viene aperto da Ctrl+G e dispone dei pulsanti Go e Cancel.

24. Consultare il manuale con F1

Premendo F1 si apre il manuale integrato del modulo Python. La sua sezione dedicata alla navigazione descrive F10, le frecce, i tasti Alt e Escape; la finestra include anche una scheda Interactive Tutorial.

Il manuale è un riferimento utile, ma occorre verificare che i passaggi corrispondano alla GUI realmente installata. I capitoli seguenti illustreranno soltanto percorsi eseguiti e controllati nella versione corrente.

Manuale integrato Python Script Workspace scorrevole nella sezione delle scorciatoie di menu
Figura 8. Il manuale F1 integrato descrive F10, le frecce, Alt+lettera ed Escape per i menu.

25. Tabella delle principali scorciatoie

TastiFunzione mostrata o verificata
F10Porta il focus alla barra dei menu
Frecce sinistra / destraSpostano il focus fra menu adiacenti
Spazio / Freccia giùAprono il menu che possiede il focus
EscapeChiude un menu senza invocare una voce; dal campo Find torna al codice
Alt+F / E / P / V / R / HRaggiungono File / Edit / Project / View / Run / Help
Ctrl+FPorta il focus a Find
F3 / Shift+F3Cercano avanti / indietro
Ctrl+GApre Go to line
F1Apre il manuale del Viewer
Ctrl+SSave, come indicato nel menu File
Ctrl+Shift+SSave All, come indicato nel menu File
Ctrl+WClose tab, come indicato nel menu File

Le prime nove righe riguardano navigazione e accesso ai controlli. Per Save, Save All e Close tab il menu indica esplicitamente le scorciatoie, ma le operazioni con effetti sulla persistenza saranno trattate insieme alla gestione degli Script.

26. Leggere le voci disabilitate

Stato della GUIEsempioCome interpretarlo
Bozza senza identità registrataDelete e Copy ID disabilitatiNon esiste ancora uno Script registrato
Nessuna modifica da annullareUndo e Redo disabilitatiManca una modifica nella cronologia locale
Nessun Project Canvas attivoOperazioni sui file del progetto disabilitateOccorre prima aprire un progetto appropriato
Nessuna scheda Notes attivaNote format e Note images disabilitatiI comandi riguardano un tipo di documento diverso

Questi esempi spiegano il comportamento dello stato iniziale. Non sono regole assolute valide per tutte le schede e per tutti i progetti.

27. Una routine di navigazione sicura

Per familiarizzare con l’interfaccia, aprire il Viewer, utilizzare F10 e le frecce per esaminare i menu, quindi Escape per tornare al sorgente. Provare Ctrl+F e Ctrl+G con il codice iniziale non modificato, e consultare il manuale tramite F1.

Quando l’obiettivo è scrivere Python, ridurre i pannelli secondari attraverso View → Focus source / restore panes. Mantenere sempre distinto il semplice spostamento del focus dall’attivazione di un comando che salva, registra, esegue o elimina.

28. Conclusione

I sei menu di Python Script Workspace danno accesso a funzioni differenti ma coordinate. Le scorciatoie permettono di muoversi fra menu, cercare nel sorgente e consultare la documentazione senza lasciare l’editor.

Prima di utilizzare Save, Runner o Debugger, bisogna comprendere Scope, Script ID, Name, Version e metadati dello Script. Il capitolo successivo sarà dedicato proprio a questi elementi e alla differenza fra bozza e identità registrata.