Octave avanzato A02 — Disponibilità dinamica e compatibilità

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

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.

Script Octave della verifica di compatibilità nell’editor GX-TXT.
Script Octave della verifica di compatibilità nell’editor GX-TXT.
% 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.

Output della tabella di compatibilità: quattro operazioni disponibili nella Session di esempio.
Output della tabella di compatibilità: quattro operazioni disponibili nella Session di esempio.

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

  1. 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?
  2. Che differenza c’è fra API disponibile e operazione disponibile?
  3. Una tabella tutta a 1 garantisce che i tuoi Dataset contengano unità corrette?

Soluzione ragionata

  1. La riga restituisce 0; ready diventa falso e la guardia finale segnala la dipendenza mancante.
  2. Il provider può esistere senza esporre la singola operazione richiesta in quella versione.
  3. 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.

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 *