icu4x
icu4x copied to clipboard
Add tutorial for building ICU4X data
We have documentation scattered around a bit. We should update the data_provider.md tutorial to document the full lifecycle of ICU4X data with a focus on clients of ICU4X.
Blocked on #78
Moving this from the #873 meta-issue to the #1110 meta-issue.
The data build process for client Rust crates can be the following, based on discussion with @robertbastian:
- build.rs invokes datagen with a list of keys and locales
- An integration test verifies that the extracted keys are consistent with the keys that were passed to datagen
We may want to move toward a datagen.toml file that contains the list of keys, locales, CLDR version, etc., so that:
- It can be read from both build.rs and the integration test
- To better separate code (build.rs) and data (datagen arguments)
This should be done before the blog post goes out.
Fixed by #2678