Script Projects e import di moduli propri
Corso Python scientifico in GX-TXT · Modulo 9 · Lezione 49
Quando uno script cresce, separare il punto di ingresso dalle funzioni riutilizzabili aiuta a leggere e mantenere il codice. GX-TXT consente di registrare un progetto Python composto da più file e di eseguirne una revisione nel Runner.
Obiettivi
- Creare un progetto nello Script Workspace.
- Distinguere entrypoint e modulo ausiliario.
- Importare una funzione appartenente allo stesso progetto.
- Salvare i file ed eseguire la revisione registrata.
Crea il progetto
Apri il Python Script Workspace nella Sessione
corso_python. Scegli Project → New
Project, assegna un nome e un ID stabile, mantieni lo scope
Session e l’entrypoint main.py, quindi crea il progetto.
Nel progetto aggiungi calcoli.py con Project → New
file.

Inserisci in calcoli.py:
def media(valori):
if not valori:
raise ValueError("La lista non puo essere vuota")
return sum(valori) / len(valori)
Inserisci in main.py:
from calcoli import media
valori = [1.2, 1.5, 1.3, 1.6]
print("Media sintetica (mV):", media(valori))
from calcoli import media rende disponibile
nell’entrypoint la funzione definita nell’altro file del progetto. La
funzione rifiuta una lista vuota e altrimenti divide somma per numero di
elementi. I quattro valori sono sintetici e sono espressi in mV.
Salva tutti i file del progetto, apri Run → Open Script Runner e avvia il Job. Se l’editor segnala modifiche non salvate, salvale prima di aprire il Runner: così la revisione eseguita include entrambi i file aggiornati.

Il risultato è 1,4 mV. Il Runner usa la revisione del
progetto registrata, inclusi i file che la compongono. Non modificare
sys.path per caricare file esterni e non fare affidamento
su file locali non inclusi nel progetto. Per organizzazioni più ampie, i
package Python possono usare __init__.py e import coerenti
con la struttura registrata; verifica sempre che tutti i file necessari
siano inclusi.
Esercizio
- Quale file è l’entrypoint e quale contiene la funzione riutilizzabile?
- Quale errore viene sollevato per una lista vuota?
- Perché salvare entrambi i file prima di aprire il Runner?
Soluzione ragionata
main.pyè l’entrypoint;calcoli.pydefiniscemedia.ValueError, con un messaggio che spiega il problema.- Il Job deve eseguire una revisione coerente dei file registrati, non una combinazione di modifiche ancora in editor.
Nella prossima lezione useremo tipi e dataclass per descrivere un riferimento a Dataset.