Vai al contenuto

Pacchetti di terze parti negli algoritmi Python

Quando sviluppi cBot, indicatori o plugin basati su Python per cTrader, potresti aver bisogno di utilizzare pacchetti di terze parti come pandas, numpy o altre librerie. Questa guida ti mostra come dichiarare tali dipendenze in un file requirements.txt, che garantisce il corretto funzionamento del tuo algoritmo in tutti gli ambienti.

Configurazione del file e regole

requirements.txt è un file di testo semplice utilizzato per specificare i pacchetti Python esterni di cui un progetto ha bisogno. Il tuo file requirements.txt deve seguire queste regole:

  • Il file deve essere denominato esattamente requirements.txt
  • Il file deve essere posizionato nella radice del progetto, accanto al file di ingresso Python (ad esempio, Super cBot_main.py).
  • Il file deve essere incluso nei file del progetto in modo che venga impacchettato con l'algoritmo.

Una volta che il file requirements.txt è presente e formattato correttamente, è sufficiente compilare il progetto e tutte le dipendenze elencate verranno aggiunte e risolte automaticamente. Ecco un esempio:

...\Documents\cAlgo\Sources\Robots\Super cBot\Super cBot

Image title 

1
2
pandas==2.2.2
numpy>=1.26.4

Funzionalità supportate

Il formato requirements.txt segue le convenzioni standard utilizzate da pip. I seguenti esempi dimostrano come specificare le versioni dei pacchetti utilizzando gli specificatori di versione, aggiungere commenti e utilizzare righe vuote per migliorare la leggibilità:

Fissare una versione esatta 

1
pandas==2.2.2

Consentire una versione minima 

1
numpy>=1.26.4

Utilizzare commenti e righe vuote 

1
2
3
4
5
# Data science libraries
pandas==2.2.2
numpy>=1.26.4

# You can leave blank lines for readability

Migliori pratiche

  1. Fissa le librerie critiche per evitare comportamenti imprevisti quando le nuove versioni introducono modifiche incompatibili.
  2. Se utilizzi specificatori di intervallo per pacchetti meno critici, testa il tuo algoritmo ogni volta che la dipendenza viene aggiornata.
  3. Considera di scrivere commenti significativi per spiegare perché sono stati utilizzati determinati pacchetti o perché sono state scelte versioni specifiche.
  4. Ricompila il progetto ogni volta che modifichi requirements.txt per garantire che le dipendenze vengano installate correttamente.

Image title