GX-TXT Python Script Workspace: User, Session e sorgenti storici

Una Session GX-TXT identifica il contesto scientifico in cui lavorano gli Script, i Dataset e i Job. L’editor Python distingue i sorgenti del Registro User, disponibili come risorse personali, dai sorgenti del Registro Session, appartenenti invece alla Session aperta. I Job già eseguiti conservano inoltre una propria copia immutabile del codice. Comprendere queste tre identità permette di salvare correttamente, riaprire il lavoro senza confondere le revisioni e recuperare il codice di una precedente elaborazione.

1. Il sorgente non coincide con il Job

Lo Script è il programma registrato; il Job è una singola esecuzione supervisionata di una sua revisione. Salvare uno Script non lo esegue. Se si modifica successivamente il codice registrato, un Job storico continua a riferirsi allo snapshot che fu realmente eseguito. GX-TXT presenta pertanto tre livelli di informazione: sorgenti User, sorgenti Session e sorgenti storici delle esecuzioni.

2. Che cosa significa User

Lo scope User indica un sorgente registrato nel profilo dell’utente GX-TXT. Il programma non è associato automaticamente alla Session scientifica correntemente aperta. Se si passa a un’altra Session, un sorgente User registrato può rimanere disponibile nell’Explorer dell’editor. La sua presenza non equivale però alla pubblicazione di Dataset né a un Job già eseguito.

3. Che cosa significa Session

Lo scope Session indica un sorgente registrato nel contesto della Session attiva. L’editor può mostrarlo e ricaricarlo finché quella Session è aperta e l’identità di proprietario è valida. In un’altra Session lo stesso sorgente non compare come risorsa locale di quella Session. Per i normali esercizi con dati scientifici, conviene scegliere esplicitamente lo scope Session desiderato prima di salvare.

4. Creare uno Script personale

Nel Python Script Workspace usare File → New Script. Nelle proprietà del documento scegliere Scope: user e inserire un nome, una versione e il codice. Nel semplice esempio seguente non viene creato alcun Dataset e non viene avviato Python:

# Synthetic example: no Job or Dataset is created.
SOURCE_SCOPE = "USER"
print(f"Source scope: {SOURCE_SCOPE}")
Editor GX-TXT Python High Contrast Dark con sorgente sintetico USER e scheda originale non ancora salvata.
Figura 1. Uno Script di esempio nel Registro User: il codice è indipendente dalla Session scientifica.

5. Salvare nel Registro User

Scegliere File → Save. GX-TXT crea il record del sorgente nel Registro User e ne associa una revisione iniziale e uno SHA-256. La scheda passa da bozza non salvata a sorgente registrato. Il salvataggio non crea un Job: per eseguire il codice in un esperimento occorre una richiesta esplicita e una Session appropriata.

6. Creare un sorgente della Session con lo stesso nome

Con la Session desiderata aperta, scegliere nuovamente File → New Script. Questa volta mantenere Scope: session e utilizzare lo stesso nome breve del documento precedente. Il nuovo codice può essere differente:

# This script belongs to the currently opened Session.
SOURCE_SCOPE = "SESSION"
print(f"Source scope: {SOURCE_SCOPE}")

Sono due sorgenti indipendenti: il nome breve non costituisce da solo un’identità univoca.

Editor Python GX-TXT con sorgente sintetico SESSION e una scheda diversa dal sorgente User.
Figura 2. Uno Script distinto, con lo stesso nome breve, può appartenere alla Session corrente.

7. Salvare il sorgente Session

Premere File → Save anche per il secondo Script. Il Registry registra una nuova revisione iniziale nello scope Session, senza modificare il sorgente User omonimo. Se i codici differiscono, differiscono anche gli SHA-256. Un’operazione di salvataggio deve sempre essere attribuita alla scheda attiva e al suo proprietario.

8. Identificativi qualificati

Gli identificativi completi hanno una parte che indica lo scope:

EsempioSignificato
user:scope_demoScript personale nel Registro User
session:scope_demoScript appartenente alla Session aperta
snapshot:…Copia storica immutabile collegata a un Job

La parte dopo i due punti può essere uguale per User e Session. Per distinguere sorgenti e Job bisogna utilizzare l’identificativo qualificato completo, la revisione e lo SHA-256, non soltanto il titolo mostrato nella tabella.

9. Riaprire il sorgente User dall’Explorer

Selezionare la voce User nell’Explorer del Python Script Workspace. GX-TXT mostra il codice salvato nel relativo tab e ne ripristina revisione e SHA-256. Anche se esiste uno Script della Session con lo stesso nome breve, il sorgente User rimane quello registrato nel suo proprietario.

