pytest官方文档 6.2 中文翻译版（第十四章）：Cache：管理跨测试的状态

最新推荐文章于 2024-07-22 13:17:48 发布
最新推荐文章于 2024-07-22 13:17:48 发布
阅读量239 收藏
点赞数
分类专栏： pytest官方文档翻译 测试自动化 文章标签： pytest 测试自动化
本文档介绍了pytest的Cache管理功能，包括如何重新执行失败的测试用例、查看和清除缓存，以及Stepwise逐步调试。提供命令行参数如`--lf`、`--ff`和`--cache-clear`，并展示了插件如何利用`config.cache`对象。对于故障排查和CI流程非常有用。
摘要由CSDN通过智能技术生成

14.1 用法

这个插件提供了两个命令行参数用于在测试失败的时候重新运行失败的用例：

  • –lf, --last-failed 只重新运行失败的用例
  • –ff, --failed-first 先重新运行失败的用例，然后运行其他的

为了执行清理（通常情况下不需要），使用 --cache-clear 允许我们在测试运行之前删除所有的之前运行的cache。
其他的插件可以在pytest执行的时候访问 config.cache 对象来获取一个json格式的值。
注意：这个插件默认是开启的，如果你需要也可以关上：查看18.3，使用名字 声明/卸载 插件（这个插件的内部名字是 cacheprovider）。
译者注：这个插件对于排错很有用，例如CI上面报了错，你可以直接使用 pytest -lf 来执行刚刚出错的一些用例

14.2 重新执行失败用例或先执行失败用例

首先，我们创建50个测试，其中两个会失败：

# content of test_50.py
import pytest


@pytest.mark.parametrize("i", range(50))
def test_num(i):
	if i in (17, 25):	
		pytest.fail("bad luck")

第一次运行你会看到两个失败：

$ pytest -q
.................F.......F........................ [100%]
================================= FAILURES =================================
_______________________________ test_num[17] _______________________________
i = 17
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
_______________________________ test_num[25] _______________________________
i = 25
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
========================= short test summary info ==========================
FAILED test_50.py::test_num[17] - Failed: bad luck
FAILED test_50.py::test_num[25] - Failed: bad luck
2 failed, 48 passed in 0.12s

如果你之后再用 pytest --lf 运行：

$ pytest --lf
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-6.x.y, py-1.x.y, pluggy-0.x.y
cachedir: $PYTHON_PREFIX/.pytest_cache
rootdir: $REGENDOC_TMPDIR
collected 2 items
run-last-failure: rerun previous 2 failures
test_50.py FF [100%]
================================= FAILURES =================================
_______________________________ test_num[17] _______________________________
i = 17
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
_______________________________ test_num[25] _______________________________
i = 25
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
========================= short test summary info ==========================
FAILED test_50.py::test_num[17] - Failed: bad luck
FAILED test_50.py::test_num[25] - Failed: bad luck
============================ 2 failed in 0.12s =============================

在上一次运行中，你只运行了两个之前失败的测试，其余48个测试没有被运行。
现在，如果你使用 --ff 选项，所有的测试都会被运行，但是之前失败的用例会被先运行（从一连串的FF和点中可以看出）：

$ pytest --ff
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-6.x.y, py-1.x.y, pluggy-0.x.y
cachedir: $PYTHON_PREFIX/.pytest_cache
rootdir: $REGENDOC_TMPDIR
collected 50 items
run-last-failure: rerun previous 2 failures first
test_50.py FF................................................ [100%]
================================= FAILURES =================================
_______________________________ test_num[17] _______________________________
i = 17
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
_______________________________ test_num[25] _______________________________
i = 25
@pytest.mark.parametrize("i", range(50))
def test_num(i):
if i in (17, 25):
> pytest.fail("bad luck")
E Failed: bad luck
test_50.py:7: Failed
========================= short test summary info ==========================
FAILED test_50.py::test_num[17] - Failed: bad luck
FAILED test_50.py::test_num[25] - Failed: bad luck
======================= 2 failed, 48 passed in 0.12s =======================

新的 --nf，–new-first选项：最新的测试先运行，老的在之后运行，在这种情况下，执行顺序是根据最后修改时间的，最近修改的最先运行。

14.3 上次没有测试失败时候的行为

如果上一次没有失败，或者是没有找到cached，pytest可以被配置为运行全部测试或者不运行任何一个测试，使用 --last-failed-no-failures，它可以被配置为下面的几个值：

