pytest-html 1.22.0

外观

自定义css（层叠样式表）可以使用 --css选项。这些将按指定的顺序应用，并且可以 用于更改报表的外观。

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

环境

environment部分由pytest-metadata插件提供，可以访问 通过pytest_configure挂钩：

defpytest_configure(config):config._metadata['foo']='bar'

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

附加摘要信息

您可以使用pytest_html_results_summary钩子编辑summary部分：

importpytestfrompy.xmlimporthtmldefpytest_html_results_summary(prefix,summary,postfix):prefix.extend([html.p("foo: bar")])

额外内容

您可以通过在 报表对象。以下是可以添加的额外内容类型：

注意：从文件添加图像时，路径可以是绝对路径 或者是亲戚。

注意：使用--self-contained-html时，图像作为文件或链接添加 可能无法按预期工作，请参阅Creating a self-contained report部分 更多信息。

也有多种图像格式的方便类型：

下面的示例使用 pytest_runtest_makereport钩子，可以在插件或 conftest.py文件：

importpytest@pytest.hookimpl(hookwrapper=True)defpytest_runtest_makereport(item,call):pytest_html=item.config.pluginmanager.getplugin('html')outcome=yieldreport=outcome.get_result()extra=getattr(report,'extra',[])ifreport.when=='call':# always add url to reportextra.append(pytest_html.extras.url('http://www.example.com/'))xfail=hasattr(report,'wasxfail')if(report.skippedandxfail)or(report.failedandnotxfail):# only add additional html on failureextra.append(pytest_html.extras.html('<div>Additional HTML</div>'))report.extra=extra

您还可以为除html之外的所有类型指定name参数，这将更改 已创建超链接：

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

修改结果表

您可以通过实现头和 排。下面的示例conftest.py添加了一个描述列 测试函数docstring，添加可排序的时间列，并删除链接 列：

fromdatetimeimportdatetimefrompy.xmlimporthtmlimportpytestdefpytest_html_results_table_header(cells):cells.insert(2,html.th('Description'))cells.insert(1,html.th('Time',class_='sortable time',col='time'))cells.pop()defpytest_html_results_table_row(report,cells):cells.insert(2,html.td(report.description))cells.insert(1,html.td(datetime.utcnow(),class_='col-time'))cells.pop()@pytest.hookimpl(hookwrapper=True)defpytest_runtest_makereport(item,call):outcome=yieldreport=outcome.get_result()report.description=str(item.function.__doc__)

您还可以通过实现 pytest_html_results_table_row勾住并移除所有单元格。这个 以下示例将从报表中删除所有通过的结果：

importpytestdefpytest_html_results_table_row(report,cells):ifreport.passed:delcells[:]

可以通过实现 pytest_html_results_html钩子。以下示例将替换所有 附加的HTML和日志输出，并注意日志为空：

importpytestdefpytest_html_results_table_html(report,data):ifreport.passed:deldata[:]data.append(html.div('No log output captured.',class_='empty log'))