1 插件介绍

• pytest-HTML是一个插件，pytest用于生成测试结果的HTML报告；

• 这个插件需要进行安装。

2 pytest-html安装

• 直接使用pip安装即可：

pip  install pytest-html

AI写代码

• 安装信息如下：

2. C:\Users\Administrator>pip install pytest-html

4. Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple

6. Requirement already satisfied: pytest-html in d:\python37\lib\site-packages (2.0.1)

8. Requirement already satisfied: pytest>=5.0in d:\python37\lib\site-packages (from pytest-html) (6.2.4)

10. Requirement already satisfied: pytest-metadata in d:\python37\lib\site-packages (from pytest-html) (1.8.0)

12. Requirement already satisfied: colorama in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (0.4.4)

14. Requirement already satisfied: py>=1.8.2in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (1.10.0)

16. Requirement already satisfied: atomicwrites>=1.0in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (1.4.0)

18. Requirement already satisfied: importlib-metadata>=0.12in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (2.1.1)

20. Requirement already satisfied: pluggy<1.0.0a1,>=0.12in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (0.13.1)

22. Requirement already satisfied: toml in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (0.10.2)

24. Requirement already satisfied: packaging in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (20.8)

26. Requirement already satisfied: iniconfig in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (1.1.1)

28. Requirement already satisfied: attrs>=19.2.0in d:\python37\lib\site-packages (from pytest>=5.0->pytest-html) (20.3.0)

30. Requirement already satisfied: zipp>=0.5in d:\python37\lib\site-packages (from importlib-metadata>=0.12->pytest>=5.0->pytest-html) (1.2.0)

32. Requirement already satisfied: pyparsing>=2.0.2in d:\python37\lib\site-packages (from packaging->pytest>=5.0->pytest-html) (2.4.7)

AI写代码python运行

• 插件版本查看：

2. C:\Users\Administrator>pip show pytest-html

4. Name: pytest-html

6. Version: 2.0.1

8. Summary: pytest plugin for generating HTML reports

10. Home-page: https://github.com/pytest-dev/pytest-html

12. Author: Dave Hunt

14. Author-email: dhunt@mozilla.com

16. License: Mozilla Public License 2.0 (MPL 2.0)

18. Location: d:\python37\lib\site-packages

20. Requires: pytest, pytest-metadata

22. Required-by:

AI写代码python运行

3 生成报告

3.1 插件执行方式

• 使用如下命令在命令行执行：

pytest --html=report.html

AI写代码

• 执行后，在当前目录下生成一个吗，名为report.html的报告：

3.2 执行效果

在这里插入图片描述

3.3 指定报告生成的路径

• 当前目录下：

pytest --html=report.html

AI写代码

• 指定目录下：

pytest --html=./report/report.html

AI写代码

在这里插入图片描述

• 指定某个用例运行，生成报告保存到指定目录下：

pytest --html=./report/report.html

AI写代码

在这里插入图片描述

4 合并css

• 从生成的报告可以看出，除了report.html外，还有个文件style.css;

• 这个文件是报告的样式，是独立的，那么我们分享报告的时候，就必须把这个样式也加上，比较麻烦：

  

2. body {

4. font-family: Helvetica, Arial, sans-serif;

6. font-size: 12px;

8. /* do not increase min-width as some may use split screens */

10. min-width: 800px;

12. color: #999;

14. }

17. h1 {

19. font-size: 24px;

21. color: black;

23. }

26. h2 {

28. font-size: 16px;

30. color: black;

32. }

35. p {

37. color: black;

39. }

42. a {

44. color: #999;

46. }

49. table {

51. border-collapse: collapse;

53. }

56. /******************************

58. * SUMMARY INFORMATION

60. ******************************/

63. #environment td {

65. padding: 5px;

67. border: 1px solid #E6E6E6;

69. }

72. #environment tr:nth-child(odd) {

74. background-color: #f6f6f6;

76. }

79. /******************************

81. * TEST RESULT COLORS

83. ******************************/

85. span.passed, .passed .col-result {

87. color: green;

89. }

91. span.skipped, span.xfailed, span.rerun, .skipped .col-result, .xfailed .col-result, .rerun .col-result {

93. color: orange;

95. }

97. span.error, span.failed, span.xpassed, .error .col-result, .failed .col-result, .xpassed .col-result {

99. color: red;

101. }

105. /******************************

107. * RESULTS TABLE

109. *

111. * 1. Table Layout

113. * 2. Extra

115. * 3. Sorting items

117. *

119. ******************************/

