PyQt5+Python-docx实现一键生成测试报告

 更新时间:2025年05月04日 10:02:47   作者:Python测试之道  
作为一名测试工程师,你是否经历过手动填写测试报告的痛苦,本文将用Python的PyQt5和python-docx库,打造一款测试报告一键生成工具,感兴趣的可以了解下

引言

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

今天,我们将用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生成测试报告内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python打印“菱形”星号代码方法

    Python打印“菱形”星号代码方法

    本篇文章通过代码实例给大家详细分析了Python打印“菱形”星号代码方法,对此有需要的朋友参考下吧。
    2018-02-02
  • python去除空格和换行符的实现方法(推荐)

    python去除空格和换行符的实现方法(推荐)

    下面小编就为大家带来一篇python去除空格和换行符的实现方法(推荐)。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • 一个不可思议的Python库vnpy示例详解

    一个不可思议的Python库vnpy示例详解

    这篇文章主要给大家介绍了关于Python库vnpy的相关资料,vn.py是一个开源的Python交易编程框架,支持多种金融产品的交易,提供全流程支持,它具有模块化设计、多语言支持、跨平台、高性能、易用性、社区支持和文档齐全等特性,需要的朋友可以参考下
    2024-11-11
  • Python判断对象是否相等及eq函数的讲解

    Python判断对象是否相等及eq函数的讲解

    今天小编就为大家分享一篇关于Python判断对象是否相等及eq函数的讲解,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-02-02
  • python计算寄送包裹重量的实现过程

    python计算寄送包裹重量的实现过程

    要实现这样一个需求寄送包裹小于5kg,每公斤0.5元,大于等于5kg,超出5公斤部分,按照每公斤0.8元计算,输入重量,输出应付金额,下面小编给大家分享实现代码,感兴趣的朋友跟随小编一起看看吧
    2022-02-02
  • tensorflow-gpu安装的常见问题及解决方案

    tensorflow-gpu安装的常见问题及解决方案

    这篇文章主要介绍了tensorflow-gpu安装的常见问题及解决方案,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友参考下吧,需要的朋友可以参考下
    2020-01-01
  • Python处理日期方法详细大全(30种方法)

    Python处理日期方法详细大全(30种方法)

    这篇文章主要给大家介绍了关于Python处理日期方法详细大全,文中共介绍了30种方法,Python程序能用很多方式处理日期和时间,转换日期格式是一个常见的功能,Python提供了一个time和calendar模块可以用于格式化日期和时间,需要的朋友可以参考下
    2023-12-12
  • Python实现缓存的两个简单方法

    Python实现缓存的两个简单方法

    缓存是一种用于提高应用程序性能的技术,它通过临时存储程序获得的结果,以便在以后需要时重用它们,本文将学习Python中的不同缓存技术,感兴趣的可以了解下
    2024-11-11
  • Python中使用YAML文件进行配置文件管理

    Python中使用YAML文件进行配置文件管理

    配置文件管理已经成为了一个不可或缺的环节。它们包含了程序运行所需的各种参数,本文主要介绍了Python中使用YAML文件进行配置文件管理,感兴趣的可以了解一下
    2023-12-12
  • python中os包的用法

    python中os包的用法

    这篇文章主要介绍了python中os包的用法,文中给大家提到了python中os的常用方法,给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-06-06

最新评论