Eccezioni, logging e qualità del codice

di Giux GX-TXT, python-it, scripts-it 2 min di lettura

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 logging per 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.

Script di validazione ed eccezioni nell'editor GX-TXT.
Script di validazione ed eccezioni nell'editor GX-TXT.
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.

Output del Job: input non valido rifiutato e verifica numerica superata.
Output del Job: input non valido rifiutato e verifica numerica superata.

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

Messaggio INFO effettivamente prodotto dal Job.
Messaggio INFO effettivamente prodotto dal Job.

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

  1. Quale eccezione produce un ID vuoto?
  2. Che cosa accade a un errore di lettura del Bridge?
  3. Perché il messaggio INFO può essere visibile in stderr anziché in stdout?

Soluzione ragionata

  1. ValueError.
  2. Viene registrato e rilanciato, quindi non diventa un risultato numerico inventato.
  3. Il gestore predefinito di logging usa normalmente stderr; il Job mostra separatamente i due flussi.

Nella prossima lezione esploreremo il debugger del progetto e i test.

Scarica gli script del Modulo 09 (ZIP)

#Debugging #GX-TXT #Python

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *