stadelmanma/fitparse-rs

📊 fitparse-rs: Phân tích file FIT bằng Rust với Serde

Thư viện Rust mạnh mẽ để phân tích định dạng FIT (Garmin/ANT) và xuất dữ liệu linh hoạt nhờ Serde.

fitparse-rs (còn gọi là Fitparser) là một crate Rust dùng để phân tích các tệp tin định dạng FIT — định dạng nhị phân do ANT (sở sở hữu bởi Garmin) định nghĩa, thường dùng trong thiết bị định vị và thiết bị đồng hồ thể thao như Garmin. Dự án được cảm hứng mạnh mẽ từ thư viện python-fitparse và tuân thủ tiêu chuẩn từ Fit File SDK.

✨ Điểm nổi bật

• Phân tích FIT bằng Serde: Tận dụng framework Serde để xuất dữ liệu ra các định dạng khác nhau một cách linh hoạt.
• Hỗ trợ Developer Data fields: Các trường dữ liệu tùy chỉnh (developer fields) được trích xuất chính xác.
• Ví dụ fit_to_json: Cung cấp chương trình mẫu để chuyển đổi file FIT sang JSON.
• Hỗ trợ nguồn dữ liệu streaming: Sử dụng de::FitStreamProcessor để xử lý dữ liệu theo luồng.
• Cập nhật profile tự động: Hỗ trợ cập nhật profile từ SDK của ANT thông qua script ./bin/update_profile.sh.
• Không hỗ trợ ghi file FIT: Hiện tại thư viện chỉ hỗ trợ đọc và phân tích, chứ không ghi file FIT mới.

💡 Vì sao đáng chú ý

Khác với các thư viện phân tích FIT khác, fitparse-rs tích hợp sâu với Serde, cho phép người dùng dễ dàng tuần tự hóa dữ liệu sang bất kỳ định dạng nào như JSON, CSV, hoặc thậm chí là cơ sở dữ liệu. Điều này giúp tiết kiệm thời gian phát triển ứng dụng liên quan đến dữ liệu hoạt động (activity data) từ thiết bị Garmin.

Nhờ thiết kế dựa trên profile chuẩn từ ANT, thư viện đảm bảo tính chính xác cao khi phân tích các file FIT phức tạp. Ngoài ra, kh khả năng hỗ trợ cập nhật profile định kỳ giúp dự ám luôn đồng bộ với các phiên bản mới nhất của SDK.

---

#Rust #FIT #Serde #Garmin #ANT #OpenSource #TiniX