Skip to content

JiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.

Python
1.9 KB
Raw Blame

单元测试指南

📋 目录


🔧 安装测试依赖

安装测试依赖

# 方式 1: 使用 pip
pip install -e ".[test]"

# 方式 2: 直接安装测试包
pip install pytest pytest-asyncio pytest-cov pytest-mock coverage freezegun

🏃 本地运行测试

运行所有测试

# 运行所有测试
pytest

# 或者指定目录
pytest tests/

运行特定测试文件

# 运行单个测试文件
pytest tests/unit_tests/test_config.py

# 运行特定目录的测试
pytest tests/unit_tests/

运行特定测试用例

# 运行特定测试函数
pytest tests/unit_tests/test_config.py::TestResolveEnvVars::test_resolve_string_with_env_var

# 运行特定测试类
pytest tests/unit_tests/test_config.py::TestResolveEnvVars

常用测试选项

# 详细输出
pytest -v

# 显示打印输出
pytest -s

# 显示错误堆栈
pytest --tb=long

# 只运行失败的测试
pytest --lf

# 遇到第一个失败就停止
pytest -x

# 并行运行测试(需要安装 pytest-xdist)
pytest -n auto

运行带标记的测试

# 只运行单元测试
pytest -m unit

# 只运行集成测试
pytest -m integration

# 只运行慢速测试
pytest -m slow

# 排除慢速测试
pytest -m "not slow"

📊 测试覆盖率

生成覆盖率报告

# 生成终端报告
pytest --cov=jiuwenswarm --cov-report=term-missing

# 生成 HTML 报告
pytest --cov=jiuwenswarm --cov-report=html

# 生成 XML 报告(用于 CI)
pytest --cov=jiuwenswarm --cov-report=xml

查看覆盖率报告

# 生成 HTML 报告后在浏览器中打开
pytest --cov=jiuwenswarm --cov-report=html
open htmlcov/index.html  # macOS
xdg-open htmlcov/index.html  # Linux