✨ version 0.16.0

add `Command` which looks like koishi's command

pyproject.toml

@@ -6,8 +6,8 @@ authors = [
 ]
 dependencies = [
     "nonebot2>=2.0.0rc4",
-    "arclet-alconna<2.0.0, >=1.7.17",
-    "arclet-alconna-tools<0.7.0, >=0.6.5",
+    "arclet-alconna<2.0.0, >=1.7.18",
+    "arclet-alconna-tools<0.7.0, >=0.6.6",
     "nepattern<0.6.0, >=0.5.13",
 ]
 dynamic = ["version"]

src/nonebot_plugin_alconna/__init__.py

@@ -43,6 +43,7 @@
 from .params import SegMsg as SegMsg
 from .params import assign as assign
 from .rule import alconna as alconna
+from .matcher import Command as Command
 from .adapters import Segment as Segment
 from .rule import seg_match as seg_match
 from .params import AlcResult as AlcResult
@@ -73,7 +74,7 @@
 from .consts import ALCONNA_EXEC_RESULT as ALCONNA_EXEC_RESULT
 from .rule import set_output_converter as set_output_converter
 
-__version__ = "0.15.0"
+__version__ = "0.16.0"
 
 _meta_source = {
     "name": "Alconna 插件",

src/nonebot_plugin_alconna/matcher.py

@@ -10,8 +10,8 @@
 from nepattern import AnyOne, AnyString
 from nonebot.permission import Permission
 from nonebot.dependencies import Dependent
-from arclet.alconna.tools import AlconnaFormat
 from tarina import is_awaitable, run_always_await
+from arclet.alconna.tools import AlconnaFormat, AlconnaString
 from arclet.alconna.tools.construct import FuncMounter, MountConfig
 from arclet.alconna import Arg, Args, Alconna, ShortcutArgs, command_manager
 from nonebot.typing import T_State, T_Handler, T_RuleChecker, T_PermissionChecker
@@ -293,3 +293,30 @@ async def handle(bot: Bot, event: Event, results: AlcExecResult):
         return matcher
 
     return wrapper
+
+
+class Command(AlconnaString):
+    def build(
+        self,
+        rule: Rule | T_RuleChecker | None = None,
+        skip_for_unmatch: bool = True,
+        auto_send_output: bool = False,
+        output_converter: TConvert | None = None,
+        aliases: set[str] | tuple[str, ...] | None = None,
+        comp_config: CompConfig | None = None,
+        use_origin: bool = False,
+        permission: Permission | T_PermissionChecker | None = None,
+        *,
+        handlers: list[T_Handler | Dependent] | None = None,
+        temp: bool = False,
+        expire_time: datetime | timedelta | None = None,
+        priority: int = 1,
+        block: bool = False,
+        state: T_State | None = None,
+        _depth: int = 0,
+    ):
+        params = locals()
+        params.pop("self")
+        params.pop("__class__")
+        alc = super().build()
+        return on_alconna(alc, **params)

src/test/plugins/demo.py

@@ -25,6 +25,7 @@
     Match,
     Query,
     Reply,
+    Command,
     AlconnaArg,
     AlconnaMatch,
     AlconnaQuery,
@@ -192,7 +193,11 @@ async def bind_handle(reply: Reply = SegMatchResult(Reply)):
 
 
 mask_cmd = on_alconna(
-    Alconna("设置词云形状", Args["img?", Image], Option("--default", action=store_true))
+    Alconna(
+        "设置词云形状",
+        Args["img?", Image],
+        Option("--default", action=store_true, default=False),
+    ),
 )
 
 mask_cmd.shortcut(
@@ -217,3 +222,17 @@ async def mask_g(
         await mask_cmd.send(f"img: {img[:10]}")
     else:
         await mask_cmd.send("ok")
+
+
+book = (
+    Command("book", "测试")
+    .option("writer", "-w <id:int>")
+    .option("writer", "--anonymous", {"id": 0})
+    .usage("book [-w <id:int> | --anonymous]")
+    .build()
+)
+
+
+@book.handle()
+async def test1_h(arp: Arparma = AlconnaMatches()):
+    await book.send(str(arp.options))