PyQt5+Python-docx实现一键生成测试报告
作者：Python测试之道
引言
作为一名测试工程师，你是否经历过手动填写测试报告的痛苦？就像用放大镜在沙地上写诗——费力、易改、还容易被风吹散。
今天，我们将用Python的PyQt5和python-docx库，打造一款测试报告一键生成工具，让你像搭积木一样快速完成报告，像做蛋糕一样优雅分配时间！
工具功能亮点
1.图形化界面交互：你的“乐高积木”
- 通过PyQt5设计的界面，就像一盒五颜六色的乐高积木，
- 每个输入框都是一个模块，轻轻一搭，数据就位！
2.时间智能划分：你的“时间蛋糕”大师
根据测试起止时间，像切蛋糕一样按比例分配需求评审、
用例设计、执行、回归测试及报告编写的时间。
（例如：需求评审10%、用例设计20%…）
3.模板化报告生成：你的“填字游戏”助手
基于python-docx库，像玩填字游戏一样自动填充Word文档，
模板一放，数据自动到位。
4.可扩展性强：你的“建筑蓝图”
代码结构清晰，像建筑蓝图一样模块化，
方便后续集成更多功能（如图表生成、历史记录保存）。
工具设计思路
1. 界面设计：PyQt5实现数据输入
输入字段：
- 系统测试环境地址 → 类比为“快递地址”，确保报告能准确送达。
- 项目经理、测试经理等 → 像“团队角色卡牌”，明确责任分工。
- 测试起止时间 → 类比为“马拉松起点终点”，为时间分配提供基准。
- 用例数与Bug数 → 像“考试成绩表”，直观展示测试成果。
时间智能划分：
- 根据起止时间，按比例分配阶段时间，
- 就像切蛋糕：需求评审（10%）、用例设计（20%）、执行（30%）、
- 回归测试（20%）、报告编写（20%）。每个阶段都有清晰的“时间标签”。
2. 文档生成：python-docx填充模板
模板结构：
- 标题与基本信息 → 类比为“简历封面”，展示项目核心信息。
- 时间安排表 → 像“日程表”，让时间分配一目了然。
- 测试数据统计 → 如“成绩单”，用表格展示用例数、Bug数。
- 测试结论 → 类似“总结发言”，简洁有力。
动态数据填充：
- 通过占位符替换或直接插入段落/表格，
- 像“填字游戏”一样自动填充数据。
工具实现代码
1. 安装依赖
pip install PyQt5 python-docx
2. PyQt5界面代码
import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QDateEdit, QPushButton, QVBoxLayout, QHBoxLayout, QFormLayout
class TestReportTool(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("测试报告一键生成工具")
self.init_ui()
def init_ui(self):
# 表单布局
form_layout = QFormLayout()
# 输入字段（积木模块）
self.system_url = QLineEdit()
self.pm_name = QLineEdit()
self.tm_name = QLineEdit()
self.tl_name = QLineEdit()
self.tester_name = QLineEdit()
self.start_date = QDateEdit()
self.end_date = QDateEdit()
self.func_cases = QLineEdit()
self.func_bugs = QLineEdit()
self.regression_cases = QLineEdit()
self.regression_bugs = QLineEdit()
# 添加字段到表单
form_layout.addRow("系统测试环境地址:", self.system_url)
form_layout.addRow("项目经理:", self.pm_name)
form_layout.addRow("测试经理:", self.tm_name)
form_layout.addRow("测试组长:", self.tl_name)
form_layout.addRow("测试人员:", self.tester_name)
form_layout.addRow("测试起始时间:", self.start_date)
form_layout.addRow("测试结束时间:", self.end_date)
form_layout.addRow("功能测试用例数:", self.func_cases)
form_layout.addRow("功能测试Bug数:", self.func_bugs)
form_layout.addRow("回归测试用例数:", self.regression_cases)
form_layout.addRow("回归测试缺陷数:", self.regression_bugs)
# 生成按钮
self.generate_btn = QPushButton("生成测试报告")
self.generate_btn.clicked.connect(self.generate_report)
# 主布局
main_layout = QVBoxLayout()
main_layout.addLayout(form_layout)
main_layout.addWidget(self.generate_btn)
self.setLayout(main_layout)
def generate_report(self):
# 收集数据
data = {
"system_url": self.system_url.text(),
"pm_name": self.pm_name.text(),
"tm_name": self.tm_name.text(),
"tl_name": self.tl_name.text(),
"tester_name": self.testers_name.text(),
"start_date": self.start_date.date().toString("yyyy-MM-dd"),
"end_date": self.end_date.date().toString("yyyy-MM-dd"),
"func_cases": self.func_cases.text(),
"func_bugs": self.func_bugs.text(),
"regression_cases": self.regression_cases.text(),
"regression_bugs": self.regression_bugs.text(),
}
# 计算时间块并添加到data
time_blocks = calculate_time_blocks(data["start_date"], data["end_date"])
for phase, dates in time_blocks.items():
key = f"{phase}_time"
data[key] = dates
# 计算通过率
func_pass_rate = round((1 - int(data["func_bugs"]) / int(data["func_cases"])) * 100, 2)
data["func_pass_rate"] = f"{func_pass_rate}%"
reg_pass_rate = round((1 - int(data["regression_bugs"]) / int(data["regression_cases"])) * 100, 2)
data["reg_pass_rate"] = f"{reg_pass_rate}%"
# 调用文档生成函数
from docx_generator import generate_docx
generate_docx(data)
print("测试报告生成成功！")
if __name__ == "__main__":
app = QApplication(sys.argv)
window = TestReportTool()
window.show()
sys.exit(app.exec_())
3. Word文档生成代码
from docx import Document
from datetime import datetime, timedelta
def calculate_time_blocks(start_date_str, end_date_str):
start_date = datetime.strptime(start_date_str, "%Y-%m-%d")
end_date = datetime.strptime(end_date_str, "%Y-%m-%d")
total_days = (end_date - start_date).days
if total_days <= 0:
return {}
# 按比例划分阶段（时间蛋糕）
phases = {
"需求评审": 0.1,
"用例设计": 0.2,
"用例执行": 0.3,
"回归测试": 0.2,
"报告编写": 0.2
}
time_blocks = {}
current_date = start_date
for phase, ratio in phases.items():
days = int(total_days * ratio)
end_phase = current_date + timedelta(days=days)
time_blocks[phase] = f"{current_date.strftime('%Y-%m-%d')} - {end_phase.strftime('%Y-%m-%d')}"
current_date = end_phase
return time_blocks
def generate_docx(data):
# 读取模板文档
doc = Document('template.docx') # 假设模板文件为 template.docx
# 替换段落中的占位符
for paragraph in doc.paragraphs:
for key, value in data.items():
if key in paragraph.text:
paragraph.text = paragraph.text.replace(f'{{{key}}}', value) # 使用双大括号包裹
# 替换表格中的占位符
for table in doc.tables:
for row in table.rows:
for cell in row.cells:
for key, value in data.items():
if key in cell.text:
cell.text = cell.text.replace(f'{{{key}}}', value)
# 保存文档
doc.save("TestReport.docx")
模板化样本
# 测试报告模板（变量占位符版）
---
## 一、测试基本信息
系统测试环境地址：{{{system_url}}}
项目经理：{{{pm_name}}}
测试经理：{{{tm_name}}}
测试组长：{{{tl_name}}}
测试人员：{{{tester_name}}}
---
## 二、测试时间安排
需求评审：{{{需求评审_time}}}
用例设计：{{{用例设计_time}}}
用例执行：{{{用例执行_time}}}
回归测试：{{{回归测试_time}}}
报告编写：{{{报告编写_time}}}
---
## 三、测试数据统计
| 测试类型 | 用例数 | 缺陷数 | 通过率 |
|----------|--------|--------|--------|
| 功能测试 | {{{func_cases}}} | {{{func_bugs}}} | {{{func_pass_rate}}} |
| 回归测试 | {{{regression_cases}}} | {{{regression_bugs}}} | {{{reg_pass_rate}}} |
---
## 四、测试结论
{{{test_conclusion}}}
工具使用示例
1.准备模板：
- 创建一个名为 template.docx 的Word文档，内容如上所示的模板样本。
- 确保模板中使用 {{{variable_name}}} 形式的占位符。
2.运行界面：
- 打开工具后，在界面中输入测试数据。
- 点击“生成测试报告”按钮。
3.生成结果：
自动生成名为 TestReport.docx 的Word文档，内容如下：
- 测试基本信息：系统环境、人员信息（简历封面）。
- 测试时间安排：按比例划分的各阶段时间（日程表）。
- 测试数据统计：用表格展示功能测试与回归测试的用例数、缺陷数、通过率（成绩单）。
- 测试结论：简要总结测试结果（总结发言）。
扩展建议
模板自定义：在模板中添加公司Logo、页眉页脚或颜色主题，提升专业度。
数据导出：集成 openpyxl 库，将测试数据导出为Excel表格。
图表生成：使用 matplotlib 生成缺陷趋势图，并嵌入到Word文档中。
历史记录：将用户输入的数据保存为JSON文件，支持历史记录查询。
结语
这款工具的核心在于将重复性工作自动化，让测试工程师专注于测试设计与执行。
通过PyQt5的图形化界面和python-docx的文档生成能力，我们不仅提高了效率，还降低了人为错误的风险。
到此这篇关于PyQt5+Python-docx实现一键生成测试报告的文章就介绍到这了,更多相关PyQt5 Python-docx生成测试报告内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！