Python Script Workspace con voce User selezionata e SOURCE_SCOPE uguale a USER.
Figura 3. Selezionando la voce User si ricarica dal Registry il suo codice salvato.

10. Riaprire il sorgente Session

Selezionare invece la voce Session. La GUI carica il codice registrato nella Session corrente. In questo esempio la costante visualizzata cambia da USER a SESSION e l’identità di origine è distinta, mentre entrambe le schede conservano la propria versione iniziale.

Python Script Workspace con voce Session selezionata e SOURCE_SCOPE uguale a SESSION.
Figura 4. La voce Session ricarica un altro sorgente e un diverso SHA-256, senza sovrapporsi alla voce User.

11. Le schede mantengono buffer separati

La barra delle schede consente di lavorare su più sorgenti, anche quando hanno lo stesso nome di file, ad esempio source.py. Il titolo breve di una scheda non deve essere usato come prova dell’identità di proprietario. Durante il lavoro è bene controllare sia l’identificativo dello Script sia l’eventuale indicatore di modifica non salvata.

12. Versione, revisione e SHA-256

La Version è il numero semantico scelto per il programma, ad esempio 1.0.0. La revision è la revisione del record registrato. Lo SHA-256 identifica esattamente il contenuto della sorgente registrata. Questi tre valori non sono equivalenti: due revisioni possono appartenere alla stessa versione semantica; una copia storica mantiene lo SHA-256 del codice eseguito anche quando il Registry corrente avanza.

13. Quando una scheda diventa dirty

Una modifica al testo rende il buffer modified/dirty. Nell’esempio è stata aggiunta soltanto un’annotazione temporanea, senza eseguire il programma o salvarlo. La GUI mostra l’indicatore di modifica, mentre il Registry conserva ancora revisione e SHA-256 precedenti. La distinzione evita di considerare pubblicato un codice che esiste soltanto nell’editor.

Sorgente Python con asterisco di modifica e annotazione temporanea non ancora salvata.
Figura 5. Una modifica non salvata resta nel buffer dell’editor e non modifica la revisione pubblicata.

14. Cambiare scheda non salva automaticamente

Passare dalla scheda Session modificata alla scheda User non ha trasferito le modifiche nel sorgente User. Tornando alla scheda Session, il buffer non salvato era ancora presente nel suo contesto originale. Il cambio di scheda non deve essere scambiato per un salvataggio: ogni scheda conserva il proprio stato.

15. Il dialogo Unsaved source

Chiudendo una scheda con modifiche non salvate, GX-TXT presenta il dialogo Unsaved source con Yes, No e Cancel. Yes richiede il salvataggio; No scarta le modifiche della scheda; Cancel mantiene la scheda aperta. Prima di scegliere, leggere il riferimento allo Script riportato nel dialogo, soprattutto quando più sorgenti sono omonimi.

Dialogo originale GX-TXT Unsaved source con pulsanti Yes, No e Cancel.
Figura 6. Il dialogo Unsaved source permette di salvare, scartare o annullare la chiusura della scheda.

16. Scartare una modifica senza alterare il Registry

Nell’esempio è stata scelta l’azione No. La scheda temporaneamente modificata è stata chiusa e la successiva riapertura ha restituito il codice della revisione registrata, con lo stesso SHA-256 iniziale. Questo comportamento è diverso da Save, che avrebbe impegnato un nuovo stato del sorgente. Quando l’intento è scartare interamente una bozza, la chiusura controllata offre un risultato esplicito.

17. Undo e confini delle modifiche

Il comando Edit → Undo lavora sulla cronologia del buffer testuale, non sulle revisioni del Registry. Una singola operazione Undo può comprendere più caratteri o un gruppo di modifiche: non bisogna supporre che annulli sempre soltanto l’ultima riga digitata. È preferibile verificare il testo effettivamente rimasto nell’editor prima di scegliere Save. Se si vuole recuperare il codice registrato senza ambiguità, chiudere la scheda scartando la bozza e riaprire il sorgente.

18. Lo snapshot di un Job è una fonte differente

Quando uno Script viene eseguito, il supervisore conserva una copia identificata del codice utilizzato. Nel frattempo lo Script corrente può essere modificato e salvato in una revisione successiva. Aprire il vecchio Job non equivale quindi ad aprire il sorgente più recente: i risultati devono essere interpretati sulla base del codice eseguito in quella specifica elaborazione.

19. Aprire il codice eseguito da un Job storico

Dal Script Jobs Manager selezionare l’esecuzione desiderata, quindi Open execution details → Open source files. Se lo snapshot è verificato, GX-TXT apre un tab storico del codice. Nella prova il Job aveva eseguito una revisione precedente dello Script e l’editor ha mostrato il relativo valore di controllo originario, non quello presente nel Registry attuale.

