现代化的 Python unittest HTML 测试报告生成器
Project description
HTMLTestRunner Lit 🎨
现代化的 Python unittest HTML 测试报告生成器
📸 预览
✨ 特性
- 🎨 Bootstrap 5 + ECharts 5 现代 UI 设计
- 🌓 深色/浅色主题 一键切换
- 📱 响应式设计 完美支持移动端
- 📊 环形图表 可视化展示通过率
- 📋 测试详情 支持复制、展开/折叠
- 🧪 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 HTMLTestRunner
# 创建测试套件
suite = unittest.TestLoader().loadTestsFromTestCase(YourTestCase)
# 生成报告
with open('report.html', 'wb') as f:
runner = HTMLTestRunner(
stream=f,
title='API 测试报告',
description='项目接口自动化测试',
tester='QA Team'
)
runner.run(suite)
自定义配置
runner = HTMLTestRunner(
stream=f,
title='测试报告',
description='项目描述',
tester='测试人员',
verbosity=2,
open_in_browser=True # 测试完成后自动打开报告
)
🎨 主题配置
支持深色和浅色两种主题,用户可以在报告中手动切换。
📊 报告内容
- 测试概览: 总数、通过、失败、错误、跳过统计
- 可视化图表: 通过率环形图
- 详细结果: 每个测试用例的执行详情
- 错误追踪: 完整的错误堆栈信息
- 执行时间: 每个用例的执行耗时
🔧 API 参考
HTMLTestRunner
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| stream | file | - | 输出文件流 |
| title | str | "Unit Test Report" | 报告标题 |
| description | str | "" | 报告描述 |
| tester | str | "QA Team" | 测试人员 |
| verbosity | int | 1 | 详细程度 |
| open_in_browser | bool | False | 测试完成后自动打开报告 |
📝 更新日志
v1.0.4
- 🎨 全新 Bootstrap 5 + ECharts 5 UI
- 🌓 深色/浅色主题切换
- 📱 响应式设计,完美支持移动端
- 📊 环形图表可视化展示通过率
- 🧪 完整支持 subTest 子测试用例
- 📋 测试详情支持复制、展开/折叠
- 🚀 支持
open_in_browser自动打开报告 - 👤 支持自定义
tester测试人员
📄 许可证
本项目采用 MIT 许可证。
🤝 贡献
欢迎提交 Issue 和 Pull Request!
⭐ Star History
如果这个项目对你有帮助,请给一个 Star ⭐
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file htmltestrunner_lit-1.0.4.post1.tar.gz.
File metadata
- Download URL: htmltestrunner_lit-1.0.4.post1.tar.gz
- Upload date:
- Size: 18.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e352ff51a4729ca5228ff0d46668a8dd10ad19af0c862ff2d031715063679e30
|
|
| MD5 |
8aceb561a56e00403eb6e79d79fa530a
|
|
| BLAKE2b-256 |
de16c09336e196043d01302ec72a86f64fa2259e7a2f6bfb0f2c12ad5d53ba58
|
File details
Details for the file htmltestrunner_lit-1.0.4.post1-py3-none-any.whl.
File metadata
- Download URL: htmltestrunner_lit-1.0.4.post1-py3-none-any.whl
- Upload date:
- Size: 16.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ca75963ec1666fdbc6c4d17f3622f72eb5ee77e3c66d01c4e9fd36691e85d11
|
|
| MD5 |
5f982c283bc681864679cc5ef00fb310
|
|
| BLAKE2b-256 |
73945fba8053331bf34e54dcadab7ec0de34376d1af3cf6f8a3be724d8efdc03
|