15 releases (8 stable)
|Nov 16, 2023
|Sep 23, 2023
|Apr 14, 2023
|Jan 26, 2023
|Oct 15, 2020
#105 in Internationalization (i18n)
108,534 downloads per month
Used in 86 crates (43 directly)
icu_provider is one of the
Unicode's experience with ICU4X's parent projects, ICU4C and ICU4J, led the team to realize that data management is the most critical aspect of deploying internationalization, and that it requires a high level of customization for the needs of the platform it is embedded in. As a result ICU4X comes with a selection of providers that should allow for ICU4X to naturally fit into different business and technological needs of customers.
icu_provider defines traits and structs for transmitting data through the ICU4X locale
data pipeline. The primary trait is
DataProvider. It is parameterized by a
KeyedDataMarker, which contains the data type and a
DataKey. It has one method,
DataProvider::load, which transforms a
DataKeyis a fixed identifier for the data type, such as
DataRequestcontains additional annotations to choose a specific variant of the key, such as a locale.
DataResponsecontains the data if the request was successful.
In addition, there are three other traits which are widely implemented:
AnyProviderreturns data as
dyn Anytrait objects.
BufferProviderreturns data as
DynamicDataProviderreturns structured data but is not specific to a key.
The most common types required for this crate are included via the prelude:
Types of Data Providers
All nontrivial data providers can fit into one of two classes.
AnyProvider: Those whose data originates as structured Rust objects
BufferProvider: Those whose data originates as unstructured
See also crate::constructors.
Examples of AnyProviders:
DatagenProviderreads structured data from CLDR source files and returns ICU4X data structs.
AnyPayloadProviderwraps a specific data struct and returns it.
BakedDataProviderwhich encodes structured data directly in Rust source
These providers are able to return unstructured data typically represented as
serde-serialized buffers. Users can call
as_deserializing() to get an object
DataProvider by invoking Serde Deserialize.
Examples of BufferProviders:
FsDataProviderreads individual buffers from the filesystem.
BlobDataProviderreads buffers from a large in-memory blob.
ICU4X offers several built-in modules to combine providers in interesting ways.
These can be found in the
This crate also contains a concrete provider for demonstration purposes:
HelloWorldProviderreturns "hello world" strings in several languages.
Types and Lifetimes
Data structs should generally have one lifetime argument:
'data. This lifetime allows data
structs to borrow zero-copy data.
Data generation API
This functionality is enabled with the "datagen" Cargo feature
For more information on development, authorship, contributing etc. please visit
ICU4X home page.