Nonebot Plugin Alconna 0.46.0

[RF-Tar-Railt]

新增

• 适配器 Mirai(官方)
• 适配器 TailChat
• Text 新增 .bold(), .italic() 等一系列便捷方法
• 新增 I18n 通用消息段（在发送前会转为 UniMessage）
• AlconnaMatcher 新增 .i18n() 方法，与 I18n 作用相同
• 新增内置插件 lang，可以切换或列出可用的语言模式

改进

• 升级 Tarina 至 0.5.0 以使用 tarina-lang 新特性

i18n 说明

plugin-alconna 的 i18n 支持基于 tarina.lang，其提供了一个 tarina-lang 命令行工具

首先可以通过 tarina-lang new 创建文件夹 i18n

之后使用 cd ./i18n 和 tarina-lang init，会生成如下文件：

📦 awesome-bot
├──📂 i18n
++ ├── __init__.py
++ ├── .config.json
++ ├── .template.json
++ └── .template.schema.json
├── xxx.py
└── ...

你需要将你语言文件中所有包含的项目声明在 .template.json 中，例如：

{
  "$schema": ".template.schema.json",
  "scopes" : [
    {
      "scope": "example",
      "types": [
        "test",
        {
          "subtype": "test1",
          "types": [
            "test2"
          ]
        }
      ]
    }
  ]
}

然后通过 tarina-lang schema 和 tarina-lang create XXX 来创建新的语言文件。以下为使用命令创建 en-US 和 zh-CN 语言文件后的文件结构：

📦 awesome-bot
├──📂 i18n
│  ├── __init__.py
│  ├── .config.json
++ ├── .lang.schema.json
│  ├── .template.json
│  ├── .template.schema.json
++ ├── en-US.json
++ └── zh-CN.json
├── plugin.py
└── ...

其中一个语言文件如下所示：

// en-US.json
{
  "$schema": "./.lang.schema.json",
  "example": {
    "test": "Test",
    "test1": {
      "test2": "Test2"
    }
  }
}

Note

tarina-lang 支持创建和读取 YAML 格式的语言文件。当然首先你需要额外安装 tarina[yaml]

然后通过 tarina-lang create XXX --yaml 创建 .yml 文件

一个 yaml 格式的语言文件如下所示：

# $schema: .lang.schema.json
example:
  test: Test
  test1:
    test2: Test2

之后，在 plugin 里面，你可以用如下方法来使用i18n条目：

from .i18n import lang

...
async def _():
    await matcher.send(lang.require("example", "test"))  # Test
    await matcher.send(lang.require("example", "test1.test2"))  # Test2

高级一点，你可以通过 tarina-lang model 来生成一个模型文件：

📦 awesome-bot
├──📂 i18n
│  ├── __init__.py
│  ├── .config.json
│  ├── .lang.schema.json
│  ├── .template.json
│  ├── .template.schema.json
│  ├── en-US.json
++ ├── model.py
│  └── zh-CN.json
├── plugin.py
└── ...

其中 model.py:

from tarina.lang.model import LangItem, LangModel


class ExampleTest1:
    test2: LangItem = LangItem("example", "test1.test2")


class Example:
    test: LangItem = LangItem("example", "test")
    test1: ExampleTest1


class Lang(LangModel):
    example = Example

之后便可以这样使用：

from .i18n import Lang

...
async def _():
    await matcher.send(Lang.example.test())
    # 如果你的条目是模板字符串，你可以使用 Lang.example.test(...)
    await matcher.send(Lang.example.test1.test2())

基于此，I18n 和 AlconnaMatcher.i18n 可以如下使用：

await AlconnaMatcher.send(UniMessage.i18n(Lang.example.test, ...))
await AlconnaMatcher.send(UniMessage.i18n("example", "test", ...))
await AlconnaMatcher.send(AlconnaMatcher.i18n(Lang.example.test1.test2, ...))
await AlconnaMatcher.send(AlconnaMatcher.i18n("example", "test1.test2", ...))

Note

在 plugin-alconna 中, i18n 条目会先被转换成 UniMessageTemplate
所以 UniMessageTemplate 的所有特性都可用于 i18n 条目
例如：

# example.test: "{:At(user, $event.get_user_id())} Hello!"
await XXX.send(XXX.i18n("example", "test"))

特别的，因为 I18n 是一个通用消息段，所以 i18n 条目可以嵌套：

{
  "example": {
    "test": "XXXX",
    "foo": "{:I18n(example, test)}, XXXX!"
  }
}

Full Changelog: v0.45.4...v0.46.0

---

This discussion was created from the release Nonebot Plugin Alconna 0.46.0.

[Agnes4m]

看不懂喵，有没有使用的插件案例或者demo，

[Agnes4m]

启动了确定没问题的，感觉就是指令不对

[RF-Tar-Railt]

日志等级开trace看看

[Agnes4m]

[RF-Tar-Railt]

，，，，是 switch 不是 swich

[Agnes4m]

ok，没问题了，是我输入错误的原因

[Agnes4m]

使用model方式后，是否只需要修改model.py而可以无视.lang.schema.json的修改

[RF-Tar-Railt]

model和schema的更新只有template修改后才需要

[Agnes4m]

意思就是，如果我需要新增或者删除字段，只需要修改template，然后再自动生成model或者schema，对吗

[RF-Tar-Railt]

意思就是，如果我需要新增或者删除字段，只需要修改template，然后再自动生成model或者schema，对吗

对

[Agnes4m]

如何在文件中使用i18n翻译后的文字？
我在使用jinja渲染时遇到问题，

• LangItem对象并不能作为str输出，因此jinja模板后，html里会变成类似<tarina.lang.model.LangItem object at 0x000001CB67712AE0>的值
• str()也一样返回类似上面的值而不是文字
• 字段scope和type只能返回上层分类的值
• 以__call__()方式会报错如下

    print(Lang.nbp_vrc.words.online.__call__())
  File "d:\截图\其他文件\workspace\.venv\Lib\site-packages\tarina\lang\model.py", line 20, in __call__
    return lang.require(self.scope, self.type, locale).format(**format_kwargs)
  File "d:\截图\其他文件\workspace\.venv\Lib\site-packages\tarina\lang\__init__.py", line 304, in require
    raise ValueError(self.__langs[locale]["lang"]["error.type"].format(target=type, locale=locale, scope=scope))
ValueError: 'words.online' 在 'zh-CN:nbp_vrc' 不是合法的类型

[RF-Tar-Railt]

LangItem 就是直接像 Lang.nbp_vrc.words.online() 这样用的

至于这个报错得看你语言文件了

[Agnes4m]

确实是我语言文件写错了，不好意思