Creare, salvare e proteggere le modifiche a uno script

Octave Script Workspace permette di preparare sorgenti GNU Octave, salvarli nel registro GX-TXT e conservare versioni distinte dello stesso lavoro. La procedura corretta inizia con una nuova scheda e termina con il controllo dell’identità registrata, evitando la perdita di modifiche non salvate.

Le schermate si riferiscono a GX-TXT DEV112 con patch P005, modulo Octave Script Workspace 1.8.3. I comandi sono riportati con le etichette inglesi presenti nel programma. L’esempio usa vettori numerici semplici: il salvataggio non esegue il codice né produce Dataset.

1. Creare una nuova scheda Source

Aprire Octave Scripts dalla sezione Viewers. Se è necessario lavorare nella Session corrente, attivarla dalla finestra principale prima di creare lo script. All’interno del Workspace selezionare File → New Script oppure utilizzare Ctrl+N.

Nella scheda nuova, impostare Scope, Script ID, Name, Default arguments, Description e, quando utile, Version. Nell’esempio illustrato lo Scope è session e il nome descrittivo dello script è O04 temperature example. L’identificativo tecnico e il titolo sono campi differenti.

Octave Script Workspace con una nuova scheda Source, Scope session, Script ID, Name, Version e codice Octave prima del salvataggio.
Figura 1 — Una nuova scheda Octave prima del salvataggio, con Scope, Script ID, Name, Version e codice sorgente.

Nel Source editor si può scrivere normale codice Octave. Il seguente frammento illustra una conversione di temperatura, senza richiedere API aggiuntive:

% Synthetic temperature example.
t_C = [0, 10, 20, 30];
t_K = t_C + 273.15;

Le dichiarazioni e i calcoli qui mostrati restano soltanto testo del sorgente finché non viene richiesta una vera esecuzione.

2. Registrare il sorgente con File → Save

Selezionare File → Save, oppure Ctrl+S, per salvare la scheda corrente. Quando lo script viene registrato, GX-TXT associa il contenuto al suo Scope e Script ID: nell’esempio il riferimento completo è session:o04_main_source.

Dopo un salvataggio riuscito, la barra di stato dell’editor mostra l’identità registrata e lo stato saved. Il salvataggio del Source non equivale all’esportazione di un file esterno: per quella operazione è disponibile File → Export .m…, descritta in un capitolo dedicato.

Editor Octave Script Workspace dopo il comando File → Save, con lo script registrato e lo stato saved nella barra inferiore.
Figura 2 — Dopo File → Save, lo script possiede un riferimento registrato e la barra di stato indica saved.

Ogni salvataggio registrato conserva informazioni di revisione e l’impronta SHA-256 del contenuto. Questi valori sono utilizzati per verificare l’identità del codice e proteggere gli aggiornamenti; non sono campi liberamente modificabili nell’editor.

3. Riconoscere le modifiche non ancora salvate

Quando si cambia il codice o un metadato, la scheda può segnalare la presenza di modifiche tramite un asterisco e la barra di stato modified. Finché non si salva, la versione registrata resta distinta dal buffer attualmente visibile.

Se si seleziona File → Close tab mentre il sorgente contiene modifiche, compare il dialogo Unsaved source, che chiede che cosa fare prima della chiusura.

Dialogo Unsaved source di Octave Script Workspace dopo Close tab, con le opzioni Yes, No e Cancel.
Figura 3 — Dialogo autentico Unsaved source dopo Close tab, con le tre scelte Yes, No e Cancel.

Non scegliere automaticamente No quando l’intenzione è conservare il lavoro: la scelta agisce sulle modifiche presenti nella scheda.

4. Come funzionano Cancel, No e Yes

Le tre risposte del dialogo rappresentano operazioni nettamente diverse:

SceltaEffetto sulla schedaEffetto sulle modifiche
CancelLa scheda rimane aperta.Le modifiche non salvate restano disponibili per ulteriori interventi.
NoLa scheda viene chiusa.Le modifiche non salvate vengono scartate; una versione registrata precedente non viene sovrascritta.
YesViene tentato il salvataggio e, se riesce, la scheda viene chiusa.Il contenuto è registrato prima della chiusura.

Per una bozza nuova, Yes permette di salvarla direttamente durante la chiusura, purché i campi obbligatori e il contenuto siano validi. Nell’esempio una seconda bozza è stata registrata con un nuovo identificativo prima di essere chiusa.