pytest --last-failed --last-failed-no-failures all # 运行所有测试
pytest --last-failed --last-failed-no-failures none # 不运行任何测试

14.4 新的 config.cache 对象

在插件或者conftest.py中支持使用pytest配置对象获取缓存的值。下面是一个简单的插件的例子，它实现了一个可以在多次pytest调用之前重复使用之前创建的状态的夹具：

# content of test_caching.py
import pytest
import time

def expensive_computation():
	print("running expensive computation...")

@pytest.fixture
def mydata(request):
	val = request.config.cache.get("example/value", None)
	if val is None:
		expensive_computation()
		val = 42
	request.config.cache.set("example/value", val)
return val

def test_function(mydata):
	assert mydata == 23

第一次运行，你会看到下面的结果：

$ pytest -q
F [100%]
================================= FAILURES =================================
______________________________ test_function _______________________________
mydata = 42
def test_function(mydata):
> assert mydata == 23
E assert 42 == 23
test_caching.py:20: AssertionError
-------------------------- Captured stdout setup ---------------------------
running expensive computation...
========================= short test summary info ==========================
FAILED test_caching.py::test_function - assert 42 == 23
1 failed in 0.12s

再运行一次，测试会从cache中读取值，信息就不会被打印出来了：

$ pytest -q
F [100%]
================================= FAILURES =================================
______________________________ test_function _______________________________
mydata = 42
def test_function(mydata):
> assert mydata == 23
E assert 42 == 23
test_caching.py:20: AssertionError
========================= short test summary info ==========================
FAILED test_caching

在 22.3.2中可以看到更多的信息。

14.5 查看cache信息

你可以使用 --cache-show 参数查看cache的信息：

$ pytest --cache-show
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-6.x.y, py-1.x.y, pluggy-0.x.y
cachedir: $PYTHON_PREFIX/.pytest_cache
rootdir: $REGENDOC_TMPDIR
cachedir: $PYTHON_PREFIX/.pytest_cache
--------------------------- cache values for '*' ---------------------------
cache/lastfailed contains:
{'test_50.py::test_num[17]': True,
'test_50.py::test_num[25]': True,
'test_assert1.py::test_function': True,
'test_assert2.py::test_set_comparison': True,
'test_caching.py::test_function': True,
'test_foocompare.py::test_compare': True}
cache/nodeids contains:
['test_50.py::test_num[0]',
'test_50.py::test_num[10]',
'test_50.py::test_num[11]',
'test_50.py::test_num[12]',
'test_50.py::test_num[13]',
'test_50.py::test_num[14]',
'test_50.py::test_num[15]',
'test_50.py::test_num[16]',
'test_50.py::test_num[17]',
'test_50.py::test_num[18]',
'test_50.py::test_num[19]',
'test_50.py::test_num[1]',
'test_50.py::test_num[20]',
'test_50.py::test_num[21]',
'test_50.py::test_num[22]',
'test_50.py::test_num[23]',
'test_50.py::test_num[24]',
'test_50.py::test_num[25]',
'test_50.py::test_num[26]',
'test_50.py::test_num[27]',
'test_50.py::test_num[28]',
'test_50.py::test_num[29]',
'test_50.py::test_num[2]',
'test_50.py::test_num[30]',
'test_50.py::test_num[31]',
'test_50.py::test_num[32]',
'test_50.py::test_num[33]',
'test_50.py::test_num[34]',
'test_50.py::test_num[35]',
'test_50.py::test_num[36]',
'test_50.py::test_num[37]',
'test_50.py::test_num[38]',
'test_50.py::test_num[39]',
'test_50.py::test_num[3]',
'test_50.py::test_num[40]',
'test_50.py::test_num[41]',
'test_50.py::test_num[42]',
'test_50.py::test_num[43]',
'test_50.py::test_num[44]',
'test_50.py::test_num[45]',
'test_50.py::test_num[46]',
'test_50.py::test_num[47]',
'test_50.py::test_num[48]',
'test_50.py::test_num[49]',
'test_50.py::test_num[4]',
'test_50.py::test_num[5]',
'test_50.py::test_num[6]',
'test_50.py::test_num[7]',
'test_50.py::test_num[8]',
'test_50.py::test_num[9]',
'test_assert1.py::test_function',
'test_assert2.py::test_set_comparison',
'test_caching.py::test_function',
'test_foocompare.py::test_compare']
cache/stepwise contains:
[]
example/value contains:
42
========================== no tests ran in 0.12s ===========================

