GX-TXT Python Script Workspace: creare e aprire progetti Python

Python Script Workspace consente di creare un Python Script Project direttamente dall’editor. Ogni progetto possiede un’identità registrata, un file di ingresso (entrypoint) e può in seguito contenere più sorgenti. Le operazioni New Project, Open Project e Manage Project sono disponibili dal menu Project della stessa finestra.

In questa guida creeremo un progetto semplice con un solo file main.py, esamineremo nome, Stable ID, Scope, Description e revisione iniziale, quindi lo apriremo nuovamente attraverso l’elenco dei progetti. La gestione avanzata di più file appartiene al capitolo successivo.

1. Perché utilizzare uno Script Project

Per un programma breve, un solo Script Python può essere sufficiente. Un Project diventa utile quando si vuole organizzare il codice intorno a un entrypoint e aggiungere successivamente moduli ausiliari.

Il progetto è una vera identità del Registry GX-TXT. Non è soltanto una directory visualizzata e non autorizza automaticamente un’esecuzione scientifica.

2. Distinguere New Script e New Project

File → New Script crea una nuova sorgente indipendente. Project → New Project… avvia invece un procedimento per registrare una nuova identità di progetto.

Non è necessario convertire tutti gli Script in Project. La scelta dipende dalla struttura del programma che si intende sviluppare.

3. Aprire il comando New Project

Dalla finestra principale di GX-TXT, aprire Viewers → Python Scripts, quindi selezionare Project → New Project….

Il comando apre un pannello temporaneo all’interno dello stesso Python Script Workspace: non occorre avviare un altro Viewer.

4. Riconoscere il canvas Python Script Projects

Il canvas contiene le schede New project, Open / Manage projects, Import project e Public APIs, oltre al pulsante Return to code.

Pannello reale New project del Python Script Workspace con nome ID stabile Scope session e Entrypoint main.py
Figura 1. Il comando New Project apre il canvas nella stessa finestra del Workspace, con Name, Stable ID, Scope, Entrypoint e Description.

Il Source e le relative schede rimangono disponibili. Il canvas ne sostituisce temporaneamente la vista, senza cancellarne il contenuto.

5. Inserire il nome del progetto

Nel campo Name utilizzare un titolo che descriva l’obiettivo, per esempio Curva di calibrazione in Python.

Il nome può contenere spazi e serve a riconoscere il progetto nelle liste. Non coincide necessariamente con il nome del file di ingresso.

6. Scegliere uno Stable ID valido

Nel campo Stable ID inserire un identificativo stabile, ad esempio calibration_python_project.

L’ID deve iniziare con una lettera e può contenere lettere, cifre, underscore, punti o trattini. Non deve essere un percorso di filesystem: una barra non è ammessa.

7. Il linguaggio del progetto

La riga Language: Python (fixed to this Workspace) segnala che il linguaggio è già determinato.

Il canvas di Python Script Workspace crea progetti Python. Per uno Script Project Octave si utilizza il Workspace corrispondente.

8. Selezionare User oppure Session

Il campo Scope offre le opzioni user e session quando è presente una Session valida.

ScopeSignificato
userProgetto registrato nell’ambito personale, riutilizzabile in contesti differenti
sessionProgetto registrato nel contesto della Session scientifica corrente
Canvas New Project mostra scelta Scope user su formulario Python con linguaggio predefinito e file main.py
Figura 2. Nel selettore Scope è possibile scegliere user al posto di session, senza obbligare a creare un progetto in entrambi gli ambiti.

La scelta di Scope identifica il proprietario del progetto e deve essere valutata prima della creazione.

9. Quando scegliere Session

Scegliere session per un progetto collegato direttamente a un esperimento o a una raccolta di dati della Session attiva.

Per registrarlo in questo ambito serve una Session aperta. Il canvas è vincolato al contesto presente quando viene aperto: se cambia, occorre ripetere la selezione nel contesto corretto.

10. Quando scegliere User

Scegliere user quando il progetto deve appartenere al catalogo personale e non a una singola Session.

È possibile utilizzare questo ambito indipendentemente dalla presenza di una Session. Ciò non elimina l’eventuale necessità di un contesto gestito per eseguire in futuro operazioni scientifiche.

11. Che cos’è Entrypoint

Il campo Entrypoint presenta inizialmente main.py, il file che il Workspace aprirà come punto di ingresso del progetto.

Per un progetto semplice è opportuno conservare questo nome. Si tratta di un percorso relativo interno al Project, non di un percorso assoluto del computer.

12. Compilare Description

Description permette di specificare lo scopo, ad esempio Analisi di una curva di calibrazione con Python.

La descrizione è un metadato del progetto. Non è codice e non avvia un calcolo.

13. Controllare il modulo prima di creare

Rileggere Name, Stable ID, Scope, Entrypoint e Description. L’esempio mostra un progetto Session, dotato di un identificativo valido e di main.py.

Finestra originale di creazione Python Project con Scope session, Stable ID inserito ed entrypoint main.py
Figura 3. Il modulo di creazione mostra Scope session, un identificativo stabile e main.py come file d’ingresso.

La verifica di Scope e Stable ID è importante: questi due valori determinano dove viene registrato il progetto e come lo si ritroverà.

14. Premere Create project

Con il modulo compilato, premere Create project. GX-TXT convalida i valori e, se non esiste già la stessa identità nell’ambito scelto, registra il nuovo progetto.

La creazione non equivale all’esecuzione di uno Script. Non vengono prodotti automaticamente Job o Dataset.

15. Il file main.py generato

Dopo la creazione, l’editor apre main.py. Il codice iniziale è un semplice commento:

