Nonebot Plugin Alconna 0.25.0

[RF-Tar-Railt]

新增

• on_alconna 等新增参数 message_provider，其可用于自定义命令消息的获取方式（例如从非消息事件中提前信息构造消息）：

   def recall_msg_provider(rule, event, state, bot):
       if not isinstance(event, GroupMessageDeleteEvent):
           return None
       return UniMessage(f"/recall {str(event.group_id)} {str(event.user_id)} {str(event.message_id)}")
  
   recall = on_alconna(
       Alconna( "/recall", Args["group_id", str]["user_id", str]["message_id", int]),
       message_provider=recall_msg_provider,
   )

• assign 等新增参数 additional ，其可用于添加额外的判断条件 (例如权限判断)：

   def permission_checker(permission: str):
   
       async def wrapper(event, bot, state, arp):
           return await check_perm(event, permission)
       return wrapper
   
   group = on_alconna(
       Alconna(
           "group",
           Option("add", Args["group_id", int]["name", str]),
           Option("remove", Args["group_id", int]),
           Option("list"),
       ),
   )
   
   @group.assign("add", additional=permission_checker("group.add"))
   async def group_add(group_id: int, name: str):
       await group.finish(f"add {group_id} {name}")
   
   @group.assign("remove", additional=permission_checker("group.remove"))
   async def group_remove(group_id: int):
       await group.finish(f"remove {group_id}")

改进

• on_alconna 不再只匹配 type 为 message 的事件
• assign, got_path 等的 path 参数现在支持 ~XXX 语法，其会把 ~ 替换为可能的父级路径：

   pip = Alconna(
       "pip",
       Subcommand(
           "install",
           Args["pak", str],
           Option("--upgrade|-U"),
           Option("--force-reinstall"),
       ),
       Subcommand("list", Option("--out-dated")),
   )
   
   pipcmd = on_alconna(pip)
   pip_install_cmd = pipcmd.dispatch("install")
   
   
   @pip_install_cmd.assign("~upgrade")
   async def pip1_u(pak: Query[str] = Query("~pak")):
       await pip_install_cmd.finish(f"pip upgrading {pak.result}...")

修复

• 修复 got_path 中 Union 失效的问题

Full Changelog: v0.24.0...v0.25.0

---

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