Yêu cầu chuyển đổi sang Vnstock3 trước 01/01/2025

Chào các bạn!

Thời điểm năm mới 2025 sắp đến gần, chắc hẳn các bạn cũng đang tất bật với nhiều công việc bận rộn phải không nào? Vnstock xin gửi lời tri ân sâu sắc đến tất cả các bạn đã yêu mến và đồng hành cùng chúng tôi trong thời gian qua. Sự ủng hộ và lan toả của các bạn đã tạo nên những cột mốc đáng nhớ, giúp Vnstock vươn xa hơn mỗi ngày.

Dưới đây là những thay đổi quan trọng và hướng dẫn chi tiết để bạn tận dụng tối đa phiên bản mới của Vnstock trong khi vẫn hỗ trợ các tính năng từ phiên bản cũ mà bạn yêu thích.

Thư viện vnstock3 sẽ cài đặt với tên vnstock

Kể từ ngày 1/1/2025, thư viện vnstock3 sẽ được đổi tên thành vnstock. Điều này giúp đơn giản hóa quá trình cài đặt và sử dụng, mang đến sự đồng nhất trong toàn bộ dự án.

Lợi ích:

• Đơn giản và tiện lợi hơn khi cài đặt. Vnstock được hiểu là phiên bản phần mềm mới nhất của dự án.
• Tập trung vào một nền tảng duy nhất với khả năng cập nhật và bảo trì lâu dài.

Nếu bạn vẫn muốn duy trì sử dụng các phiên bản vnstock Legacy (0.2.x.x), bạn chỉ cần chỉ định phiên bản cụ thể khi cài đặt. Ví dụ:

pip install vnstock==0.2.9.2.3

Chuyển đổi cách sử dụng hàm

Phiên bản mới của Vnstock mang đến cách tiếp cận lập trình hướng đối tượng (OOP), giúp bạn:

• Tăng tính linh hoạt: Thay vì sử dụng từng hàm riêng lẻ, bạn có thể khởi tạo đối tượng Vnstock và truy cập các thuộc tính.
• Cải thiện trải nghiệm mã hoá: Cung cấp gợi ý mã tốt hơn, đặc biệt hữu ích khi kết hợp với AI.

Vnstock mong rằng phiên bản mới nhất mà chúng tôi nỗ lực phát triển sẽ được bạn đón nhận và sử dụng thường xuyên thay vì phiên bản tiền nhiệm với nhiều bất cập. Do đó, việc chuyển đổi chương trình bạn đang sử dụng phiên bản Vnstock Legacy sang phiên bản mới nhất là cần thiết.

Vnstock Legacy có lợi thế khởi động nhanh và đơn giản nhưng gây khó chịu nếu phải sử dụng và nhập thông tin nhiều lần, trong khi đó Vnstock3 mất thời gian khởi tạo đối tượng lúc ban đầu nhưng dễ dàng tra cứu và nhận gợi ý tự động hoàn tất nhập liệu tốt hơn, có cấu trúc dễ nhớ.

Duới đây là một đoạn mã được sử dụng phổ biến để truy xuất giá lịch sử của một mã cổ phiếu bất kỳ. Bạn có thể xem thêm chi tiết so sánh giữa hai phiên bản phần mềm cùng hướng dẫn chuyển đổi tại đây.

from vnstock import Vnstock
stock = Vnstock().stock(symbol='ACB', source='VCI')  
df = stock.quote.history(start='2024-01-01', end='2024-06-21', interval='1D')

Thay đổi nguồn dữ liệu

Nhằm mang đến dữ liệu chất lượng và chuẩn hoá, Vnstock đã cập nhật các nguồn dữ liệu như sau:

• Giữ nguyên: API công khai từ TCBS.
• Không hỗ trợ: Loại bỏ nguồn dữ liệu từ SSI đã không còn hoạt động.
• Bổ sung: Nguồn dữ liệu từ VCI với dữ liệu đa dạng hơn với chất lượng tốt.

Những việc bạn cần làm

Để đảm bảo dự án của bạn chuyển đổi một cách suôn sẻ, hãy thực hiện các bước sau:

1. Cập nhật lệnh cài đặt:

• Chỉ rõ phiên bản Vnstock muốn cài đặt, Ví dụ phiên bản Legacy:

pip install vnstock==0.2.9.2.3

• Đối với phiên bản mới:

pip install -U vnstock

2. Kiểm tra mã nguồn:

   • Xem xét lại các hàm sử dụng trong dự án để điều chỉnh theo cách gọi hàm mới trong Vnstock 3.x.x.

3. Kiểm tra tích hợp dữ liệu:

   • Đảm bảo các nguồn dữ liệu hiện tại tương thích với phiên bản mới của thư viện.

Lộ trình chuyển đổi

• 1/1/2025: Bắt đầu sử dụng vnstock làm tên gói cài đặt chính thức.
• Hỗ trợ Legacy: Các phiên bản Legacy (2.x.x) sẽ tiếp tục nhận thông báo nâng cấp và vẫn hoạt động nhưng không được cập nhật thêm tính năng hay sửa đổi trên nền mã nguồn cũ.

Cảm ơn các bạn đã luôn ủng hộ và đồng hành cùng Vnstock. Chúng tôi tin rằng những thay đổi này sẽ giúp bạn làm việc hiệu quả hơn, đồng thời mở ra nhiều cơ hội phát triển mới trong năm 2025. Hãy sẵn sàng cho những điều tuyệt vời phía trước! 🚀