Script di Debug: Test Connettore Alpha Vantage (debug_connector_alpha_vantage.py)

1. Scopo

Questo script è uno strumento di diagnostica e test di integrazione per il connettore AlphaVantageConnector. Il suo scopo è eseguire un test “live” del connettore in un ambiente isolato, senza la necessità di avviare l’intera applicazione FIRE.

Lo script esegue le seguenti operazioni:

  1. Carica la chiave API di Alpha Vantage dal file settings.json.
  2. Crea un’istanza del AlphaVantageConnector.
  3. Tenta di scaricare i dati storici per un ticker di esempio (MSFT) in un intervallo di date predefinito.
  4. Stampa a schermo l’esito del test (successo o fallimento) e, in caso di successo, mostra le prime e le ultime righe del DataFrame scaricato.

2. Quando si Deve Usare Questo Script?

Usa questo script per diagnosticare problemi specifici legati al download dei dati da Alpha Vantage, ad esempio:

  • Se il download dei dati da Alpha Vantage fallisce all’interno dell’applicazione FIRE e vuoi verificare se il problema è nel connettore, nella chiave API o nella rete.
  • Dopo aver apportato modifiche al AlphaVantageConnector, per verificare rapidamente che non siano state introdotte regressioni.
  • Per testare una nuova chiave API.

3. Come si Lancia

Prerequisiti:

  • Ambiente virtuale del progetto attivo.
  • Aver salvato una chiave API valida per Alpha Vantage tramite l’interfaccia delle impostazioni di FIRE (in modo che sia presente nel file settings.json).

Comando: Assicurati di essere nella directory principale del progetto ed esegui:

python scripts/debug/debug_connector_alpha_vantage.py

4. Interpretazione dell’Output

L’output nel terminale sarà molto chiaro:

  • Se vedi “SUCCESS: Dati scaricati correttamente!” seguito da una tabella di dati, il test ha avuto successo. Il connettore, la chiave API e la connessione di rete funzionano.

  • Se vedi un messaggio di ERRORE o FALLIMENTO, il terminale ti fornirà dettagli utili per capire la causa del problema (es. chiave API mancante, errore di rete, ecc.).

codeCode