Avanzamento, cancellazione e limiti dei Job
Corso Python scientifico in GX-TXT · Modulo 7 · Lezione 41
Un’operazione lunga dovrebbe comunicare ciò che sta facendo senza bloccare inutilmente l’interfaccia. In questa lezione elaboriamo una piccola serie sintetica in blocchi e pubblichiamo eventi di avanzamento proporzionati al lavoro effettivo.
Obiettivi
- Rappresentare avanzamento determinato con lavoro svolto e totale.
- Distinguere avvio, lavoro, completamento ed errore.
- Consultare la politica delle risorse parallele.
- Capire che richiesta di cancellazione e cancellazione conclusa sono eventi distinti.
Esegui lo script
Nella Sessione corso_python, importa avanzamento.py, salvalo e avvialo con
Run → Open Script Runner → Run Job.

import numpy as np
from gxtxt import gxtxt_api_call, gxtxt_api_require
for api in ("PROGRESS_API_v1@1", "CANONICAL_DATASET_API_v2@2", "PARALLEL_EXECUTION_API_v1@1"):
gxtxt_api_require(api)
progress = "PROGRESS_API_v1"
def segnala(stato, corrente, totale):
evento = {"state": stato, "mode": "determinate", "stage": "lettura", "message": "Lettura dati sintetici", "current": corrente, "total": totale}
return gxtxt_api_call(progress, "publish", [evento])
segnala("start", 0, 4)
somma = 0.0
try:
for inizio in (0, 2):
blocco = gxtxt_api_call("CANONICAL_DATASET_API_v2", "read_range", ["corso_python_serie_sintetica", ["segnale"], inizio, 2])
somma += float(np.sum(blocco["segnale"]["values"]))
segnala("running", inizio + 2, 4)
segnala("completed", 4, 4)
except Exception:
segnala("failed", 0, 4)
raise
print("Campioni elaborati:", 4)
print("Media sintetica (mV):", somma / 4)
print("Risorse disponibili:", gxtxt_api_call("PARALLEL_EXECUTION_API_v1", "resources", []))
La funzione segnala costruisce un evento con stato,
fase, messaggio, quantità corrente e totale. Leggiamo realmente due
blocchi di due righe: dopo ciascuna lettura comunichiamo il numero
effettivo di campioni elaborati. completed viene inviato
solo dopo il lavoro; in caso di eccezione inviamo failed e
rilanciamo l’errore. Non introduciamo pause artificiali: su quattro
righe l’avanzamento può essere troppo rapido per essere osservato in
tempo reale.

Il risultato è la media dei quattro valori sintetici. La risposta di
resources descrive la politica disponibile nell’ambiente
dell’esecuzione: nell’immagine il limite riportato è un worker. È
un’informazione sul contesto, non una richiesta di avviare processi
paralleli.
Stati e cancellazione
Un progresso determinato è appropriato quando current e
total rappresentano lavoro misurabile. Se il totale non è
noto, un indicatore indeterminato è più onesto di una percentuale
inventata. Aver raggiunto il totale e aver concluso con successo sono
concetti distinti: un’ultima fase può ancora fallire.
Nel gestore dei Job, la richiesta di cancellazione non equivale immediatamente alla conferma che il processo e le sue risorse siano stati chiusi. Controlla lo stato finale del Job e usa le funzioni di cancellazione disponibili per l’operazione concreta. Questo esempio breve è stato portato a termine; non mostra una cancellazione riuscita. Per lavori con risorse gestite, prevedi sempre la pulizia appropriata anche in caso di errore.
Esercizio
- Quali valori di
currentvengono comunicati durante la lettura? - Perché non inseriamo una pausa tra i due blocchi?
- Un Job arrivato a quattro campioni su quattro ha necessariamente completato ogni fase?
Soluzione ragionata
- Dopo l’avvio a 0, il lavoro comunica 2 e 4 campioni elaborati.
- Una pausa non rappresenterebbe lavoro reale; l’esempio non deve rallentare solo per rendere visibile la barra.
- No. La chiusura riuscita è uno stato separato e può dipendere da altre operazioni.
Nella prossima lezione confronteremo risultati ripetuti e salvataggio.