GX-TXT Python Script Workspace: aprire Script Runner e scegliere la revisione da eseguire

In Python Script Workspace, il comando Run → Open Script Runner… apre una finestra per controllare lo Script già registrato, la sua versione, la revisione e l’impronta SHA-256, prima di decidere se lanciare un Job. Questa guida distingue il codice attualmente visibile nell’editor dal sorgente effettivamente salvato. Le operazioni descritte preparano la revisione: nessun Job viene avviato dalla sola apertura del Runner.

1. Lo scopo dello Script Runner

Lo Script Runner è il punto in cui si esamina una versione registrata di uno Script Python insieme alle eventuali impostazioni di esecuzione. L’editor, invece, serve a scrivere e modificare il sorgente. Questa distinzione è fondamentale quando il testo è stato cambiato dopo l’ultimo salvataggio: il codice visibile e la revisione registrata possono essere differenti.

2. Prerequisiti: una Session valida

Per aprire il Runner occorre lavorare nel contesto della Session scientifica prevista. Il Runner non esegue automaticamente script in un contesto di Session mancante o differente. Prima di proseguire, controllare di avere aperto la Session corretta e di poter consultare lo Script nel Python Script Workspace. Per l’esempio viene utilizzato uno Script sintetico, privo di collegamenti a strumenti.

3. Preparare uno Script Python senza eseguirlo

Da File → New Script si può creare una sorgente nuova e inserirvi del codice didattico. La sola scrittura o apertura dell’editor non produce né una registrazione scientifica del risultato né un Job. All’inizio il nuovo documento è una bozza, non ancora identificata come revisione registrata.

Python Script Workspace con sorgente Python sintetico nuovo, non ancora registrato.
Figura 1. La creazione di un nuovo sorgente Python avviene prima della sua registrazione.

4. Un codice illustrativo facile da leggere

L’esempio seguente calcola la media aritmetica di misure sintetiche. È presentato soltanto per rendere comprensibile il passaggio dall’editor al Runner: non è necessario lanciarlo per seguire la guida.

# Synthetic example: opening Runner does not execute this code.
def temperature_mean_celsius(values):
    """Return the arithmetic mean of the supplied values."""
    return sum(values) / len(values)

measurements = (18.0, 20.0, 22.0, 21.0, 19.0)

Prima di un’esecuzione effettiva, anche un esempio come questo richiede normali controlli sui dati in ingresso, come l’eventuale lista vuota.

5. Scope, Script ID, Name e Version

L’editor dispone dei campi Scope, Script ID, Name e Version. Lo Scope distingue il contesto di appartenenza, mentre Script ID è l’identificativo registrato. Name è leggibile dall’utente; Version è una versione semantica, per esempio 1.0.0. Identificativo, versione e revisione non sono sinonimi: la revisione cambia quando un salvataggio modifica il record registrato.

6. Registrare la prima revisione con Save

Dopo avere scelto un identificativo valido e lo Scope appropriato, selezionare File → Save. L’editor registra il documento e mostra il suo stato salvato. Nel caso illustrato si ottiene una prima revisione con codice sintetico. Il salvataggio registra il sorgente: non è una richiesta al Runner e non avvia alcun Job.

Python Script Workspace con lo script sintetico salvato nella prima revisione.
Figura 2. File Save registra una revisione dello Script conservando il codice e la sua identità.

7. Aprire il Runner dall’editor

Con lo Script salvato e selezionato, scegliere Run → Open Script Runner…. Si apre la finestra dedicata, senza passare attraverso altri Viewer. È importante usare lo Script già aperto per conservare il collegamento con la sua identità registrata, anziché cercare procedure alternative non verificate.

8. Leggere la testata di identità

In alto il Runner riporta Name, linguaggio Python, riferimento dello Script, Version, revision e SHA-256. Il riferimento identifica il record registrato; il valore SHA-256 distingue il contenuto della revisione. Controllare sempre questi campi prima di considerare una futura esecuzione. Due revisioni con stesso Name possono avere sorgenti differenti.

Finestra Script Runner aperta sulla revisione salvata dello script Python, con Validate review, Run Job e Close.
Figura 3. Run → Open Script Runner mostra la revisione salvata, lo SHA-256 e i pulsanti di revisione.

9. Apertura del Runner e avvio del Job sono distinti

