Octave avanzato A05 — Errori del Bridge e recupero controllato

di Giux GX-TXT, octave-it, scripts-it 3 min di lettura

Corso avanzato di GNU Octave con GX-TXT · Modulo 01

Un’API inesistente, un’operazione non registrata e un errore del provider richiedono risposte diverse. Octave permette di intercettare un errore, ma la scelta di continuare o interrompere l’analisi dipende dal suo significato.

Obiettivi e prerequisiti

Dopo il corso base e le lezioni precedenti, sappiamo controllare le dipendenze. Ora esaminiamo l’identificativo e il messaggio di un errore reale, provocato intenzionalmente senza modificare dati. La prova usa GX-TXT dev112-P011-bis e GNU Octave 9.4.0.

Un’operazione volutamente inesistente

Importa errori_bridge.m, salvalo nella Session ed eseguilo con il Runner.

Script Octave che intercetta un errore di operazione sconosciuta.
Script Octave che intercetta un errore di operazione sconosciuta.
% Advanced Octave course A05: handle API discovery and call errors.
% SPDX-License-Identifier: GPL-3.0-or-later
api = 'CANONICAL_DATASET_API_v2';
operation = 'operazione_inesistente';
fprintf('Known API: %d\n', gxtxt_api_has(api));
fprintf('Requested operation available: %d\n', gxtxt_api_has_operation(api, operation));
try
  gxtxt_api_call(api, operation, {});
  error('Unexpected success in the demonstration.');
catch err
  fprintf('Caught error identifier: %s\n', err.identifier);
  fprintf('Caught error message: %s\n', err.message);
end_try_catch
fprintf('Demonstration completed; no data were changed.\n');

L’esempio controlla prima l’esistenza dell’API e poi quella dell’operazione inventata. La chiamata successiva è intenzionalmente errata per mostrare cosa restituisce il Bridge: catch err riceve l’errore e ne stampa identificativo e messaggio.

Output effettivo: API disponibile, operazione assente ed errore UnknownOperation intercettato.
Output effettivo: API disponibile, operazione assente ed errore UnknownOperation intercettato.

Nella prova l’API è presente (1), l’operazione non lo è (0) e la chiamata segnala GXTXT:ScriptBridge:UnknownOperation. Il Job completa la dimostrazione perché l’errore previsto è stato intercettato; questo non significa che la chiamata sia riuscita.

Gestire gli errori senza nasconderli

In una pipeline reale è preferibile controllare i requisiti prima della chiamata e fermarsi se manca un’operazione necessaria. Il Bridge distingue anche altri casi documentati, come API sconosciuta, argomenti non validi, errore di trasporto e fallimento del provider. Conserva identificativo e messaggio, e riporta il contesto necessario a capire quale operazione è fallita.

Questo piccolo catch stampa qualunque errore, incluso quello sollevato dal ramo «successo inatteso»: è adeguato a un esperimento che mostra la diagnostica, ma non costituisce un gestore selettivo per un’analisi. Nel codice di produzione verifica l’identificativo atteso e rilancia gli errori inattesi con rethrow(err). Non sostituire un errore con un array vuoto o con zero: sarebbe impossibile distinguere un guasto da un risultato valido.

Esercizio

  1. Perché il Job mostrato può essere completato anche se la chiamata solleva un errore?
  2. Come distingueresti un’operazione non registrata da un risultato numerico vuoto?
  3. Che cosa dovrebbe fare una pipeline se un’operazione indispensabile non è disponibile?

Soluzione ragionata

  1. Perché il blocco catch intercetta l’errore e la dimostrazione termina dopo averlo stampato.
  2. Nel primo caso il Bridge produce un errore con identificativo; nel secondo occorre interpretare un risultato effettivamente restituito secondo il contratto.
  3. Interrompersi e indicare quale dipendenza manca, senza presentare come completa un’analisi parziale.

Scarica gli script del Modulo 01 (ZIP)

#GX-TXT #Octave #Script Runner

Altre tappe del progetto

Lascia un commento

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