JSON Get Text

CI

This is a library for getting text from JSON usually for internationalization.

Example

```rust

[macrouse] extern crate jsongettext;

let ctx = staticjsongettextbuild!( "enUS"; "enUS" => "langs/enUS.json", "zhTW" => "langs/zhTW.json" ).unwrap();

asserteq!("Hello, world!", gettext!(ctx, "hello").unwrap()); asserteq!("哈囉，世界！", gettext!(ctx, "zh_TW", "hello").unwrap()); ```

Rocket Support

This crate supports the Rocket framework. In order to reload changed json files instead of recompiling the program you have to enable the rocket feature for this crate.

toml [dependencies.json-gettext] version = "*" features = ["rocket"]

Then, use the static_json_gettext_build_for_rocket macro instead of the static_json_gettext_build macro to build a JSONGetText(JSONGetTextManager).

```rust

[macrouse] extern crate jsongettext;

[macro_use] extern crate rocket;

use rocket::State; use rocket::response::Redirect;

use json_gettext::JSONGetTextManager;

[get("/")]

fn index(ctx: &State) -> Redirect { Redirect::temporary(uri!(hello: lang = ctx.getdefaultkey())) }

[get("/")]

fn hello(ctx: &State, lang: String) -> String { format!("Ron: {}", gettext!(ctx, lang, "hello").unwrap().asstr().unwrap()) }

[launch]

fn rocket() -> _ { rocket::build() .attach(staticjsongettextbuildforrocket!( "enUS"; "enUS" => "langs/enUS.json", "zhTW" => "langs/zhTW.json" )) .mount("/", routes![index, hello]) } ```

If you are not using the release profile, JSONGetTextManager can reload the json files automatically if needed.

unic-langid Support

Since string comparison could be slow, the language_region_pair feature, the language feature or the region feature can be enabled to change key's type to (Language, Option<Region>), Language or Region respectively where Language and Region structs are in the unic-langid crate.

In this case, the key! macro would be useful for generating a Key instance from a literal string.

For example,

toml [dependencies.json-gettext] version = "*" features = ["language_region_pair", "rocket"]

```rust

[macro_use]

extern crate rocket;

[macro_use]

extern crate rocketacceptlanguage;

[macro_use]

extern crate json_gettext;

use rocket::State;

use rocketacceptlanguage::uniclangid::subtags::Language; use rocketaccept_language::AcceptLanguage;

use json_gettext::{JSONGetTextManager, Key};

const LANGUAGE_EN: Language = language!("en");

[get("/")]

fn index(ctx: &State, acceptlanguage: &AcceptLanguage) -> String { let (language, region) = acceptlanguage.getfirstlanguageregion().unwrapor((LANGUAGE_EN, None));

format!("Ron: {}", get_text!(ctx, Key(language, region), "hello").unwrap().as_str().unwrap())

}

[launch]

fn rocket() -> _ { rocket::build() .attach(staticjsongettextbuildforrocket!( key!("en"); key!("en") => "langs/enUS.json", key!("zhTW") => "langs/zhTW.json", )) .mount("/", routes![index]) } ```

Crates.io

https://crates.io/crates/json-gettext

Documentation

https://docs.rs/json-gettext

License

MIT