–cache-show 可以使用一个模式通配符来对于结果进行一个过滤：

$ pytest --cache-show example/*
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-6.x.y, py-1.x.y, pluggy-0.x.y
cachedir: $PYTHON_PREFIX/.pytest_cache
rootdir: $REGENDOC_TMPDIR
cachedir: $PYTHON_PREFIX/.pytest_cache
----------------------- cache values for 'example/*' -----------------------
example/value contains:
42
========================== no tests ran in 0.12s===========================

14.6 清空cache

你可以通过添加–cache-clear选项来指示pytest清除所有缓存文件和值:

pytest --cache-clear

这在一些对于独立性要求比运行速度更重要的类似于CI这样的系统中是十分有用的。

14.7 Stepwise

另一个与–lf类似的是 -x，特别适合你已经知道一个很大的测试集一定会失败。–sw，–stepwise 允许你一次修复一个测试。测试执行过程中只要碰到失败就会停下来。在下一次调用的时候，测试会从上一次失败的用例开始，直到遇到下一个失败。你可以使用 --stepwise-skip 来忽略一次测试的失败，在第二个失败的时候才停下来。当你被一个失败的测试卡住想之后修复它的时候，这个能力十分有用。

聂14昊51
关注
专栏目录
pytest -- 中文文档
luizyao的博客
10-31 2500
pytest 官方文档（5.1.3版本）的中文翻译，但不仅仅是简单的翻译，也包含作者自己的理解和学习过程；
pytest之.pytest_cache文件夹作用【Pytest中的cache缓存功能】
HB8888888的博客
04-08 4282
前言 pytest 运行完用例之后会生成一个.pytest_cache的缓存文件夹，用于记录用例的ids和上一次失败的用例。 1、跑自动化时经常会出现这样一个情况，一轮自动化跑完后零星出现了几个失败测试用例，无法断定失败的原因，所以可能需要重新跑一下失败的测试用例去调试，那我们要做的是就去修改脚本把那几个失败的测试用例筛选出来然后重新跑一遍； 2、但是在pytest测试框架因为有缓存功能，就不需要手动去查找上次失败的测试用例并筛选执行。 3、pytest测试框架中执行完所有的测试用例后会在当前目..
pytest8.x版本 中文使用文档-------20.配置参考
最新发布
2301_76646967的博客
07-22 1246
设置要使用的 pygments 样式。设置此样式的亮度模式为亮色或暗色。
pytest官方文档 6.2 中文翻译版（第十三章）：参数化的夹具和测试
白话屋
05-24 431
参数化的夹具和测试 pytest在多个级别上都可以做参数化： pytest.fixture() 允许用户参数化夹具函数 @pytest.mark.parametrize 允许用户给测试方法或者类定义多组参数或者多个夹具 pytest_generate_tests允许用户定义自定义的参数格式或者扩展 13.1 @pytest.mark.parametrize: 参数化测试方法 内置的 pytest.mark.parametrize 修饰器允许测试参数的参数化。这是一个测试给定的参数的运行结果是不是等于期望
pytest 官方文档
09-18
pytest 官方文档，此文档为官方最新版2020-09-18，文章为英文文档。文字清晰，内容丰富，分享给大家。
pytest官方文档 6.2 中文翻译版（第一章）：安装和入门指南
白话屋
03-19 2828
安装和入门指南 Python版本: Python 3.6, 3.7, 3.8, 3.9, PyPy3 平台: Linux and Windows PyPI 包名: pytest Documentation as PDF: download latest pytest 是一个测试框架，可以让你轻而易举的构建简单的和可扩展的测试。 测试没有过多的样板代码，一切都是简单易读的。可以在几分钟就写好一个针对你的应用程序或者库的小型单元测试或复杂功能测试。 1.1 安装 pytest 在你的命令行中运行下面的命令pi
pytest中文文档详解
04-10
### pytest中文文档详解 #### 一、pytest简介与特点 pytest 是一款强大的 Python 测试工具，它能够帮助开发者轻松地构建高效且易于扩展的测试集合。相比于其他测试框架（如 unittest），pytest 的一大优势在于其...
Pytest官方文档翻译.pdf
08-25
Pytest 是一个强大的 Python 测试框架，其特点包括简洁、灵活和丰富的文档支持。它不仅适合进行简单的单元测试，还能处理复杂的集成测试和自动化测试场景，如 Selenium 和 Appium 的 UI 自动化测试，以及使用 ...
pytest中文文档.pdf
12-28
pytest中文文档.pdf pytest是一个流行的Python测试框架，能够帮助开发者快速创建高质量的测试用例。下面是pytest中文文档的摘要信息： 1. 安装pytest pytest可以使用pip安装，命令为`pip install -U pytest`。...
Python单元测试Pytest官方文档
01-20
Python 单元测试是软件开发过程中的重要环节，它确保代码的各个部分按预期工作。Pytest 是一个功能强大且灵活的 ...通过阅读官方文档，开发者可以深入了解 Pytest 并充分利用其优势，构建高质量的 Python 应用程序。
pytest官方文档 6.2 中文翻译版（第十九章）：编写插件
白话屋
11-12 490
在大多数项目中，引入本地的 conftest 插件或者使用pip安装插件都是可以的，包括第三方的项目。如果要使用一个插件而非自己写一个插件，可以参考上一章。 一个插件包括一个或者多个钩子方法。下一章（编写钩子）解释了写一个钩子所需要的基本信息和详细信息。pytest通过以下插件中指定的钩子来实现 配置，收集，运行，报告等多个方面： 内置的插件：从pytest内部的_pytest目录加载 外部的插件：通过setuptools入口点发现的模块（ setuptools entry points）19.4 con
pytest.pdf 官方文档
05-13
python 自动化测试 pytest 官方文档，测试开发必备python技能，pytest使用从入门到精通
pytest中文文档.pdf.zip
03-30
pytest中文使用手册，文档是pytest使用手册的中文版，详细的描述pytest安装以及使用，对想要学习接口自动化的同学帮助很大。pytest是一个非常成熟的全功能的Python测试框架。其简单灵活，容易上手，文档丰富，支持参数化，可以细粒度地控制要测试的测试用例
pytest官方文档 6.2 中文翻译版（第二十章）：编写钩子方法
白话屋
11-12 846
20.1 钩子方法的验证和执行 pytest从所有注册的插件中调用符合钩子规范的方法。我们看一个典型的钩子，作用是在所有的测试被收集之后调用：pytest_collection_modifyitems(session, config, items) 。 当我们在我们的插件中调用了pytest_collection_modifyitems方法，那么在插件注册的时候，pytest就会验证你使用的参数名称是不是符合规范，如果不是，就放弃。 我们看看可能的实现： def pytest_collection_modi
pytest官方文档 6.2 中文翻译版（第十八章）：安装和使用插件
白话屋
05-31 481
安装和使用插件 这一章我们来看如何安装和使用第三方插件。如果你要写自己的插件，请看下一章。 可以简单的使用pip安装一个第三方插件： pip install pytest-NAME pip uninstall pytest-NAME 如果安装了一个插件，pytest会自动寻找和集成这个插件，无需激活（activate）操作。 下面是一些流行插件的说明： pytest-django：为django应用编写测试，使用pytest集成 pytest-twisted: 为twisted应用编写测试, 从测试函数
pytest官方文档 6.2 中文翻译版（第十一章）：模块和测试文件中的文档测试（doctest）集成
白话屋
05-14 369
译者注：doctest是python标准的模块，如果要了解相关的知识可以百度doctest 默认情况下，所有符合 test*.txt 模式的测试文件会被python标准的 doctest 模块执行，你可以通过命令行参数来改变这种默认行为： pytest --doctest-glob="*.rst" –doctest-glob 可以在命令行中被多次指定。 假设我们有这样一个文件： # content of test_example.txt hello this is a doctest >>&
pytest官方文档 6.2 中文翻译版（第十章）：警告捕捉
白话屋
05-14 476
从3.1版本开始，pytest会在整个测试执行的过程中自动的捕捉警告： # content of test_show_warnings.py import warnings def api_v1(): warnings.warn(UserWarning("api v1, should use functions from v2")) return 1 def test_one(): assert api_v1() == 1 运行pytest之后会得到下面的输出： $ pytest test_
pytest官方文档 6.2 中文翻译版（第十五章）：UNITTEST.TESTCASE 支持
白话屋
05-24 847
pytest支持开箱即用的运行以 Python unittest 为基础的测试。这是为了在已有的在以unittest为基础的（unittest-based）测试上面进行扩充，使用pytest作为运行器。同时，这也可以让测试逐步的使用pytest提供的功能以获取个别更多的优势。 使用pytest运行已存在的unittest风格的测试： pytest tests pytest会自动的收集 unittest.TestCase 的子类和在test_.py 或是_test.py文件中的测试方法。 几乎所有的unit
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值