如何用unittest帮你快速生成自动化测试报告？

一直以来很多使用 python+unittest 做自动化测试的的小伙伴都在想，unittest 这个官方库为什么没有直接生成测试报告的方法，自己在网上找的一些生成报告的开源的模块，生成的报告样式大都不太美观，不太受领导待见。为了解决大家的这个需求，于是小编这两天就自己专门写了一个 unittest 生成测试报告的库（unittestreport），现在已经上传到 PyPi，大家可通过 pip 命令去下载，接下来就给大家分享一下，这个库怎么使用！

一、unittestreport 安装

安装命令：

cmd 命令行下输入下面的命令进行安装

  pip install unittestreport

二、使用说明

话不多说，给大家介绍怎么使用之前，这边先给大家展示一下报告的效果图

报告效果图：

​

1、使用案例

看完之后有木有觉得很高大上，喜欢这个风格报告的小伙伴可以赶紧去安装了！不仅生成的测试报告清新美观，使用起来也非常的简单，接下来就和大家来讲讲如何使用，首先我们先来看一个使用案例

1. import unittest

2. from unittestreport import TestRunner

4. # 第一步：加载测试套件

5. suite1 = unittest.defaultTestLoader.discover(r"xxx\xxx\cases")

6. # 第二步：创建运行对象，传入测试套件

7. runner = TestRunner(suite1)

8. # 第三步：执行测试

9. runner.run()

从上面的案例可以看得出来，使用只需要三步，就可以执行测试用例，并且生成一个漂亮的测试报告！

第一步：收集用例

第二步：使用 unittestteport 中的 TestRunner 创建一个运行对象

第三步：执行测试

2、参数解析

接下来给大家详细的介绍一下 TestRunner 的主要使用参数，用户在创建运行对象的时候，除了传入测试套件，还可以自定义报告的标题、描述等相关信息，详细介绍如下：

1. class TestRunner():

2. """unittest运行程序"""

4. def __init__(self, suite: unittest.TestSuite,

5. filename="report.html",

6. report_dir=".",

7. title='测试报告',

8. tester='木森',

9. desc="木森执行测试的报告",

10. templates=1

11. ):

12. """

13. 初始化用例运行程序

14. :param suites: 测试套件

15. :param filename: 报告文件名

16. :param report_dir:报告文件的路径

17. :param title:测试套件标题

18. :param tester:测试者

19. :param desc:相关的描述信息

20. :param templates: 可以通过参数值1或者2，指定报告的样式模板，目前只有两个模板

21. """

3、其他风格报告的整合

很多小伙伴在之前生成测试报告，使用的比较多的是 BeautifulReport 和 HTMLTestRunnerNew 这两个模块，考虑到方便大家使用，该模块除了可以生成上面展示的测试报告，还可以生成 BeautifulReport 风格的测试报告，以及 HTMLTestRunnerNew 的测试报告(这边还是非常感谢这两个开源模块的作者)，那么接下来就给大家说说如何生成这两种风格的报告吧，

（1）BeautifulReport 风格的报告

其实要生成 BeautifulReport 风格的报告，非常简单只需要改一个参数即可，案例及报告效果如下

1. # 创建运行对象的时候加一个参数templates把值设为2即可

2. runner = TestRunner(suite1，templates=2)

​

（2）HTMLTestRunnerNew 风格报告

关于 HTMLTestRunnerNew，小编这边直接把源码整合了进来，导入进来即可使用，使用的参数不变，案例代码及效果图如下：

1. import unittest

2. from unittestteport import TestRunner,HTMLTestRunner

4. # 第一步：加载测试套件

5. suite1 = unittest.defaultTestLoader.discover(r"xxx\xxx\cases")

6. # 第二步：创建运行对象，传入测试套件

7. runner = HTMLTestRunner(stream=open("report.html",'wb'), title='木森的测试报告',)

8. # 第三步：执行测试

9. runner.run()

​

三、扩展说明

本模块是小编最近开发出来的第一个版本，还没有经过全面的测试，大家在使用的过程中发现有问题，欢迎找小编提 bug，以便对该模块后续的的优化和修改！

另外该模块还支持多线程执行 unittest 测试用例，关于多线程运行的使用和注意点，后续有时间了再给大家介绍！

总结：

感谢每一个认真阅读我文章的人！！！

作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

 

          视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。