LiteyukiBot/docs/en/dev/api/message/matcher.md

title
liteyuki.message.matcher

class Matcher

method __init__(self, rule: Rule, priority: int, block: bool)

Description: 匹配器

Arguments:

• rule: 规则
• priority: 优先级 >= 0
• block: 是否阻断后续优先级更低的匹配器

Source code

def __init__(self, rule: Rule, priority: int, block: bool):
    """
        匹配器
        Args:
            rule: 规则
            priority: 优先级 >= 0
            block: 是否阻断后续优先级更低的匹配器
        """
    self.rule = rule
    self.priority = priority
    self.block = block
    self.handlers: list[EventHandler] = []

method handle(self) -> Callable[[EventHandler], EventHandler]

Description: 添加处理函数，装饰器

Return: 装饰器 handler

Source code

def handle(self) -> Callable[[EventHandler], EventHandler]:
    """
        添加处理函数，装饰器
        Returns:
            装饰器 handler
        """

    def decorator(handler: EventHandler) -> EventHandler:
        self.handlers.append(handler)
        return handler
    return decorator

async method run(self, event: MessageEvent) -> None

Description: 运行处理函数

Arguments:

• event:

Source code

async def run(self, event: MessageEvent) -> None:
    """
        运行处理函数
        Args:
            event:
        Returns:
        """
    if not await self.rule(event):
        return
    for handler in self.handlers:
        try:
            await handler(event)
        except Exception:
            traceback.print_exc()

var EventHandler = Callable[[MessageEvent], Coroutine[None, None, Any]]

• Type: TypeAlias