Module icu_provider_export::blob_exporter

Expand description

Data exporter that creates a binary blob for use with BlobDataProvider.

This module can be used as a target for the icu_provider_export crate.

See our datagen tutorial for more information about different data providers.

§Examples

use icu_provider_export::prelude::*;
use icu_provider_blob::export::*;

let mut blob: Vec<u8> = Vec::new();

// Set up the exporter
let mut exporter = BlobExporter::new_with_sink(Box::new(&mut blob));

// Export something. Make sure to use the same fallback data at runtime!
ExportDriver::new([DataLocaleFamily::FULL], DeduplicationStrategy::Maximal.into(), LocaleFallbacker::new().static_to_owned())
    .export(&icu_provider::hello_world::HelloWorldProvider, exporter)
    .unwrap();

// communicate the blob to the client application (network, disk, etc.)

The resulting blob can now be used like this:

use icu_locale_core::locale;
use icu_provider::hello_world::*;
use icu_provider::prelude::*;
use icu_provider_blob::BlobDataProvider;

// obtain the data blob

// Create a provider reading from the blob
let provider = BlobDataProvider::try_new_from_blob(blob.into_boxed_slice())
    .expect("Should successfully read from blob");

// Use the provider as a `BufferProvider`
let formatter = HelloWorldFormatter::try_new_with_buffer_provider(
    &provider,
    &locale!("en").into(),
)
.unwrap();

assert_eq!(formatter.format_to_string(), "Hello World");

Structs§

  • BlobExporter
    A data exporter that writes data to a single-file blob. See the module-level docs for an example.