python i18n 国际化简单实现-easy_i18n

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

实现

1. 通过 json文件配置 翻译原字符串和对应的翻译字符串
2. 可以指定多种语言并在使用的时候指定翻译为哪种语言
3. 当然也可以设置默认翻译语言
4. 支持多模块设置，同一个原字符串在不同模块下可以翻译成不同的内容
5. 当然也支持全局模块，而且如果在指定模块找不到翻译就会去全局模块查找
6. 支持动态设置翻译 也支持后 load_file 需要的时候才把翻译文件加载进来
7. 支持字符串 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(这里可以通过 * 或者 ** 解包参数)