show my code
github地址: https://github.com/ALawating-Rex/easy_i18n
gitee地址:https://gitee.com/aexcode/easy_i18n
安装
pip install easy_i18n
目的
python 开发的项目想做到多语言,搜了资料有 gettext ,感觉变得复杂了
有 python-i18n 简单使用了下,主要是文档太简要了,好多用法还得读源码才能知道,也有可能是我英语太渣了 😦 当然 easy_i18n 有点他的影子。
所以想开发一个简单的针对 python的 i18n
实现
- 通过 json文件配置 翻译原字符串和对应的翻译字符串
- 可以指定多种语言并在使用的时候指定翻译为哪种语言
- 当然也可以设置默认翻译语言
- 支持多模块设置,同一个原字符串在不同模块下可以翻译成不同的内容
- 当然也支持全局模块,而且如果在指定模块找不到翻译就会去全局模块查找
- 支持动态设置翻译 也支持后 load_file 需要的时候才把翻译文件加载进来
- 支持字符串 format
说明
其实代码的 readme 已经有了很多说明了,有问题欢迎随时沟通
这里说下我在实际项目中的使用(fastapi 项目)
定义帮助文件: i18nHelper.py
from easy_i18n.t import Ai18n
from conf.config import configs
import os
# BASE_DIR
config = {
"load_path": os.path.join(configs.BASE_DIR, 'conf'),
"default_locale": "zh",
}
a_i18n = Ai18n(locales=["zh"], config=config)
t = a_i18n.translate
这样使用的地方: 比如统一的 response.py 可以通过 imort导入
from api.utils.i18nHelper import t
响应 message 改为 t(message) 即可
通过定义 helper函数做到翻译文件 load一次读取到内存以后就可以一直使用了,而不是重复read file
有些特殊的翻译,尤其需要 format的,那就需要你在 输出具体字符串的地方提前使用 t() 函数进行包装了。
比如:
message=t("{param} format error").format(param="密码")
# t先把 {param} format error 可能翻译为 {param} 格式错误
# 然后再是 python的format 最终字符串为 密码格式错误
# 当然你也可以进一步封装 response函数,比如 指定 locale, module ,format 等参数
# 使用t() 函数后根据 format参数是否有值决定是否再调用 .format(这里可以通过 * 或者 ** 解包参数)