Module icu_provider_fs::export

Utilities for dumping data to an ICU4X filesystem tree.

The export feature enables you to pull all data from some other data provider and persist it on the filesystem to be read by an FsDataProvider at runtime.

For a command-line user interface, see the icu_datagen crate.

Examples

use icu_locid_macros::langid;
use icu_provider::prelude::*;
use icu_provider::hello_world::{key, HelloWorldProvider, HelloWorldV1Marker};
use icu_provider_fs::FsDataProvider;
use icu_provider_fs::export::fs_exporter;
use icu_provider_fs::export::serializers;
use std::borrow::Cow;
use std::path::PathBuf;

let demo_path = std::env::temp_dir().join("icu4x_json_demo");

// Set up the exporter
let mut options = serializers::json::Options::default();
let serializer = Box::new(serializers::json::Serializer::new(options));
let mut options = fs_exporter::ExporterOptions::default();
options.root = demo_path.clone();
let mut exporter = fs_exporter::FilesystemExporter::try_new(serializer, options)
    .expect("Should successfully initialize data output directory");

// Export a key
let source_provider = HelloWorldProvider::new_with_placeholder_data();
let result = icu_provider::export::export_from_iterable(
    &key::HELLO_WORLD_V1,
    &source_provider,
    &mut exporter)
.expect("Should successfully export");

// Create a filesystem provider reading from the demo directory
let fs_provider = FsDataProvider::try_new(demo_path.clone())
    .expect("Should successfully read from filesystem");

// Read the key from the filesystem and ensure it is as expected
let req = DataRequest {
    resource_path: ResourcePath {
        key: key::HELLO_WORLD_V1,
        options: ResourceOptions {
            variant: None,
            langid: Some(langid!("bn")),
        },
    }
};
let source_response: DataResponse<HelloWorldV1Marker> =
    source_provider.load_payload(&req).unwrap();
let fs_response: DataResponse<HelloWorldV1Marker> =
    fs_provider.load_payload(&req).unwrap();

assert_eq!(
    source_response.payload.unwrap().get(),
    fs_response.payload.unwrap().get(),
);

// Clean up from demo
std::fs::remove_dir_all(&demo_path).expect("Should clean up test directory");

Re-exports

pub use fs_exporter::FilesystemExporter;

Modules

fs_exporter

serializers