Saltar a contenido

Paquetes de terceros en algoritmos de Python

Al crear cBots, indicadores o plugins basados en Python para cTrader, es posible que necesite usar paquetes de terceros como pandas, numpy u otras bibliotecas. Esta guía le muestra cómo declarar dichas dependencias en un archivo requirements.txt, lo que garantiza que su algoritmo se ejecute correctamente en todos los entornos.

Configuración del archivo y reglas

requirements.txt es un archivo de texto sin formato que se utiliza para especificar paquetes de Python externos que necesita un proyecto. Su archivo requirements.txt debe seguir estas reglas:

  • El archivo debe llamarse exactamente requirements.txt
  • El archivo debe colocarse en la raíz del proyecto, junto con su archivo de entrada de Python (por ejemplo, Super cBot_main.py).
  • El archivo debe incluirse en los archivos del proyecto para que se empaquete con el algoritmo.

Una vez que el archivo requirements.txt esté presente y correctamente formateado, simplemente compile su proyecto y todas las dependencias enumeradas se agregarán y resolverán automáticamente. Aquí hay un ejemplo:

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

Image title 

1
2
pandas==2.2.2
numpy>=1.26.4

Funciones admitidas

El formato requirements.txt sigue las convenciones estándar utilizadas por pip. Los siguientes ejemplos demuestran cómo especificar versiones de paquetes utilizando especificadores de versión, agregar comentarios y usar líneas en blanco para mejorar la legibilidad:

Fijación a una versión exacta 

1
pandas==2.2.2

Permitir una versión mínima 

1
numpy>=1.26.4

Uso de comentarios y líneas en blanco 

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

# You can leave blank lines for readability

Mejores prácticas

  1. Fije las bibliotecas críticas para evitar comportamientos inesperados cuando nuevas versiones introduzcan cambios incompatibles.
  2. Si utiliza especificadores de rango para paquetes menos críticos, pruebe su algoritmo cada vez que se actualice la dependencia.
  3. Considere escribir comentarios significativos para explicar por qué se utilizaron ciertos paquetes o por qué se eligieron versiones específicas.
  4. Vuelva a compilar su proyecto cada vez que edite requirements.txt para asegurarse de que las dependencias se instalen correctamente.

Image title