Files
NeoBot/tests/test_bot.py
baby2016 651d982e19 更新/help (#31)
* 滚木

* feat: 重构核心架构,增强类型安全与插件管理

本次提交对核心模块进行了深度重构,引入 Pydantic 增强配置管理的类型安全性,并全面优化了插件管理系统。

主要变更详情:

1. 核心架构与配置
   - 重构配置加载模块:引入 Pydantic 模型 (`core/config_models.py`),提供严格的配置项类型检查、验证及默认值管理。
   - 统一模块结构:规范化模块导入路径,移除冗余的 `__init__.py` 文件,提升项目结构的清晰度。
   - 性能优化:集成 Redis 缓存支持 (`RedisManager`),有效降低高频 API 调用开销,提升响应速度。

2. 插件系统升级
   - 实现热重载机制:新增插件文件变更监听功能,支持开发过程中自动重载插件,提升开发效率。
   - 优化生命周期管理:改进插件加载与卸载逻辑,支持精确卸载指定插件及其关联的命令、事件处理器和定时任务。

3. 功能特性增强
   - 新增媒体 API:引入 `MediaAPI` 模块,封装图片、语音等富媒体资源的获取与处理接口。
   - 完善权限体系:重构权限管理系统,实现管理员与操作员的分级控制,支持更细粒度的命令权限校验。

4. 代码质量与稳定性
   - 全面类型修复:解决 `mypy` 静态类型检查发现的大量类型错误(包括 `CommandManager`、`EventFactory` 及 `Bot` API 签名不匹配问题)。
   - 增强错误处理:优化消息处理管道的异常捕获机制,完善关键路径的日志记录,提升系统运行稳定性。

* feat: 添加测试用例并优化代码结构

refactor(permission_manager): 调整初始化顺序和逻辑
fix(admin_manager): 修复初始化逻辑和目录创建问题
feat(ws): 优化Bot实例初始化条件
feat(message): 增强MessageSegment功能并添加测试
feat(events): 支持字符串格式的消息解析
test: 添加核心功能测试用例
refactor(plugin_manager): 改进插件路径处理
style: 清理无用导入和代码
chore: 更新依赖项

* refactor(handler): 移除TYPE_CHECKING并直接导入Bot类

简化类型注解,直接导入Bot类而非使用TYPE_CHECKING条件导入,提高代码可读性和维护性

* fix(command_manager): 修复插件卸载时元信息移除不精确的问题

修复 CommandManager 中 unload_plugin 方法移除插件元信息时使用 startswith 导致可能误删其他插件的问题,改为精确匹配
同时调整相关测试用例验证精确匹配行为

* refactor: 清理未使用的导入和更新文档结构

docs: 添加config_models.py到项目结构文档
docs: 调整数据目录位置到core/data下
docs: 更新权限管理器文档描述

* 文档更新

* 更新thpic插件 支持一次返回多张图

* feat: 添加测试覆盖率并修复相关问题

refactor(redis_manager): 移除冗余的ConnectionError处理
refactor(event_handler): 优化Bot类型注解
refactor(factory): 移除未使用的GroupCardNoticeEvent

test: 添加全面的单元测试覆盖
- 添加test_import.py测试模块导入
- 添加test_debug.py测试插件加载调试
- 添加test_plugin_error.py测试错误处理
- 添加test_config_loader.py测试配置加载
- 添加test_redis_manager.py测试Redis管理
- 添加test_bot.py测试Bot功能
- 扩展test_models.py测试消息模型
- 添加test_plugin_manager_coverage.py测试插件管理
- 添加test_executor.py测试代码执行器
- 添加test_ws.py测试WebSocket
- 添加test_api.py测试API接口
- 添加test_core_managers.py测试核心管理模块

fix(plugin_manager): 修复插件加载日志变量问题

覆盖率已到达86%(忽略插件)

* 更新/help指令,现在会发送图片

---------

Co-authored-by: K2cr2O1 <2221577113@qq.com>
Co-authored-by: 镀铬酸钾 <148796996+K2cr2O1@users.noreply.github.com>
2026-01-10 20:39:52 +08:00

128 lines
5.6 KiB
Python

import pytest
from unittest.mock import MagicMock, AsyncMock, patch
from models.message import MessageSegment
from models.objects import GroupInfo, StrangerInfo
from core.bot import Bot
class TestBot:
def test_bot_initialization(self):
"""测试 Bot 类初始化。"""
mock_ws = MagicMock()
mock_ws.self_id = 123456
bot = Bot(mock_ws)
assert bot.self_id == 123456
assert bot.code_executor is None
def test_build_forward_node(self):
"""测试构建合并转发消息节点。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
node = bot.build_forward_node(123456, "TestUser", "Hello World")
assert node["type"] == "node"
assert node["data"]["uin"] == 123456
assert node["data"]["name"] == "TestUser"
assert node["data"]["content"] == "Hello World"
def test_build_forward_node_with_segment(self):
"""测试使用消息段构建合并转发消息节点。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
segment = MessageSegment.text("Hello")
node = bot.build_forward_node(123456, "TestUser", segment)
assert node["type"] == "node"
assert node["data"]["content"][0]["type"] == segment.type
assert node["data"]["content"][0]["data"] == segment.data
def test_build_forward_node_with_segment_list(self):
"""测试使用消息段列表构建合并转发消息节点。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
segments = [MessageSegment.text("Hello"), MessageSegment.at(123456)]
node = bot.build_forward_node(123456, "TestUser", segments)
assert node["type"] == "node"
assert len(node["data"]["content"]) == 2
assert node["data"]["content"][0]["type"] == segments[0].type
assert node["data"]["content"][0]["data"] == segments[0].data
assert node["data"]["content"][1]["type"] == segments[1].type
assert node["data"]["content"][1]["data"] == segments[1].data
@pytest.mark.asyncio
async def test_send_forwarded_messages_group(self):
"""测试发送群聊合并转发消息。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
bot.send_group_forward_msg = AsyncMock()
nodes = [bot.build_forward_node(123456, "TestUser", "Hello")]
await bot.send_forwarded_messages(111111, nodes)
bot.send_group_forward_msg.assert_called_once_with(111111, nodes)
@pytest.mark.asyncio
async def test_send_forwarded_messages_private(self):
"""测试发送私聊合并转发消息。"""
mock_ws = AsyncMock()
bot = Bot(mock_ws)
bot.send_private_forward_msg = AsyncMock()
nodes = [bot.build_forward_node(123456, "TestUser", "Hello")]
from models.events.base import OneBotEvent
mock_event = MagicMock(spec=OneBotEvent)
mock_event.group_id = None
mock_event.user_id = 222222
await bot.send_forwarded_messages(mock_event, nodes)
bot.send_private_forward_msg.assert_called_once_with(222222, nodes)
@pytest.mark.asyncio
async def test_send_forwarded_messages_group_event(self):
"""测试通过群聊事件发送合并转发消息。"""
mock_ws = AsyncMock()
bot = Bot(mock_ws)
bot.send_group_forward_msg = AsyncMock()
nodes = [bot.build_forward_node(123456, "TestUser", "Hello")]
from models.events.base import OneBotEvent
mock_event = MagicMock(spec=OneBotEvent)
mock_event.group_id = 111111
mock_event.user_id = 222222
await bot.send_forwarded_messages(mock_event, nodes)
bot.send_group_forward_msg.assert_called_once_with(111111, nodes)
@pytest.mark.asyncio
async def test_send_forwarded_messages_invalid_target(self):
"""测试发送合并转发消息到无效目标。"""
mock_ws = AsyncMock()
bot = Bot(mock_ws)
nodes = [bot.build_forward_node(123456, "TestUser", "Hello")]
from models.events.base import OneBotEvent
mock_event = MagicMock(spec=OneBotEvent)
mock_event.group_id = None
mock_event.user_id = None
with pytest.raises(ValueError, match="Event has neither group_id nor user_id"):
await bot.send_forwarded_messages(mock_event, nodes)
@pytest.mark.asyncio
async def test_get_group_list(self):
"""测试获取群列表。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
# 测试返回字典列表的情况
super_get_group_list = AsyncMock(return_value=[{"group_id": 123456, "group_name": "Test Group"}])
with patch.object(bot.__class__.__bases__[1], 'get_group_list', super_get_group_list):
groups = await bot.get_group_list(no_cache=True)
assert len(groups) == 1
assert groups[0].group_id == 123456
assert groups[0].group_name == "Test Group"
assert isinstance(groups[0], GroupInfo)
@pytest.mark.asyncio
async def test_get_stranger_info(self):
"""测试获取陌生人信息。"""
mock_ws = MagicMock()
bot = Bot(mock_ws)
# 测试返回字典的情况
super_get_stranger_info = AsyncMock(return_value={"user_id": 123456, "nickname": "TestUser", "sex": "male", "age": 18})
with patch.object(bot.__class__.__bases__[2], 'get_stranger_info', super_get_stranger_info):
info = await bot.get_stranger_info(123456, no_cache=True)
assert info.user_id == 123456
assert info.nickname == "TestUser"
assert info.sex == "male"
assert info.age == 18
assert isinstance(info, StrangerInfo)