util_check_webengine

Script di Utility: Verifica Installazione QtWebEngine (util_check_webengine.py)

1. Scopo

Questo script è un health check di basso livello per una dipendenza critica del nostro framework: QtWebEngine. Il suo unico scopo è tentare di importare il modulo QWebEngineView da PySide6 e riportare l’esito.

QWebEngine è il componente che utilizziamo per renderizzare tutti i nostri grafici interattivi (come Lightweight Charts e Plotly). Se questo componente non è installato o configurato correttamente, l’applicazione FIRE non può funzionare.

2. Quando si Deve Usare Questo Script?

Usa questo script per diagnosticare problemi di setup dell’ambiente di sviluppo, in particolare se:

1. L’applicazione FIRE crasha all’avvio con un ImportError relativo a PySide6.QtWebEngineWidgets o QWebEngineView.
2. Durante l’installazione di PySide6 si sono verificati errori o avvisi.
3. Si sta configurando un nuovo ambiente di sviluppo e si vuole verificare che tutte le componenti di PySide6 siano state installate correttamente.

3. Come si Lancia

Prerequisiti:

• Ambiente virtuale del progetto attivo.
• PySide6 installato.

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

python scripts/utils/util_check_webengine.py

4. Interpretazione dell’Output

L’output è diretto e indica immediatamente lo stato del componente:

• Se tutto è installato correttamente, vedrai:

  codeCode

  SUCCESS: Modulo QWebEngineView importato correttamente!
  

• Se il componente è mancante o corrotto, vedrai:

  codeCode

  ERRORE: Impossibile importare il modulo.
  Dettaglio errore: ...
  

  Questo messaggio di errore è fondamentale per capire la causa del problema (es. librerie di sistema mancanti, installazione di PySide6 incompleta) e per cercare una soluzione.

codeCode