Nonebot Plugin Alconna 0.19.0

破坏性改动

• adapters.__init__ 内的内容移动至 ./uniseg.py
• 移除 SegMatch 相关内容

新增

• on_alconna 增加参数 use_cmd_start, 以便局部使用nb配置里的命令前缀 (前提是命令本体没有手动传入前缀)
• 新增通用标记 Other, 用于标记所有特殊类型
• 新增依赖注入函数 UniversalMessage ( Annotated 版本为 UniMsg)，返回类似于 Message 的 UniMessage
• 新增类 UniMessage, 其与 Message 类似，但操作类型为 Segment:

  from nonebot_plugin_alconna import UniMsg, Reply, Image, At
  ...
  matcher = on_xxx(...)
  @matcher.handle()
  async def _(msg: UniMsg):
      reply = msg[Reply, 0]  # type: Reply
      ats = msg.get(At)  # type: UniMessage[At]
      await matcher.send(f"{reply}{ats}")
      if msg.has(Image):
        for img in msg[Image, 1:]:
            await matcher.send(img.url)
      await matcher.finish(msg.extract_plain_text())

Full Changelog: v0.18.1...v0.19.0

Nonebot Plugin Alconna 0.18.1

• 修改部分名称与类型错误

Full Changelog: v0.18.0...v0.18.1

Nonebot Plugin Alconna 0.18.0

• 在 discord 适配中增加了一个函数 translate，用于将 Alconna 对象转为 discord 适配器中 on_slash_command 的创建结构
  若原先的命令结构如下：

  from nonebot.adapters.discord.api import (
      IntegerOption,
      NumberOption,
      StringOption,
      SubCommandOption,
      UserOption,
  )
  from nonebot.adapters.discord.commands import on_slash_command
  	
  matcher = on_slash_command(
      name="permission",
      description="权限管理",
      options=[
          SubCommandOption(
              name="add",
              description="添加",
              options=[
                  StringOption(
                      name="plugin",
                      description="插件名",
                      required=True,
                  ),
                  IntegerOption(
                      name="priority",
                      description="优先级",
                      required=False,
                  ),
              ],
          ),
          SubCommandOption(
              name="remove",
              description="移除",
              options=[
                  StringOption(name="plugin", description="插件名", required=True),
                  NumberOption(name="time", description="时长", required=False),
              ],
          ),
          SubCommandOption(
              name="ban",
              description="禁用",
              options=[
                  UserOption(name="user", description="用户", required=False),
              ],
          ),
      ],
  )

  则使用 translate 后可以改为：

  from arclet.alconna import Args, Option, Alconna, CommandMeta
  
  from nonebot_plugin_alconna.adapters.discord import MentionUser, translate
  	
  matcher = translate(
      Alconna(
          "permission",
          Option("add", Args["plugin#插件名", str]["priority?#优先级", int]),
          Option("remove", Args["plugin#插件名", str]["time?#时长", float]),
          Option("ban", Args["user?#用户", MentionUser]),
          meta=CommandMeta("权限管理"),
      )
  )

Full Changelog: v0.17.0...v0.18.0

Nonebot Plugin Alconna 0.17.0

• 新增配置项 alconna_use_param, 表示是否使用特制的 Param 提供更好的依赖注入，默认为 True
• 若开启 use_param, AlconnaMatcher 下的响应器对于如下参数皆不再需要依赖注入：
  • CommandResult
  • Arparma
  • Alconna
  • Duplication
  • Match
  • Query
  • AlconnaArg
  • arg in args
    示例：

   async def handle(
       result: CommandResult,
       arp: Arparma,
       dup: Duplication,  # 此处可以是基类及其任意子类
       source: Alconna,
       abc: str,  # 类似 Match, 但是若匹配结果不存在对应字段则跳过该 handler
       foo: Match[str],
       bar: Query[int] = Query("ttt.bar", 0)  # Query 仍然需要一个默认值来传递 path 参数
   ):
   ...

  而倘若需要在 Match 和 Query 处使用 middleware，你仍可以改回原来的依赖注入写法

Full Changelog: v0.16.0...v0.17.0

Nonebot Plugin Alconna 0.16.0

变更

• 增加 Command 便捷命令创建器:

   book = (
       Command("book", "测试")
       .option("writer", "-w <id:int>")
       .option("writer", "--anonymous", {"id": 0})
       .usage("book [-w <id:int> | --anonymous]")
       .shortcut("测试", {"args": ["--anonymous"]})
       .build()
   )
   
   
   @book.handle()
   async def test1_h(arp: Arparma = AlconnaMatches()):
       await book.send(str(arp.options))

Full Changelog: v0.15.0...v0.16.0

Nonebot Plugin Alconna 0.15.0

What's Changed

• Alconna 依赖升级至 1.7.17
• 新增适配器: Discord (https://github.com/nonebot/plugin-alconna/tree/master/src/nonebot_plugin_alconna/adapters/discord.py)
• 为Reply添加Discord和Kaiheila适配 by @canxin121 in #3
• AlconnaMatcher 增加方法 shortcut() 作为 Alconna.shortcut 的快捷调用

New Contributors

• @canxin121 made their first contribution in #3

Full Changelog: v0.14.2...v0.15.0

Nonebot Plugin Alconna 0.14.2

新增

• 为 AlconnaMatch 与 AlconnaQuery 新增 middleware 参数，用于对匹配参数进行自定义处理
• 增加内置 middleware image_fetch ,用于拉取图片参数的二进制数据
• 为 Alconna 下常用组件进行了 re-export

Full Changelog: v0.14.1...v0.14.2

Nonebot Plugin Alconna 0.14.1

• segmatch 现在支持 Reply 匹配了
• Reply 的 origin 现在包括原始 segment，适配器特定的reply: Model或reply: Message

Full Changelog: v0.14.0...v0.14.1

Nonebot Plugin Alconna 0.14.0

• 新增通用标注 Reply:

   class Reply(Segment):
       id: str
       msg: Optional[str]

• 新增规则 seg_match 与对应的依赖注入 SegMatchMessage 和 SegMatchResult, 用于配合通用标注：

   from nonebot_plugin_alconna import Image, seg_match, SegMatchResult
   
   xxx = on_message(rule=seg_match(Image))
   
   @xxx.handle()
   async def _(image: Image = SegMatchResult(Image)):
       await xxx.send(image.url)

因为nonebot下各适配器对 Reply 元素的处理方式各不相同，同时nonebot既没有约定统一的获取不经过check_tome等的原始消息的接口，也没有统一如MessageEvent.reply的格式，导致此次更新对于获取Reply的内容是毫无帮助的

Full Changelog: v0.13.0...v0.14.0

Nonebot Plugin Alconna 0.13.0

变更

• 增加适配器: Villa

Full Changelog: v0.12.1...v0.13.0