Files
qqbotsdk/tests/test_intents.py
T
snowy-yang 71cbfdaf5d feat!: intents 只按大类订阅、群消息全量模式与事件流优化
破坏性变更:intents.toml 订阅粒度收敛到 Intents 大类(分组)——
配置从「[分组] 表内逐事件开关」改为「分组名 = true/false」。网关只接受
分组位掩码,组内事件本就无法单独订阅,此前的逐事件开关仅是「组内任一
为 true 即订阅整组」的装饰。旧格式不再兼容,与拼错的分组名、非布尔值
一样在启动时直接抛 ValueError,而非静默少订阅。

新增:
- GROUP_MESSAGE_CREATE 事件接收(群消息全量模式,与 GROUP_AT_MESSAGE_CREATE
  共用 GroupAtMessage);GroupAtMessage 补齐 message_type/message_scene/
  attachments/mentions/ark_data/msg_elements 字段

优化:
- 形参注入缓存化:合并缓存 handler 签名与类型标注解析(此前每条事件都重跑
  inspect.signature/get_type_hints),services 命中改为每条事件实时判定,
  保证「先注册 handler、后登记组件」的既有装配顺序不受影响
- EventQueue.put_event/put_reply 去掉多余的 return await
- model.NoneType 联合成员顺序调整(None 置于末尾)

文档同步 GUIDE/API/README/CHANGELOG 与示例;测试 76 全绿,ruff/pyright 干净。
2026-09-20 21:39:25 +08:00

77 lines
2.2 KiB
Python

import pytest
from qqbotsdk.config import Config
from qqbotsdk.ws_protocol import get_intents
@pytest.fixture(autouse=True)
def env(monkeypatch):
monkeypatch.setenv("APPID", "123")
monkeypatch.setenv("APPSECRET", "s")
monkeypatch.delenv("CONNECTER", raising=False)
monkeypatch.delenv("BASE_URL", raising=False)
def write(tmp_path, content: str) -> str:
path = tmp_path / "intents.toml"
path.write_text(content, encoding="utf-8")
return str(path)
def test_missing_file_returns_zero(tmp_path):
assert get_intents(str(tmp_path / "nope.toml")) == 0
def test_enabled_group_sets_bit(tmp_path):
path = write(tmp_path, "GROUP_AND_C2C_EVENT = true\n")
assert get_intents(path) & (1 << 25)
def test_only_enabled_groups_are_subscribed(tmp_path):
path = write(tmp_path, "GUILDS = true\nINTERACTION = false\nAUDIO_ACTION = true\n")
assert get_intents(path) == (1 << 0) | (1 << 29)
def test_all_disabled_returns_zero(tmp_path):
path = write(tmp_path, "GUILDS = false\nFORUMS_EVENT = false\n")
assert get_intents(path) == 0
def test_unknown_group_raises(tmp_path):
path = write(tmp_path, "NOT_A_GROUP = true\n")
with pytest.raises(ValueError, match="NOT_A_GROUP"):
get_intents(path)
def test_non_bool_value_raises(tmp_path):
path = write(tmp_path, 'GUILDS = "yes"\n')
with pytest.raises(ValueError, match="true/false"):
get_intents(path)
def test_legacy_per_event_switches_are_rejected(tmp_path):
path = write(tmp_path, "[GROUP_AND_C2C_EVENT]\nC2C_MESSAGE_CREATE = true\n")
with pytest.raises(ValueError, match="组内事件开关"):
get_intents(path)
def test_config_load_defaults():
config = Config.load()
assert config.app_id == "123"
assert config.app_secret == "s"
assert config.connecter == "websocket"
assert config.base_url == "https://api.bot.qq.com"
assert config.webhook_port == 8080
def test_config_requires_appid(monkeypatch):
monkeypatch.delenv("APPID", raising=False)
with pytest.raises(ValueError, match="APPID"):
Config.load()
def test_config_rejects_unknown_connecter(monkeypatch):
monkeypatch.setenv("CONNECTER", "carrier-pigeon")
with pytest.raises(ValueError, match="carrier-pigeon"):
Config.load()