PyQt5+Python-docx实现一键生成测试报告pyqt5入门教程

引言

作为一名测试工程师，你是否经历过手动填写测试报告的痛苦？就像用放大镜在沙地上写诗——费力、易改、还容易被风吹散。

今天，我们将用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 sysfrom PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QDateEdit, QPushButton, QVBoxLayout, QHBoxLayout, QFormLayoutclass 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 Documentfrom datetime import datetime, timedeltadef 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_blocksdef 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”)

模板化样本

测试报告模板（变量占位符版）
&8212;

一、测试基本信息
体系测试环境地址：system_url}}}
项目经理：pm_name}}}
测试经理：tm_name}}}
测试组长：tl_name}}}
测试人员：tester_name}}}

&8212;

二、测试时刻安排
需求评审：需求评审_time}}}
用例设计：用例设计_time}}}
用例执行：用例执行_time}}}
回归测试：回归测试_time}}}
报告编写：报告编写_time}}}

&8212;

三、测试数据统计
| 测试类型 | 用例数 | 缺陷数 | 通过率 |
|&8212;&8212;&8212;-|&8212;&8212;&8211;|&8212;&8212;&8211;|&8212;&8212;&8211;|
| 功能测试 | func_cases}}} | func_bugs}}} | func_pass_rate}}} |
| 回归测试 | regression_cases}}} | regression_bugs}}} | reg_pass_rate}}} |

&8212;

四、测试重点拎出来说
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生成测试报告内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

无论兄弟们可能感兴趣的文章:

Python实现自动发送测试报告邮件的示例代码
allure结合python生成测试报告教程
python自动化之怎样利用allure生成测试报告
Python unittest生成测试报告经过解析
Python TestSuite生成测试报告经过解析
python自动发送测试报告邮件功能的实现

阳光网