Eccezioni, logging e qualità del codice
Corso Python scientifico in GX-TXT · Modulo 9 · Lezione 52
Un programma affidabile segnala chiaramente gli input non validi e non trasforma un errore di lettura in un risultato apparentemente corretto. In questa lezione separiamo un calcolo riutilizzabile dalla gestione dei messaggi.
Obiettivi
- Validare un input prima della chiamata all’API.
- Usare
loggingper messaggi di livello informativo. - Rilanciare gli errori del Bridge dopo averli documentati.
- Usare un’asserzione per un controllo didattico.
Esecuzione
Nella Sessione corso_python, importa eccezioni_logging.py, salvalo ed
eseguilo nel Runner.

import logging
import numpy as np
from gxtxt import gxtxt_api_call, gxtxt_api_require, GXTXTBridgeError
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
log = logging.getLogger("corso")
def media_segnale(dataset_id):
if not dataset_id.strip():
raise ValueError("L'ID del Dataset non puo essere vuoto")
dati = gxtxt_api_call("CANONICAL_DATASET_API_v2", "read_range", [dataset_id, ["segnale"], 0, 4])
valori = np.asarray(dati["segnale"]["values"]).reshape(-1)
if valori.size == 0:
raise ValueError("Nessun campione disponibile")
return float(np.mean(valori))
gxtxt_api_require("CANONICAL_DATASET_API_v2@2")
try:
risultato = media_segnale("corso_python_serie_sintetica")
log.info("Media sintetica: %.3f mV", risultato)
except GXTXTBridgeError:
log.exception("Lettura Dataset non riuscita")
raise
try:
media_segnale("")
except ValueError as errore:
print("Controllo input previsto:", errore)
assert abs(risultato - 1.4) < 1e-12
print("Verifica numerica superata")
media_segnale controlla l’ID, legge i quattro valori
sintetici e restituisce la media. Un ID vuoto causa un
ValueError prima della chiamata. Un eventuale
GXTXTBridgeError durante la lettura viene registrato con il
contesto e rilanciato: non inventiamo una media sostitutiva. Il secondo
blocco prova intenzionalmente l’input vuoto e cattura solo l’eccezione
attesa.

Il modulo logging scrive normalmente su stderr; nel
dettaglio del Job scegli Program stderr per vedere il
messaggio informativo della media 1,400 mV.

assert verifica qui una proprietà dell’esempio, ma non
dovrebbe sostituire la validazione di input indispensabile: Python può
disabilitare le asserzioni in modalità ottimizzata. Per errori che il
chiamante deve gestire, usa eccezioni esplicite. Evita anche un
except Exception che nasconda qualunque problema e
restituisca un numero plausibile.
Esercizio
- Quale eccezione produce un ID vuoto?
- Che cosa accade a un errore di lettura del Bridge?
- Perché il messaggio INFO può essere visibile in stderr anziché in stdout?
Soluzione ragionata
ValueError.- Viene registrato e rilanciato, quindi non diventa un risultato numerico inventato.
- Il gestore predefinito di
loggingusa normalmente stderr; il Job mostra separatamente i due flussi.
Nella prossima lezione esploreremo il debugger del progetto e i test.