122. /*------------------

124. * 1. Table Layout

126. *------------------*/

129. #results-table {

131. border: 1px solid #e6e6e6;

133. color: #999;

135. font-size: 12px;

137. width: 100%

139. }

142. #results-table th, #results-table td {

144. padding: 5px;

146. border: 1px solid #E6E6E6;

148. text-align: left

150. }

152. #results-table th {

154. font-weight: bold

156. }

159. /*------------------

161. * 2. Extra

163. *------------------*/

166. .log:only-child {

168. height: inherit

170. }

172. .log {

174. background-color: #e6e6e6;

176. border: 1px solid #e6e6e6;

178. color: black;

180. display: block;

182. font-family: "Courier New", Courier, monospace;

184. height: 230px;

186. overflow-y: scroll;

188. padding: 5px;

190. white-space: pre-wrap

192. }

194. div.image {

196. border: 1px solid #e6e6e6;

198. float: right;

200. height: 240px;

202. margin-left: 5px;

204. overflow: hidden;

206. width: 320px

208. }

210. div.image img {

212. width: 320px

214. }

216. .collapsed {

218. display: none;

220. }

222. .expander::after {

224. content: " (show details)";

226. color: #BBB;

228. font-style: italic;

230. cursor: pointer;

232. }

234. .collapser::after {

236. content: " (hide details)";

238. color: #BBB;

240. font-style: italic;

242. cursor: pointer;

244. }

247. /*------------------

249. * 3. Sorting items

251. *------------------*/

253. .sortable {

255. cursor: pointer;

257. }

260. .sort-icon {

262. font-size: 0px;

264. float: left;

266. margin-right: 5px;

268. margin-top: 5px;

270. /*triangle*/

272. width: 0;

274. height: 0;

276. border-left: 8px solid transparent;

278. border-right: 8px solid transparent;

280. }

283. .inactive .sort-icon {

285. /*finish triangle*/

287. border-top: 8px solid #E6E6E6;

289. }

292. .asc.active .sort-icon {

294. /*finish triangle*/

296. border-bottom: 8px solid #999;

298. }

301. .desc.active .sort-icon {

303. /*finish triangle*/

305. border-top: 8px solid #999;

307. }

AI写代码python运行

• 所以为了方便，我们把这个css样式合并到html里，命令如下：

pytest --html=report.html --self-contained-html

AI写代码

• 再次运行报告查看下，此时只有report.html文件，且样式已经合并进来了：

  

5 报告中的行显示设置

• 默认生成功的报告中的所有行都是被展开的,如图：

  

• 我们可以自定义显示的样式：

?collapsed=Passed,XFailed,Skipped

AI写代码

6 报告增强

详细参考官网文档：https://github.com/pytest-dev/pytest-html

6.1 自定义css

• 可以使用--CSS选项在命令行上传递自定义CSS：

$ pytest --html=report.html --css=highcontrast.css --css=accessible.css

AI写代码

6.2 报告标题

• 默认情况下，报告标题将是报告的文件名；

• 您可以使用pytest_html_report_title钩子对其进行编辑：

1. def pytest_html_report_title(report):

2. report.title = "My very own title!"

6.3 环境

• Environment部分由pytest-metadata插件提供；

• 可以通过pytest_configure和pytest_sessionfinish钩子访问；

• 要在运行测试之前修改Environment部分，请使用pytest_configure：

1. def pytest_configure(config):

2. config._metadata["foo"] = "bar"

• 要在测试运行后修改Environment部分，请使用pytest_sessionfinish：

2. import pytest

6. @pytest.hookimpl(tryfirst=True)

8. def pytest_sessionfinish(session, exitstatus):

10. session.config._metadata["foo"] = "bar"

AI写代码python运行

'

运行

运行

请注意，在上面的示例中，@pytest.hookimpl（tryfirst=True）非常重要，因为这可以确保在任何其他插件（包括pytest-html和pytest-metadata）运行之前尽最大努力运行pytest_sessionfinish。如果省略了这一行，那么Environment表将不会更新，因为插件的pytest_sessionfinish将首先执行，因此不会接受您的更改。

除非元数据是集合.OrderedDict，否则生成的表将按字母顺序排序。

可以从环境表中编辑变量。重做的变量将显示其名称，但其值将灰显。这可以通过在INI配置文件（例如：pytest.INI）中设置environment_table_redact_list来实现。environment_table_redact_list是正则表达式的行列表。与此列表中的正则表达式匹配的任何环境表变量都会对其值进行编校。

