i18n-embed

This library contains traits and macros to conveniently embed the output of cargo-i18n into your application binary in order to localize it at runtime.

Currently this library depends on rust-embed to perform the actual embedding of the language files. This may change in the future to make the library more convenient to use.

Optional Features

The i18n-embed crate has the following optional Cargo features:

• desktop-requester
  • Enables a convenience implementation of LanguageRequester trait called DesktopLanguageRequester for the desktop platform (windows, mac, linux),which makes use of the locale_config crate for resolving the current system locale.
• web-sys-requester
  • Enables a convenience implementation of LanguageRequester trait called WebLanguageRequester which makes use of the web-sys crate for resolving the language being requested by the user's web browser in a WASM context.

Example

The following is an example for how to derive the required traits on structs, and localize your binary using this library:

```rust use i18nembed::{I18nEmbed, LanguageLoader, DesktopLanguageRequester}; use rustembed::RustEmbed;

[derive(RustEmbed, I18nEmbed)]

[folder = "i18n/mo"] // path to the compiled localization resources

struct Translations;

[derive(LanguageLoader)]

struct MyLanguageLoader;

fn main() { let language_loader = MyLanguageLoader {};

// Use the language requester for the desktop platform (linux, windows, mac).
// There is also a requester available for the web-sys WASM platform called
// WebLanguageRequester, or you can implement your own.
let language_requester = DesktopLanguageRequester::new();
Translations::select(&language_requester, &language_loader);

} ```

For more examples, see the documentation for i18n-embed.