an easy way come true i18n for python3
Project description
easy_i18n
an easy way come true i18n for python3
基于 python3 实现语言本地化
install - 安装
pip install easy_i18n
usage - 使用举例
from easy_i18n.t import Ai18n
a_i18n = Ai18n(locales=["en", "zh"], config={})
t = a_i18n.translate
# after import or define a_i18n and t
# add translation dictionary manually.
a_i18n.add(k="hi", message="hello by added")
# print all the translation dictionary
print(a_i18n.tm)
# simple use
print(t("hi"))
# simple use, translate "hi" to zh
print(t("hi", locale="zh"))
# simple use, translate "hi" to default locale and find it in module user
print(t("hi", module="user"))
# use when string need to format
print(t("user {id} is deleted", locale="zh", module="user").format(id=1))
Ai18n 说明
Ai18n 类接收两个参数:
1.参数 locales 是list形式,指定了语言都使用哪几种。举例:["en", "zh"] 那么对应的会在config指定的目录下找 en.json 和 zh.json加载过来
默认的 east_i18n 有目录 i18n 可供参考
2.参数 config 是dict形式,你可以指定后覆盖默认的 config值:
:load_path - where to find translate files(default is : i18n)
:default_locale - default locale(default is : en)
:default_module - default module(default is : g)
:default_encoding - default encoding(default is : UTF-8)
3.config使用举例:
config = {
"load_path": "/locales", # 指定在 /locales 下找对应的翻译 json文件
"default_module": "global", # 指定默认的全局模块,你可以为比如用户模块,订单模块单独设置翻译,如果不指定 module 则会去全局模块查找。
}
a_i18n = Ai18n(locales=["en", "zh"], config=config)
NOTE 注意
**NOTE:**
for example your locale is en , define load_path as a absolutely path is recommended,
create an en.json in this path. the content for example is: (default_module should equal g)
{
"g": {
"hi": "hello world",
"test": "test 1"
},
"user": {
"hi": "user:hello world",
"user {id} is deleted": "user {id} is deleted"
}
}
比如上述例子指定 load_path 为 /locales 且 Ai18n(locales=["en", "zh"], config=config)
那么要提前在 /locales 下 创建 en.json 和 zh.json
json内容参考上述例子即可
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
easy_i18n-1.1.1.tar.gz
(3.9 kB
view hashes)
Built Distribution
Close
Hashes for easy_i18n-1.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 390bd36ceb342fad81f553325a4a66c52dd59f65ddbe102632125eeb52220db3 |
|
MD5 | 578321e401850a8b62811f535133059d |
|
BLAKE2b-256 | 9d8806cd06dfef59b163e2119079668122651575d3f12f3a5bc9b4ab3d14492b |