Finestra Unsaved source per una nuova bozza Octave, con Yes per tentare il salvataggio prima della chiusura.
Figura 4 — Il dialogo Unsaved source visualizzato per una nuova bozza: Yes consente di salvarla prima della chiusura.

La stessa precauzione vale per File → Close, che riguarda l’intera finestra: le schede con modifiche non salvate richiedono una decisione. Cancel interrompe la chiusura e mantiene il lavoro aperto.

5. Ritrovare uno script registrato dall’Explorer

Gli script salvati possono essere individuati nel pannello Registered scripts. Quando l’Explorer è nascosto, richiamare View → Focus source / restore panes per riportarlo temporaneamente a schermo. Selezionando il record corrispondente, si apre il codice registrato nella scheda di lavoro.

Pannello Registered scripts dell'Octave Script Workspace che permette di individuare e riaprire sorgenti Octave salvati.
Figura 5 — Explorer dei sorgenti registrati: la scheda originale può essere riaperta senza aprire strumenti aggiuntivi.

Controllare sempre l’identità completa, in particolare session: oppure user:, prima di intervenire. Per scrivere normalmente, ripristinare Focus source e mantenere nascosti i pannelli non necessari.

6. Creare una copia indipendente con Save copy…

Selezionare lo script da duplicare e scegliere File → Save copy…. Il Workspace crea un nuovo record di sorgente, conservando il precedente. Quando è già presente uno script con ID o04_main_source, l’esempio mostra una copia con ID o04_main_source_2 e Name O04 temperature example (copy).

Octave Script Workspace dopo Save copy, con due script registrati aventi identificativi differenti e sorgente originale conservato.
Figura 6 — Save copy… ha creato un secondo record registrato, con nome e identificativo distinti, lasciando disponibile l’originale.

Quando si duplica un sorgente non modificato, le due copie inizialmente hanno gli stessi byte e quindi possono avere lo stesso SHA-256, pur essendo due record differenti. Se si modifica successivamente una copia, non si sta modificando automaticamente l’altra.

La funzione Save copy… non deve essere confusa con Save All: la prima crea una nuova identità, mentre il secondo comando riguarda il salvataggio di più sorgenti aperti ed è trattato con i progetti.

7. Protezione da revisioni obsolete

Uno script registrato può cambiare dopo che una scheda lo ha caricato, per esempio perché è stato aggiornato in un’altra finestra. Se si tenta di salvare modifiche basate su una revisione non più attuale, il Workspace può rifiutare l’operazione per evitare la sovrascrittura del record più recente.

Nella situazione illustrata compare il messaggio Script metadata revision changed; review and retry all’interno del dialogo Save failed.

Dialogo Save failed di GX-TXT Octave con il messaggio Script metadata revision changed; review and retry.
Figura 7 — Save failed: il salvataggio viene rifiutato quando la revisione registrata non corrisponde più a quella caricata nell’editor.

Il rifiuto è una protezione: non significa che la versione più recente sia andata perduta. Prima di ritentare, confrontare il codice visibile con la versione registrata, verificare l’identità dello script e decidere consapevolmente come conservare le modifiche locali. Non sovrascrivere alla cieca un sorgente che nel frattempo è stato aggiornato.

8. Chiudere la finestra senza perdere il lavoro

File → Close tab riguarda la scheda attiva; File → Close riguarda la finestra del Workspace. Se una scheda conserva modifiche, viene chiesta una conferma anche durante la chiusura dell’intera finestra.

Dialogo Unsaved source durante la chiusura della finestra Octave Script Workspace, con Cancel per mantenere aperto il sorgente modificato.
Figura 8 — Protezione Unsaved source durante la chiusura della finestra del Workspace: Cancel lascia aperti l’editor e il sorgente modificato.

Prima di terminare, è utile verificare che la barra di stato indichi saved per i sorgenti che si intende conservare, controllare Scope e Script ID, e ripristinare la vista essenziale Focus source.

Octave Script Workspace con editor Source focalizzato dopo le operazioni di salvataggio e chiusura delle schede.
Figura 9 — Workspace nella disposizione Source focalizzata dopo le operazioni di salvataggio e chiusura.

Il risultato atteso è un insieme di sorgenti registrati riconoscibili, senza modifiche dimenticate in schede non salvate. Le operazioni presentate in questo capitolo riguardano soltanto il ciclo di vita del codice: la preparazione del Runner, l’esecuzione e la pubblicazione dei risultati sono attività successive e distinte.