Khác biệt với vnstock_ezchart
Mục lục
vnstock_chart và vnstock_ezchart là hai gói pip khác tên, cài độc lập với nhau. Nâng cấp sang vnstock_chart cần đổi câu lệnh cài và câu lệnh import trong mã của bạn — không tự xảy ra khi bạn chạy pip install -U vnstock_ezchart.
Vì sao đổi tên
Thư viện ban đầu phát hành với tên vnstock_ezchart, công khai trên PyPI, không gắn với một thế hệ vnstock cụ thể. Từ 18/10/2026, thư viện được phát hành lại với tên ngắn hơn vnstock_chart, thuộc nhóm thư viện thế hệ 5 chính thức của Vnstock (cùng nhóm với vnstock, vnstock_quant, vnstock_bt), qua kho gói riêng của Vnstock — có kiểm thử, quét rò rỉ như mọi thư viện thế hệ 5 khác trước khi phát hành.
vnstock_ezchart (cũ) | vnstock_chart (mới, thế hệ 5) | |
|---|---|---|
| Phát hành qua | PyPI công khai | Kho gói Vnstock (--extra-index-url https://vnstocks.com/api/packages) |
| Bản mới nhất | 1.0.2, không cập nhật thêm | Tiếp tục nhận sửa lỗi, tính năng mới |
vnstock yêu cầu | >=4.0.3 — dùng được cả thế hệ 4 lẫn 5 | >=5.0 — chỉ nhắm thế hệ 5 |
| Import | from vnstock_ezchart import Chart | from vnstock_chart import Chart |
| Cài đặt | pip install vnstock-ezchart | pip install --extra-index-url https://vnstocks.com/api/packages vnstock-chart |
| Mã nguồn | Giữ nguyên tại thời điểm 1.0.2 | Cùng gốc, tiếp tục phát triển |
Lỗi đã sửa ở vnstock_chart, không có ở bản vnstock_ezchart cũ
Hai bản PyPI vnstock_ezchart 1.0.1 và 1.0.2 có một lỗi đóng gói: cài qua pip install (không phải pip install -e .) thiếu các thư mục con static, core — from vnstock_ezchart import Chart báo ModuleNotFoundError. Lỗi này chỉ được sửa ở vnstock_chart, bản vnstock_ezchart trên PyPI không còn được cập nhật nên vẫn giữ lỗi đó. Nếu bạn gặp lỗi import này với vnstock_ezchart, cách xử lý là chuyển sang vnstock_chart thay vì chờ một bản vá cho tên cũ.
Chuyển từ vnstock_ezchart sang vnstock_chart
- Cài bản mới:
Shell
pip install --extra-index-url https://vnstocks.com/api/packages vnstock-chart - Đổi mọi
import:DIFF- from vnstock_ezchart import Chart + from vnstock_chart import Chart - (Tuỳ chọn) Gỡ bản cũ nếu không còn môi trường nào cần nó:
Shell
pip uninstall vnstock_ezchart
Toàn bộ tên hàm (Chart.candle, Chart.line, Chart.treemap…), tham số và hành vi giữ nguyên — chỉ đổi tên gói và câu import.
Nếu bạn không dùng vnstock thế hệ 5
vnstock_chart khai báo vnstock>=5.0 và chỉ phát hành qua kho gói Vnstock. Nếu bạn vẫn đang dùng vnstock 3.x/4.x, cứ tiếp tục dùng vnstock_ezchart từ PyPI như trước — thư viện vẽ biểu đồ không đổi cách dùng giữa hai thế hệ vnstock, chỉ có cách lấy dữ liệu đầu vào khác nhau (xem Biểu diễn dữ liệu trực quan cho thế hệ cũ).