# Project entrypoint
Workspace Python con struttura progetto a sinistra, file main.py in editor nero e codice commento Project entrypoint
Figura 4. Create project salva il progetto e apre main.py nell’editor High Contrast Dark, conservando la precedente scheda.

Il file è pronto per essere sviluppato. Il commento non esegue operazioni scientifiche.

16. La revisione iniziale del progetto

Il Project registrato possiede una prima revisione r1 e un’impronta SHA-256 associata al contenuto salvato.

Queste informazioni documentano l’identità del sorgente, non la riuscita di un’elaborazione. Le revisioni successive richiedono esplicite operazioni di salvataggio.

17. Le altre schede restano indipendenti

Quando il progetto viene aperto, le schede degli Script già presenti non vengono convertite automaticamente in file del nuovo Project.

È possibile passare fra documenti con identità diverse. Una modifica a un altro Script non deve essere confusa con il salvataggio del progetto corrente.

18. Il navigatore dei file del Project

Nel Workspace, il progetto aperto presenta una vista dei propri file e identifica il file di ingresso principale.

Questa vista non è la stessa cosa di Script Explorer / Registered scripts: il navigatore del Project riguarda i suoi sorgenti, mentre Explorer presenta le identità registrate.

19. Tornare al codice

Quando il canvas è aperto, fare clic su Return to code per ripristinare la precedente area Source con le sue schede.

Anche Escape, quando il canvas ha il focus, è previsto per tornare al codice. Uscire dal canvas senza completare Create project non registra una nuova identità.

20. Correggere uno Stable ID non valido

Se lo Stable ID contiene una barra o altri caratteri non consentiti, il canvas mostra Project action refused.

Interfaccia New Project originale con messaggio Project action refused per identificativo contenente barra
Figura 5. Un ID che contiene una barra viene rifiutato: la finestra conserva il modulo e il sorgente precedente.

Il modulo resta aperto per correggere il valore. Lo Script precedentemente aperto e i suoi eventuali appunti rimangono disponibili.

21. Rifiuto di un identificativo duplicato

Il tentativo di creare un secondo progetto con uno Stable ID già registrato nello stesso ambito viene respinto.

Canvas Python con progetto nuovo e messaggio Script identity already exists dopo Create project
Figura 6. Un identificativo già registrato provoca Project action refused senza sovrascrivere la revisione esistente.

L’identità esistente non viene sovrascritta. Se si vuole lavorare sul progetto registrato, occorre aprirlo dal menu Project anziché ripeterne la creazione.

22. Aprire un progetto salvato

Il comando Project → Open Project… mostra la scheda Open / Manage projects, con l’elenco dei progetti registrati nel linguaggio corrente.

Canvas Python Open Manage projects con progetto registrato selezionato, colonne Identity Entrypoint Revision e pulsanti
Figura 7. Open / Manage projects elenca nome, identità, entrypoint e revisione; Open entrypoint torna al codice.

Le colonne Name, Identity, Entrypoint e Revision consentono di scegliere consapevolmente il progetto da aprire.

23. Aprire il file di ingresso

Selezionare la riga del progetto desiderato, quindi fare clic su Open entrypoint.

Il canvas si chiude e il Workspace torna alla vista del codice, aprendo il file di ingresso associato all’identità scelta. Il comando non invia automaticamente alcun Job.

24. Open Project e Manage Project

Project → Manage Project… apre lo stesso canvas nella scheda Open / Manage projects.

Qui Refresh rilegge l’elenco, mentre Open entrypoint richiede una selezione. Se un progetto è stato aggiornato altrove, il sistema può chiedere un refresh prima dell’apertura.

25. È necessario selezionare un progetto

Premendo Open entrypoint senza selezionare alcuna riga, il canvas presenta il messaggio Select a saved project.

Finestra originale Open Manage projects con messaggio Select a saved project e nessuna modifica ai sorgenti
Figura 8. Open entrypoint richiede la selezione di un progetto salvato; senza selezione il canvas mostra un rifiuto non distruttivo.

Il rifiuto non modifica il Source. È sufficiente scegliere la riga corretta oppure usare Return to code per abbandonare la procedura.

26. Riaprire il progetto dopo aver chiuso il Viewer

Un progetto registrato rimane disponibile dopo la chiusura e la successiva apertura di Python Script Workspace.

Elenco originale dei Python Script Projects in session con progetto salvato e entrypoint main.py dopo riapertura
Figura 9. Dopo la riapertura del Viewer, il progetto Session rimane disponibile nella scheda Open / Manage projects.

Ritornando su Project → Open Project… si ritrovano identità, file di ingresso e revisione salvata. La riapertura non produce da sola una nuova revisione.

27. Passare a un Project con più file

Il progetto semplice contiene inizialmente solo main.py. In seguito può essere esteso con altri file sorgente, moduli ausiliari e package Python.

Aggiungere, rinominare e organizzare i file richiede controlli su percorsi relativi, import, entrypoint e salvataggio coerente. Queste operazioni saranno affrontate nella guida successiva ai progetti Python multisorgente.

Project → New Project… permette di registrare un nuovo Python Script Project con Name, Stable ID, Scope, Entrypoint e Description. Il progetto creato apre il suo file iniziale nel normale editor, senza eseguire un Job.

Open Project… e Manage Project… consentono di ritrovare progetti salvati. Gli identificativi invalidi o duplicati vengono rifiutati senza sovrascrivere i documenti esistenti. Return to code ripristina l’area di lavoro conservando i sorgenti.

Il prossimo capitolo approfondirà i file ausiliari, la struttura dei package, gli import tra sorgenti, l’entrypoint e Save All.