Octave avanzato A02 — Disponibilità dinamica e compatibilità
Corso avanzato di GNU Octave con GX-TXT · Modulo 01
Uno script scientifico può richiedere più servizi: leggere un Dataset, calcolare una regressione e preparare un grafico. In questa lezione costruiamo una tabella che controlla, nel Bridge Octave effettivamente avviato, ciascuna operazione necessaria al flusso.
Obiettivi e prerequisiti
Assumiamo le competenze del corso base
Octave e della lezione
A01. Impareremo a usare gxtxt_api_has,
gxtxt_api_has_operation, una cell array a due colonne e il
cortocircuito di && per verificare le dipendenze
senza presumere che ogni installazione abbia lo stesso inventario.
Ambiente della prova: GX-TXT dev112-P011-bis e GNU Octave 9.4.0. La tabella descrive la disponibilità durante quell’esecuzione; una release o un insieme di moduli diverso può restituire altri valori.
Esempio: una matrice di dipendenze
Importa compatibilita.m nell’Octave Script Workspace, salva lo script nella Session e avvialo da Run → Open Script Runner → Run Job.
% Advanced Octave course A02: verify a workflow's public operations.
% SPDX-License-Identifier: GPL-3.0-or-later
requirements = {'CANONICAL_DATASET_API_v2', 'list'; ...
'CANONICAL_DATASET_API_v2', 'read_range'; ...
'NUMERIC_API_v1', 'linear_regression'; ...
'PLOT_DATASET_API_v4', 'validate_spec'};
ready = true;
fprintf('Workflow compatibility: API / operation / available\n');
for k = 1:rows(requirements)
api = requirements{k,1};
operation = requirements{k,2};
present = gxtxt_api_has(api);
available = present && gxtxt_api_has_operation(api, operation);
ready = ready && available;
fprintf('%s / %s / %d\n', api, operation, available);
endfor
fprintf('All required operations available: %d\n', ready);
if !ready
error('Required workflow operation unavailable; see compatibility table.');
endif
Ogni riga di requirements associa un identificativo API
a un’operazione. Le parentesi graffe estraggono dalla cella il testo
effettivo. gxtxt_api_has controlla la presenza del provider
nel Bridge; gxtxt_api_has_operation controlla l’operazione.
Con present && ..., Octave non valuta il secondo
controllo se il primo è falso. L’accumulatore ready diventa
falso se manca almeno un elemento.
Nella nostra esecuzione le quattro righe riportano 1 e
anche il riepilogo finale vale 1: le operazioni risultano
disponibili. La tabella non le esegue e non garantisce che una futura
richiesta abbia argomenti corretti. In particolare, la presenza di
validate_spec non prova che un qualsiasi grafico sia valido
o leggibile.
Progettare un controllo utile
Puoi aggiungere righe per le operazioni richieste dal tuo progetto e
usare gxtxt_api_describe, introdotta in A01, per consultare
il contratto. gxtxt_api_list permette invece di esplorare
le API esposte nel contesto corrente; la tabella selettiva serve a
controllare ciò che il tuo flusso usa davvero.
Non affidarti all’ordine dell’inventario e non sostituire automaticamente un’operazione mancante con un’altra solo perché il nome sembra simile. Se una dipendenza è obbligatoria, fermare lo script prima della fase scientifica evita risultati incompleti presentati come analisi conclusa.
Esercizio
- In una copia dello script, aggiungi una riga con un nome di operazione inesistente per un’API presente. Quale valore compare e perché lo script termina con errore?
- Che differenza c’è fra API disponibile e operazione disponibile?
- Una tabella tutta a
1garantisce che i tuoi Dataset contengano unità corrette?
Soluzione ragionata
- La riga restituisce
0;readydiventa falso e la guardia finale segnala la dipendenza mancante. - Il provider può esistere senza esporre la singola operazione richiesta in quella versione.
- No. Verifica la presenza delle operazioni, non la correttezza dei dati, delle unità o del modello.
La prossima lezione approfondirà i valori e le dimensioni trasferiti tra Octave e Bridge.