Aller au contenu

Packages tiers dans les algorithmes Python

Lors de la création de cBots, d'indicateurs ou de plug-ins basés sur Python pour cTrader, vous pouvez avoir besoin d'utiliser des packages tiers tels que pandas, numpy ou d'autres bibliothèques. Ce guide vous montre comment déclarer ces dépendances dans un fichier requirements.txt, ce qui garantit que votre algorithme fonctionne correctement dans tous les environnements.

Configuration et règles du fichier

requirements.txt est un fichier texte brut utilisé pour spécifier les packages Python externes dont un projet a besoin. Votre fichier requirements.txt doit respecter les règles suivantes :

  • Le fichier doit être nommé exactement requirements.txt
  • Le fichier doit être placé à la racine du projet, à côté de votre fichier d'entrée Python (par exemple, Super cBot_main.py).
  • Le fichier doit être inclus dans les fichiers du projet afin d'être empaqueté avec l'algorithme.

Une fois que le fichier requirements.txt est présent et correctement formaté, il suffit de compiler votre projet, et toutes les dépendances listées seront ajoutées et résolues automatiquement. Voici un exemple :

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

Image title 

1
2
pandas==2.2.2
numpy>=1.26.4

Fonctionnalités prises en charge

Le format requirements.txt suit les conventions standard utilisées par pip. Les exemples suivants montrent comment spécifier les versions de packages à l'aide de spécificateurs de version, ajouter des commentaires et utiliser des lignes vides pour améliorer la lisibilité :

Épingler à une version exacte 

1
pandas==2.2.2

Autoriser une version minimale 

1
numpy>=1.26.4

Utiliser des commentaires et des lignes vides 

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

# You can leave blank lines for readability

Meilleures pratiques

  1. Épinglez les bibliothèques critiques pour éviter un comportement inattendu lorsque de nouvelles versions introduisent des changements incompatibles.
  2. Si vous utilisez des spécificateurs de plage pour des packages moins critiques, testez votre algorithme chaque fois que la dépendance est mise à jour.
  3. Pensez à rédiger des commentaires significatifs pour expliquer pourquoi certains packages ont été utilisés ou pourquoi des versions spécifiques ont été choisies.
  4. Recompilez votre projet chaque fois que vous modifiez requirements.txt pour vous assurer que les dépendances sont correctement installées.

Image title