L’apertura della finestra presenta i dati da rivedere. Run Job è un comando separato e richiede una decisione esplicita. La testata, i parametri e la scelta degli input sono disponibili per la consultazione senza eseguire Python. In questo capitolo non viene premuto Run Job e non si mostrano risultati scientifici inventati.

10. I pulsanti nella parte inferiore

La finestra mostra Validate review, Run Job, Help e Close. Validate review è destinato al controllo delle impostazioni; Run Job è l’azione che presenta l’invocazione al sistema di esecuzione; Close chiude la finestra di revisione. Non confondere l’esistenza di un pulsante con l’avvenuta esecuzione della relativa funzione.

11. Parametri e impostazioni visibili

Il Runner contiene una sezione Invocation parameters, con eventuali parametri tipizzati dichiarati nello Script, e una sezione Parameter Dataset. Nell’esempio, il documento non dichiara parametri tipizzati, perciò compare la relativa indicazione. L’aggiunta, la validazione e il salvataggio di parametri sono oggetto di procedure distinte: qui si osserva soltanto la disposizione iniziale.

12. Input Dataset e output request

La sezione Inputs and output permette di accedere alla configurazione degli input e a una richiesta opzionale di output. Ogni input possiede informazioni sul Dataset e sul relativo namespace. Queste voci non significano che una sorgente esterna sia già stata caricata o che un Dataset di output sia stato pubblicato. La gestione degli input sarà trattata separatamente.

13. Chiudere una revisione senza eseguirla

Premendo Close il Runner scompare e si torna al Python Script Workspace. Quando nessun Job è stato avviato, non si deve eseguire alcuna operazione di arresto. La semplice chiusura del Runner non elimina lo Script registrato e non cambia il suo sorgente.

14. Che cosa significa un buffer dirty

Quando si modifica il testo di uno Script già salvato, l’editor segnala che la sorgente corrente è modified. Si parla di buffer dirty: esiste una differenza tra il documento nella finestra e la revisione registrata. Questa differenza va risolta consapevolmente prima di aprire il Runner; non è opportuno supporre che il Runner eseguirà automaticamente il testo più recente.

Editor Python con modifiche non salvate evidenziate nell’etichetta della scheda.
Figura 4. Una riga aggiunta rende il buffer modificato, senza aggiornare automaticamente lo Script registrato.

15. Il dialogo Choose the Runner revision

Se si tenta Run → Open Script Runner… con modifiche non salvate, compare Choose the Runner revision. Il messaggio propone tre alternative, Yes, No e Cancel. Indica espressamente che aprire il Runner non invia un Job. È una scelta di revisione, non una conferma di esecuzione.

Dialogo Choose the Runner revision con scelte Yes, No, Cancel per la sorgente modificata.
Figura 5. Il dialogo originale permette di scegliere Yes, No oppure Cancel prima di aprire il Runner.

16. Cancel: rimanere nell’editor

Selezionando Cancel, il Runner non si apre e la bozza non viene scartata. L’editor conserva il testo modificato, che può essere corretto, salvato o esportato in seguito. Questa è la scelta più prudente quando non si è ancora deciso quale revisione utilizzare.

17. No: aprire l’ultima revisione salvata

Selezionando No, il Runner si apre sulla revisione già registrata, mentre le modifiche non salvate rimangono nell’editor. È quindi possibile avere simultaneamente un Runner riferito a una revisione precedente e una scheda sorgente contrassegnata come modificata. Prima di un futuro Job, leggere la revisione e lo SHA-256 nella testata del Runner.

Runner che mantiene la prima revisione registrata mentre la sorgente nell’editor è modificata.
Figura 6. Con No, il Runner mostra ancora la versione salvata mentre l’editor mantiene la bozza modificata.

18. Il significato operativo di No

La scelta No non significa scartare la bozza e non significa eseguire immediatamente lo Script. Consente soltanto di consultare i parametri della versione salvata. Chiudendo il Runner si torna alla bozza ancora modificata; se si desidera utilizzarla in seguito sarà necessario salvarla esplicitamente.

19. Yes: salvare e aprire la revisione aggiornata

Con Yes, l’editor tenta prima un salvataggio regolare della sorgente. Se il salvataggio riesce, il Runner si apre sulla revisione aggiornata. Nell’esempio il passaggio dalla prima alla seconda revisione comporta uno SHA-256 diverso. La presenza della nuova revisione nel Runner conferma il salvataggio, non l’esecuzione dello Script.

