Message Localization

All-in-one package for flexible localization on Rust.

Features:

• MessageLocator
  • Load assets from either HTTP or file system.
• General language code and country code manipulation.
  • Locale object and parse_locale(str)
  • Country object and parse_country(str)

Getting started

This example uses the Tokio asynchronous runtime framework, solely for demonstrative purposes.

Add the following dependencies to Cargo.toml:

toml [dependencies] recoyx_localization = "1" maplit = "1.0" tokio = { version = "1", features = ["full"] }

Example asset located at res/lang/en/_.json:

json { "message_id": "Some message", "parameterized": "Here: $x", "contextual_male": "Male message", "contextual_female": "Female message", "contextual_other": "Other message", "qty_empty": "Empty ($number)", "qty_one": "One ($number)", "qty_multiple": "Multiple ($number)" }

Example program using these assets:

```rust use recoyxlocalization::{ MessageLocator, MessageLocatorOptions, MessageLocatorAssetOptions, MessageLocatorLoadVia, localizationvars, }; use maplit::hashmap;

[tokio::main]

async fn main() { let mut msglocator = MessageLocator::new( MessageLocatorOptions::new() // Specify supported locale codes. // The form in which the locale code appears here // is a post-component for the assets "src" path. // For example: "path/to/res/lang/en-US" .supportedlocales(vec!["en", "en-US", "pt-BR"]) .defaultlocale("en-US") .fallbacks(hashmap! { "en-US" => vec!["en"], "pt-BR" => vec!["en-US"], }) .assets(MessageLocatorAssetOptions::new() .src("res/lang") .basefilenames(vec![""]) // "cleanunused" indicates whether to clean previous unused locale data. .cleanunused(true) // Specify MessageLocatorLoadVia::FileSystem or MessageLocatorLoadVia::Http .loadvia(MessageLocatorLoadVia::FileSystem)) ); // msglocator

if (!msg_locator.load(None).await) {
    // failed to load
}

println!("{}", msg_locator.get("_.message_id"));
println!("{}", msg_locator.get_formatted("_.parameterized", vec![ &localization_vars!{
    "x" => "foo"
} ]));
println!("{}", msg_locator.get_formatted("_.contextual", vec![ "female" ]));

} ```