Lewati ke isi

Paket pihak ketiga dalam algoritma Python

Saat membangun cBot, indikator, atau plugin berbasis Python untuk cTrader, Anda mungkin perlu menggunakan paket pihak ketiga seperti pandas, numpy, atau pustaka lainnya. Panduan ini menunjukkan cara mendeklarasikan dependensi tersebut dalam file requirements.txt, yang memastikan algoritma Anda berjalan dengan baik di berbagai lingkungan.

Pengaturan file dan aturan

requirements.txt adalah file teks biasa yang digunakan untuk menentukan paket Python eksternal yang dibutuhkan oleh sebuah proyek. File requirements.txt Anda harus mengikuti aturan-aturan berikut:

  • File harus diberi nama persis requirements.txt
  • File harus ditempatkan di root proyek, bersama dengan file entri Python Anda (misalnya, Super cBot_main.py).
  • File harus disertakan dalam file proyek sehingga dikemas bersama dengan algoritma.

Setelah file requirements.txt ada dan diformat dengan benar, cukup build proyek Anda, dan semua dependensi yang terdaftar akan ditambahkan dan diselesaikan secara otomatis. Berikut contohnya:

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

Image title 

1
2
pandas==2.2.2
numpy>=1.26.4

Fitur yang didukung

Format requirements.txt mengikuti konvensi standar yang digunakan oleh pip. Contoh-contoh berikut menunjukkan cara menentukan versi paket menggunakan penentu versi, menambahkan komentar, dan menggunakan baris kosong untuk keterbacaan:

Menetapkan ke versi yang tepat 

1
pandas==2.2.2

Mengizinkan versi minimum 

1
numpy>=1.26.4

Menggunakan komentar dan baris kosong 

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

# You can leave blank lines for readability

Praktik terbaik

  1. Tetapkan pustaka penting untuk menghindari perilaku tak terduga ketika rilis baru memperkenalkan perubahan yang merusak.
  2. Jika Anda menggunakan penentu rentang untuk paket yang kurang penting, uji algo Anda setiap kali dependensi diperbarui.
  3. Pertimbangkan untuk menulis komentar yang bermakna untuk menjelaskan mengapa paket tertentu digunakan atau mengapa versi tertentu dipilih.
  4. Bangun ulang proyek Anda setiap kali Anda mengedit requirements.txt untuk memastikan dependensi diinstal dengan benar.

Image title