例如，以下命令将对与正则表达式^foo$、.*redact.*或bar匹配的所有环境表变量进行编校：

2. [pytest]

4. environment_table_redact_list = ^foo$

6. .*redact.*

8. bar

AI写代码python运行

6.4 其他摘要信息

• 可以使用pytest_html_results_Summary挂钩编辑Summary部分：

2. from py.xml import html

6. def pytest_html_results_summary(prefix, summary, postfix):

8. prefix.extend([html.p("foo: bar")])

AI写代码python运行

6.5 Extra内容

• 可以通过在报告对象上创建“extra”列表来向HTML报告添加详细信息；

• 以下是可以添加的extra 内容类型：

Type	Example
Raw HTML	extra.html('<div>Additional HTML</div>')
JSON	extra.json({'name': 'pytest'})
Plain text	extra.text('Add some simple Text')
URL	extra.url('http://www.example.com/')
Image	extra.image(image, mime_type='image/gif', extension='gif')
Image	extra.image('/path/to/file.png')
Image	extra.image('http://some_image.png')

• 注意：从文件添加图像时，路径可以是绝对路径，也可以是相对路径；

• 注意：当使用--self-contained-html时，作为文件或链接添加的图像可能无法按预期工作，有关详细信息，请参阅 Creating a self-contained report一节。

• 还有几种图像格式的方便类型：

Image format	Example
PNG	extra.png(image)
JPEG	extra.jpg(image)
SVG	extra.svg(image)

• 以下示例使用pytest_runtest_makereport钩子添加了各种类型的附加功能，该钩子可以在plugin或conftest.py文件中实现：

2. import pytest

6. @pytest.hookimpl(hookwrapper=True)

8. def pytest_runtest_makereport(item, call):

10. pytest_html = item.config.pluginmanager.getplugin("html")

12. outcome = yield

14. report = outcome.get_result()

16. extra = getattr(report, "extra", [])

18. if report.when == "call":

20. # always add url to report

22. extra.append(pytest_html.extras.url("http://www.example.com/"))

24. xfail = hasattr(report, "wasxfail")

26. if (report.skipped and xfail) or (report.failed andnot xfail):

28. # only add additional html on failure

30. extra.append(pytest_html.extras.html("<div>Additional HTML</div>"))

32. report.extra = extra

AI写代码python运行

• 还可以为html以外的所有类型指定名称参数，这将更改创建的超链接的标题：

extra.append(pytest_html.extras.text("some string", name="Different title"))

AI写代码

• 还可以使用fixture extra直接在测试函数中添加内容，而不需要实现挂钩。这些通常会在插件添加任何额外功能之前结束。

2. from pytest_html import extras

6. def test_extra(extra):

8. extra.append(extras.text("some string"))

AI写代码python运行

6.6 修改结果表

• 可以通过为表头和行实现自定义挂钩来修改报表的列；

• 以下示例conftest.py使用测试函数docstring添加描述列，添加可排序时间列，并删除链接列：

2. from datetime import datetime

4. from py.xml import html

6. import pytest

10. def pytest_html_results_table_header(cells):

12. cells.insert(2, html.th("Description"))

14. cells.insert(1, html.th("Time", class_="sortable time", col="time"))

16. cells.pop()

20. def pytest_html_results_table_row(report, cells):

22. cells.insert(2, html.td(report.description))

24. cells.insert(1, html.td(datetime.utcnow(), class_="col-time"))

26. cells.pop()

30. @pytest.hookimpl(hookwrapper=True)

32. def pytest_runtest_makereport(item, call):

34. outcome = yield

36. report = outcome.get_result()

38. report.description = str(item.function.__doc__)

AI写代码python运行

• 还可以通过实现pytest_html_results_table_row钩子并删除所有单元格来删除结果。以下示例从报告中删除所有传递的结果：

2. def pytest_html_results_table_row(report, cells):

4. if report.passed:

6. del cells[:]

AI写代码python运行

'

运行

运行

• 可以通过实现pytest_HTML_results.HTML钩子来修改日志输出和其他HTML。以下示例用日志为空的通知替换所有其他HTML和日志输出：

2. from py.xml import html

6. def pytest_html_results_table_html(report, data):

8. if report.passed:

10. del data[:]

12. data.append(html.div("No log output captured.", class_="empty log"))

AI写代码python运行

var code = "43d4bcd6-e331-43c5-bf7b-1387d7988f7b"

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

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

软件测试面试文档

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

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