forked from bot/app
98 lines
1.9 KiB
Markdown
98 lines
1.9 KiB
Markdown
---
|
|
title: liteyuki.message.matcher
|
|
---
|
|
### **class** `Matcher`
|
|
### *method* `__init__(self, rule: Rule, priority: int, block: bool)`
|
|
|
|
|
|
|
|
**Description**: 匹配器
|
|
|
|
**Arguments**:
|
|
> - rule: 规则
|
|
> - priority: 优先级 >= 0
|
|
> - block: 是否阻断后续优先级更低的匹配器
|
|
|
|
|
|
<details>
|
|
<summary> <b>Source code</b> </summary>
|
|
|
|
```python
|
|
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] = []
|
|
```
|
|
</details>
|
|
|
|
### *method* `handle(self) -> Callable[[EventHandler], EventHandler]`
|
|
|
|
|
|
|
|
**Description**: 添加处理函数，装饰器
|
|
|
|
**Return**: 装饰器 handler
|
|
|
|
|
|
<details>
|
|
<summary> <b>Source code</b> </summary>
|
|
|
|
```python
|
|
def handle(self) -> Callable[[EventHandler], EventHandler]:
|
|
"""
|
|
添加处理函数，装饰器
|
|
Returns:
|
|
装饰器 handler
|
|
"""
|
|
|
|
def decorator(handler: EventHandler) -> EventHandler:
|
|
self.handlers.append(handler)
|
|
return handler
|
|
return decorator
|
|
```
|
|
</details>
|
|
|
|
### *async method* `run(self, event: MessageEvent) -> None`
|
|
|
|
|
|
|
|
**Description**: 运行处理函数
|
|
|
|
**Arguments**:
|
|
> - event:
|
|
|
|
|
|
<details>
|
|
<summary> <b>Source code</b> </summary>
|
|
|
|
```python
|
|
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()
|
|
```
|
|
</details>
|
|
|
|
### ***var*** `EventHandler = Callable[[MessageEvent], Coroutine[None, None, Any]]`
|
|
|
|
- **Type**: `TypeAlias`
|
|
|