Parses FIT formatted files and exports their contents using Serde. This code was heavily inspired by the python-fitparse module and uses the specifications defined by the Fit File SDK which is maintained by ANT.
The goal of this crate is to parse valid FIT files according to the
defined FIT profile and export their data into a more usable format. To that
end we leverage the Serde framework which allows end users to export the
data in whatever format suits their needs. This library provides a
fit_to_json example executable to serve as a template for any
other serialization format implemented using Serde.
Notes: * This library does not support writing FIT files at this time. * Files with Developer Data fields can be parsed but the developer fields are dropped. * We do not validate the CRC values at this time
See library documentation at docs.rs/fitparser for full usage information. Below is a basic example of calling the parser on a FIT file. ```rust use fitparser; use std::fs::File; use std::io::prelude::*;
let mut fp = File::open("tests/fixtures/Activity.fit")?; for data in fitparser::from_reader(&mut fp)? { // print the data in FIT file println!("{:#?}", data); } ```
All FIT files are generated based on a customizable profile. The profile
used here is pulled from ANT's offical SDK which can be accessed
here. To
update the FIT profile set the environment variable FIT_PROFILE to the
path of the desired Profile.xlsx file and then run cargo build. When
this variable is not set cargo will simply emit a warning stating that
the profile was not updated.
sh
FIT_PROFILE=./FitSDKRelease_21.22.00/Profile.xlsx cargo build
A profile file is not required for building the library as the files generated are committed to the repository. The profile only needs updated to support custom extensions or when ANT releases an updated version.