HTMLTestRunner Lit 🎨

现代化的 Python unittest HTML 测试报告生成器

📸 预览

✨ 特性

• 🎨 Bootstrap 5 + ECharts 5 现代 UI 设计
• 🌓 深色/浅色主题 一键切换
• 📸 截图支持 自动捕获 Selenium 截图，支持轮播/网格预览
• 📱 响应式设计 完美支持移动端
• 📊 环形图表 可视化展示通过率
• 📋 测试详情 支持复制、展开/折叠
• 🧪 subTest 支持 完整支持子测试用例
• 🎯 自定义配色 支持自定义主题颜色
• 🚀 自动打开 测试完成后自动打开报告

🚀 安装

方式 1：从 PyPI 安装（推荐）

pip install htmltestrunner-lit

方式 2：从 GitHub 安装

pip install git+https://github.com/Aquarius-0455/HTMLTestRunner-Lit.git

方式 3：克隆后本地安装

git clone https://github.com/Aquarius-0455/HTMLTestRunner-Lit.git
cd HTMLTestRunner-Lit
pip install -e .

📖 使用方法

基础用法

import unittest
from htmltestrunner import HTMLTestRunnerLit

# 创建测试套件
suite = unittest.TestLoader().loadTestsFromTestCase(YourTestCase)

# 生成报告
with open('report.html', 'wb') as f:
    runner = HTMLTestRunnerLit(
        stream=f,
        title='API 测试报告',
        description='项目接口自动化测试',
        tester='QA Team'
    )
    runner.run(suite)

自定义配置

runner = HTMLTestRunnerLit(
    stream=f,
    title='测试报告',
    description='项目描述',
    tester='测试人员',
    verbosity=2,
    open_in_browser=True  # 测试完成后自动打开报告
)

📸 截图功能

在测试用例中导入并调用 attach_screenshot 即可将截图添加到报告中。

import unittest
from selenium import webdriver
from htmltestrunner import attach_screenshot

class TestDemo(unittest.TestCase):
    def setUp(self):
        self.driver = webdriver.Chrome()

    def test_example(self):
        self.driver.get("https://www.baidu.com")

        # 关键步骤：调用 attach_screenshot 并传入 driver 对象
        attach_screenshot(self.driver, "页面截图描述")

    def tearDown(self):
        self.driver.quit()

🎨 主题配置

支持深色和浅色两种主题，用户可以在报告中手动切换。

📊 报告内容

• 测试概览: 总数、通过、失败、错误、跳过统计
• 可视化图表: 通过率环形图
• 详细结果: 每个测试用例的执行详情
• 错误追踪: 完整的错误堆栈信息
• 执行时间: 每个用例的执行耗时

🔧 API 参考

HTMLTestRunnerLit

📝 更新日志

v1.0.6

• 🔄 将 HTMLTestRunner 重命名为 HTMLTestRunnerLit，解决命名冲突问题

v1.0.5

• 📸 新增截图轮播与网格视图，支持多图自动切换
• 🔍 优化大图预览体验，支持键盘/点击左右切换
• 🎨 全新 Bootstrap 5 + ECharts 5 UI
• 🌓 深色/浅色主题切换
• 📱 响应式设计，完美支持移动端
• 📊 环形图表可视化展示通过率
• 🧪 完整支持 subTest 子测试用例
• 📋 测试详情支持复制、展开/折叠
• 🚀 支持 open_in_browser 自动打开报告
• 👤 支持自定义 tester 测试人员

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

⭐ Star History

如果这个项目对你有帮助，请给一个 Star ⭐