Editor Python con scheda sorgente storica: UNCAUGHT uguale a False nella revisione 1 conservata dal Job.
Figura 7. Dal Job storico si può aprire in sola lettura il codice della revisione effettivamente eseguita.

20. Le schede storiche sono di sola lettura

Un tab snapshot:… è read-only. Il widget di testo risulta disabilitato e anche File → Save non è disponibile per quel sorgente storico. Non è una bozza pronta per il salvataggio e non deve essere utilizzata per alterare retroattivamente un Job. La copia storica serve a verificare, confrontare e documentare; per un nuovo programma si crea o si registra esplicitamente un altro sorgente.

21. Confrontare una revisione storica con quella corrente

Nell’esempio il Job storico usa una condizione inizialmente falsa nella revisione 1, mentre il sorgente attualmente registrato presenta la stessa condizione vera nella revisione 2. Le due copie hanno SHA-256 distinti. Questo confronto dimostra perché lo stato dell’editor odierno non basta a ricostruire il comportamento di una vecchia esecuzione: serve lo snapshot verificato del Job.

22. La Session ha una propria identità di esecuzione

GX-TXT usa un’identità di Session valida per l’attuale contesto del processo. Questa Session epoch non è la versione dello Script né la revisione di un Dataset. Serve, fra l’altro, a distinguere il proprietario di un editor aperto dal contesto corrente. Il sistema deve evitare che una scheda appartenente a una Session precedente diventi scrivibile soltanto perché lo Script ha lo stesso nome o lo stesso hash.

23. Cambiare Session modifica il proprietario corrente

Quando si apre una Session differente, l’identità del contesto cambia. Un sorgente Session appartenente al contesto precedente non va considerato automaticamente scrivibile nel nuovo ambiente. Le verifiche di proprietà del sorgente impediscono che vecchie schede siano trattate come se appartenessero alla Session appena aperta. In caso di dubbio, chiudere l’editor precedente e riaprirlo nel contesto desiderato.

24. Il sorgente User continua a essere disponibile

Dopo l’apertura di un’altra Session, lo Script di scope User è stato ritrovato con lo stesso contenuto e SHA-256. In quella nuova Session, invece, non risultavano i sorgenti registrati soltanto nella Session precedente. È una differenza utile per separare strumenti personali riutilizzabili dal codice specifico di un esperimento.

Python Script Workspace in nuova Session con soltanto lo Script User del Registro globale.
Figura 8. Aprendo una nuova Session, il Registro User rimane disponibile senza mostrare i sorgenti della Session precedente.

25. Aprire o creare una nuova Session

Il flusso di lavoro ordinario passa dai comandi GX-TXT per aprire una Session esistente o crearne una nuova. Una Session nuova dispone delle proprie risorse e del proprio registro dei sorgenti; non eredita automaticamente tutti i Dataset scientifici e gli Script Session della precedente. La GUI può continuare a mostrare le risorse dello scope User, perché appartengono al profilo personale, non alla nuova Session.

26. Perché chiudere e riaprire l’editor

Dopo un cambio di Session, una finestra dell’editor rimasta aperta potrebbe contenere schede create sotto l’identità precedente. Anche quando sono visibili, queste schede non costituiscono la prova di una nuova proprietà. Chiudere correttamente il Python Script Workspace, quindi riaprirlo nella Session scelta, permette di ricostruire l’Explorer a partire dai registri pertinenti. Si tratta della riapertura dell’editor e del contesto Session, non necessariamente del riavvio dell’intera applicazione.

27. Tornare alla Session precedente

Riaprendo la Session di partenza e poi il Python Script Workspace, è stato recuperato il sorgente Session originale con identico codice, revisione e SHA-256 salvati. La nuova identità di Session del processo è invece differente da quella iniziale. Questo è il comportamento atteso: persistenza del contenuto scientifico, nuova identità operativa del contesto.

Editor Python GX-TXT riaperto con il sorgente Session ripristinato da Registry e buffer pulito.
Figura 9. Riaprendo la Session originale e l’editor, si recupera il sorgente Session dalla revisione salvata.

28. Verificare il rientro e riprendere il lavoro

Prima di continuare, controllare che la Session corrente sia quella voluta, che il sorgente nell’editor appartenga allo scope corretto e non sia modificato, che le revisioni salvate siano quelle attese e che i Job storici restino separati dal codice corrente. I Dataset canonici già pubblicati appartengono alla loro Session e non si trasferiscono implicitamente in un’altra. Completato il controllo, si può tornare al Project precedente con i propri file helper senza modificare i sorgenti storici.

Python Script Workspace con albero dei file del Project, sorgente main.py e tema High Contrast Dark.
Figura 10. Terminata l’ispezione, si torna al proprio Project Python nel tema High Contrast Dark.