Crate json_gettext
source ·Expand description
JSON Get Text
This is a library for getting text from JSON usually for internationalization.
Example
#[macro_use] extern crate json_gettext;
let ctx = static_json_gettext_build!(
"en_US";
"en_US" => "langs/en_US.json",
"zh_TW" => "langs/zh_TW.json"
).unwrap();
assert_eq!("Hello, world!", get_text!(ctx, "hello").unwrap());
assert_eq!("哈囉,世界!", get_text!(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.
[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
).
#[macro_use] extern crate json_gettext;
#[macro_use] extern crate rocket;
use rocket::State;
use rocket::response::Redirect;
use json_gettext::JSONGetTextManager;
#[get("/")]
fn index(ctx: &State<JSONGetTextManager>) -> Redirect {
Redirect::temporary(uri!(hello(lang = ctx.get_default_key())))
}
#[get("/<lang>")]
fn hello(ctx: &State<JSONGetTextManager>, lang: String) -> String {
format!("Ron: {}", get_text!(ctx, lang, "hello").unwrap().as_str().unwrap())
}
#[launch]
fn rocket() -> _ {
rocket::build()
.attach(static_json_gettext_build_for_rocket!(
"en_US";
"en_US" => "langs/en_US.json",
"zh_TW" => "langs/zh_TW.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,
[dependencies.json-gettext]
version = "*"
features = ["language_region_pair", "rocket"]
#[macro_use]
extern crate rocket;
#[macro_use]
extern crate rocket_accept_language;
#[macro_use]
extern crate json_gettext;
use rocket::State;
use rocket_accept_language::unic_langid::subtags::Language;
use rocket_accept_language::AcceptLanguage;
use json_gettext::{JSONGetTextManager, Key};
const LANGUAGE_EN: Language = language!("en");
#[get("/")]
fn index(ctx: &State<JSONGetTextManager>, accept_language: &AcceptLanguage) -> String {
let (language, region) = accept_language.get_first_language_region().unwrap_or((LANGUAGE_EN, None));
format!("Ron: {}", get_text!(ctx, Key(language, region), "hello").unwrap().as_str().unwrap())
}
#[launch]
fn rocket() -> _ {
rocket::build()
.attach(static_json_gettext_build_for_rocket!(
key!("en");
key!("en") => "langs/en_US.json",
key!("zh_TW") => "langs/zh_TW.json",
))
.mount("/", routes![index])
}
Re-exports
pub extern crate serde_json;
Macros
- Used for getting single or multiple text from context.
- Create a literal key.
- Used for including json files into your executable binary file for building a
JSONGetText
instance.
Structs
- A wrapper for context and a default key. Keys are usually considered as locales.
- To build a JSONGetText instance, this struct can help you do that step by step.
Enums
- Represents any valid JSON value. Reference can also be wrapped.