一线测试总监教你简单用python自动化生成测试报告

前言

日常测试当中常常要将测试结果输出为报告文档公之于众，如果能将报告文档生成的过程自动化实现，效率的提升无疑是可观的。

针对这一项，我们了解并尝试通过python中的docx模块进行word文档自动化生成，在这里将基本方法与实现过程分享一下。

由于使用的是python3，实践过程中发现，如果直接使用pip命令安装模块：

pip install docx

import模块会因版本问题报错，应前往：https://www.lfd.uci.edu/~gohlke/pythonlibs/下载最新的python_docx-0.8.10-py2.py3-none-any.whl再卸载原版本并重新安装此whl文件：

pip uninstall docx

此时再次尝试import docx则不再有报错提示，即安装成功。

安装成功后，则可以开始着手根据格式、内容需求来生成文档，下面根据文档生成过程中的一些要素来介绍一些docx模块的基本方法。

首先是创建空白文档，其后的所有操作都需要基于文档对象document来进行操作：

from docx import Document

其次则是为文档添加标题、段落这样的基本元素：

document.add_heading('This is my title', 1)    #添加1级标题

但以此方式添加的标题、段落，其格式只能为docx模块默认格式且内容不易修改，实践中采取了一种更为灵活的方式：

head = document.add_heading(level=1)              #添加标题

由此，使用run对象进行内容追加，即可于后续直接对其字体等文字属性进行修改，例如：

run.font.name = fontName                           #设置英文字体

而关于字号、加粗、颜色等其他属性的设置方式和字体设置类似，此处以一个集成函数为例：

from docx.shared import Inches, Pt, RGBColor, Cm

同样的，也可以修改段落相关属性以契合预期表现效果：

from docx.enum.text import WD_ALIGN_PARAGRAPH

在完善了文档中文字、段落的格式之后，还需要针对测试报告中不可或缺的图片与表格进行添加与设置:

# 添加图片并居中，'pic.png'为相对路径，width为图片相对大小

# 添加表格，rows和cols为行列数、Table Grid为实体边框样式

最后，考虑到文档的整体样式，可以对其页面进行设置：

#页面设置,A4,窄边距

先来列举两个实现过程中的问题以作示例，继而对文档自动化生成的整体思路进行引申。

其一，报告内容中存在着多处需要加粗或改变字体的文字，那么如何便捷地适配每处文字的具体表现呢？此处的方案是先预设一些‘关键词’如：'V5.1'、'高端机'等，再组成适配re.split()的正则表达式去对报告内容进行分割与设置：

# 根据预设关键词拼接正则表达式

其二，考虑到表格着存在不同形式的合并需求，那么如何使其合并方式自动化地适配数据呢？此处的方案为在预设表格数据时，将合并的表格内数据重复写一次，即：

#表格数据——“评测项目”首行1-2列合并则写了2次、”对比产品“首列5-8行合并写了4次

其后于脚本的表格输出方法中，直接根据所读取到的重复数据项分布方式来决定表格的合并形式，如首行1-2列数据重复，则：

table.cell(0, 0).merge(table.cell(0, 1))

由以上两个问题进行举一反三，实际上整篇文档均是采取了预设数据、读取数据、输出数据这样的流程进行生成的，其中预设数据指的是：

而数据读取环节，则是去遍历content_data.items()中的内容，由此找到报告文档中每一小节中对应的预设内容，再去根据内容标识进行区分使用对应的方法进行数据输出：

对面试经验、软件、接口、自动化测试感兴趣可以175317069，群内会有不定期的免费资料链接发放。如果你有好的学习资料可以私聊发我，我会注明出处之后分享给大家。

综上，自动化测试报告生成脚本便完成了，在其后的版本迭代过程中只需更改预设数据中的内容，不同样式或内容的报告即可自动生成，希望本文对大家有所帮助。

最后编辑于：2020.07.16 15:30:16