20. Verificare revision e SHA-256 dopo Yes

Dopo Yes, controllare nuovamente la testata. Il Runner deve mostrare la versione registrata aggiornata, con la sua revisione e il suo SHA-256. Se l’editor ha cambiamenti concorrenti o non può salvarli, non bisogna aggirare il rifiuto: riesaminare lo Script nel contesto corretto. Nel flusso illustrato l’editor torna allo stato saved.

Script Runner aperto dopo Save sulla nuova revisione 2 dello Script Python.
Figura 7. Con Yes, il salvataggio crea una nuova revisione e il Runner ne mostra il nuovo SHA-256.

21. Version e revision: due informazioni diverse

Version è il numero di versione definito per lo Script, per esempio 1.0.0. revision è la progressione del record salvato, per esempio dalla revisione 1 alla 2. Modificare il sorgente e salvarlo può cambiare la revisione e l’hash senza richiedere un cambiamento del numero di versione semantica. La testata consente di verificare entrambe.

22. Perché lo SHA-256 è importante

Lo SHA-256 identifica il contenuto della revisione registrata e aiuta a distinguere due stati del medesimo Script. Non è un indicatore di accuratezza scientifica, di assenza di errori o di qualità del calcolo. Serve alla tracciabilità del sorgente selezionato per la revisione, ma non sostituisce la lettura del codice e il controllo degli ingressi.

23. Script nuovo senza registrazione

Un documento appena creato, privo di riferimento di Registry, non è ancora disponibile come Script salvato per il Runner. Tentando di aprire la finestra compare un messaggio che richiede il salvataggio o la registrazione esplicita. Non esiste un Job implicito per una bozza non registrata: tornare all’editor e completare il normale File → Save.

Avviso Open Script Runner quando lo Script Python non è ancora stato registrato.
Figura 8. Un sorgente nuovo, privo di identità registrata, non può essere aperto nel Runner.

24. Identità della Session e protezione del contesto

Il Runner è legato alla Session corrente. Se l’editor appartiene a una Session differente o ormai chiusa, una protezione impedisce la prosecuzione e richiede di riaprire il sorgente nel contesto adatto. Questa verifica tutela l’identità della sorgente e degli eventuali Dataset, prima ancora di parlare di esecuzione.

Avviso Editor Session changed che impedisce la revisione su una Session differente.
Figura 9. L’editor rifiuta un contesto di Session differente o chiuso prima di aprire il Runner.

25. Non confondere Script, Session, Runner e Job

Lo Script è il sorgente registrato con i suoi metadati; la Session fornisce il contesto scientifico; lo Script Runner è la finestra di preparazione e revisione; un Job nasce soltanto da una richiesta di esecuzione effettiva. Sono entità differenti e conservano identità differenti. Anche una nota Markdown associata allo Script è documentazione e non un risultato di Job.

26. In caso di dubbio, rivedere prima di avviare

Un controllo pratico comprende identità e Scope dello Script, Session corrente, versione e revisione, SHA-256, parametri, eventuali input e destinazione di output. Se queste informazioni non corrispondono alle attese, chiudere il Runner senza premere Run Job e tornare al sorgente. La disponibilità di Validate review non autorizza a saltare le verifiche del documento.

27. Che cosa viene trattato nei capitoli successivi

La scelta di input Dataset e namespace, la dichiarazione dei parametri tipizzati, i Parameter Dataset, i controlli Validate review, la pubblicazione degli output e l’effettivo Run Job saranno descritti nei rispettivi capitoli. Questa separazione evita di attribuire a un’operazione di sola visualizzazione effetti che si verificano soltanto durante la successiva esecuzione.

28. Conclusione: tornare al sorgente senza Job

Al termine delle verifiche, usare Close e ritornare al sorgente Python. Conservare visibili soltanto i pannelli necessari permette di rileggere il codice in modo chiaro, mantenendo la presentazione originale High Contrast Dark. Uno Script registrato può essere consultato e revisionato nel Runner più volte senza avviare alcun Job, finché non viene impartito esplicitamente il comando di esecuzione.

Editor Python High Contrast Dark con codice del progetto originale dopo la chiusura del Runner.
Figura 10. Dopo la revisione è possibile tornare alla sorgente Python originale senza lanciare alcun Job.