前言

捕获警告信息

从版本开始3.1，pytest现在会在测试执行期间自动捕获警告并在会话结束时显示它们：

1. # content of test_show_warnings.py

2. import warnings

4. def api_v1():

5. warnings.warn(UserWarning("api v1,should use functions from v2"))

6. return 1

8. def test_one():

9. assert api_v1() == 1

运行pytest现在产生这个输出：

1. $ pytest test_show_warnings.py

2. =========================== test session starts ============================

3. platform linux -- Python 3.x.y,pytest-4.x.y,py-1.x.y,pluggy-0.x.y

4. cachedir: $PYTHON_PREFIX/.pytest_cache

5. rootdir: $REGENDOC_TMPDIR

6. collected 1 item

8. test_show_warnings.py . [100%]

10. ============================= warnings summary =============================

11. test_show_warnings.py::test_one

12. $REGENDOC_TMPDIR/test_show_warnings.py:5: UserWarning: api v1,should use functions from v2

13. warnings.warn(UserWarning("api v1,should use functions from v2"))

15. -- Docs: https://docs.pytest.org/en/latest/warnings.html

16. =================== 1 passed,1 warnings in 0.12 seconds ===================

-W可以传递该标志以控制将显示哪些警告,甚至将其转换为错误：

1. $ pytest -q test_show_warnings.py -W error::UserWarning

2. F [100%]

3. ================================= FAILURES =================================

4. _________________________________ test_one _________________________________

6. def test_one():

7. > assert api_v1() == 1

9. test_show_warnings.py:10:

10. _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

12. def api_v1():

13. > warnings.warn(UserWarning("api v1,should use functions from v2"))

14. E UserWarning: api v1,should use functions from v2

16. test_show_warnings.py:5: UserWarning

17. 1 failed in 0.12 seconds

可以pytest.ini使用filterwarningsini选项在文件中设置相同的选项。例如,以下配置将忽略所有用户警告,但会将所有其他警告转换为错误。

1. [pytest]

2. filterwarnings =

3. error

4. ignore::UserWarning

当警告与列表中的多个选项匹配时,将执行最后一个匹配选项的操作。

这两个-W命令行选项和filterwarningsINI选项是基于Python的

@pytest.mark.filterwarnings

版本3.2中的新函数。

你可以使用@pytest.mark.filterwarnings向特定测试项添加警告过滤器,以便更好地控制应在测试,类甚至模块级别捕获哪些警告：

1. import warnings

3. def api_v1():

4. warnings.warn(UserWarning("api v1,should use functions from v2"))

5. return 1

7. @pytest.mark.filterwarnings("ignore:api v1")

8. def test_one():

9. assert api_v1() == 1

使用标记应用的过滤器优先于在命令行上传递或由filterwarningsini选项配置的过滤器。

你可以通过使用filterwarnings标记作为类装饰器或通过设置pytestmark变量将模块中的所有测试应用于类的所有测试：

1. # turns all warnings into errors for this module

2. pytestmark = pytest.mark.filterwarnings("error")

禁用警告摘要

虽然不推荐，但你可以使用–disable-warnings命令行选项从测试运行输出中完全禁止警告摘要。

完全禁用警告捕获#
此插件默认启用,但可以在你的pytest.ini文件中完全禁用：

[pytest]
addopts = -p no:warnings

或者传入命令行。如果测试套件使用外部系统处理警告,这可能很有用。-pno:warnings

弃用警告和待命记录警告

默认情况下,pytest将显示DeprecationWarning和PendingDeprecationWarning从用户代码和第三方库警告，建议[PEP-0565。这有助于用户保持代码现代化,并在有效删除已弃用的警告时避免破坏。

有时隐藏在你无法控制的代码(例如第三方库)中发生的某些特定弃用警告很有用,在这种情况下，你可以使用警告过滤器选项(ini或标记)来忽略这些警告。

例如：

1. [pytest]

2. filterwarnings =

3. ignore:.*U.*mode is deprecated:DeprecationWarning

这将忽略DeprecationWarning消息开头与正则表达式匹配的所有类型的警告。“.*U.*modeisdeprecated”

注意：
如果在解释器级别配置警告，使用[PYTHONWARNINGS环境变量或-W命令行选项,pytest将默认不配置任何过滤器。

此外，pytest不遵循PEP-0506重置所有警告过滤器的建议,因为它可能会破坏通过调用自行配置警告过滤器的测试套件warnings.simplefilter(请参阅问题[＃2430以获取该示例)。

确保代码触发弃用警告

你还可以调用全局帮助程序来检查某个函数调用是否触发aDeprecationWarning或PendingDeprecationWarning：

你还可以调用全局帮助程序来检查某个函数调用是否触发aDeprecationWarning或PendingDeprecationWarning：

1. import pytest

3. def test_global():

4. pytest.deprecated_call(myfunction,17)

默认情况下,DeprecationWarning并PendingDeprecationWarning不会被使用时,捕捉pytest.warns或recwarn因为默认的Python警告过滤器隐藏起来。如果你希望在自己的代码中记录它们，请使用以下命令warnings.simplefilter(‘always’)：

1. import warnings

2. import pytest

4. def test_deprecation(recwarn):

5. warnings.simplefilter("always")

6. warnings.warn("deprecated",DeprecationWarning)

7. assert len(recwarn) == 1

8. assert recwarn.pop(DeprecationWarning)

你还可以将其用作上下文管理器：

1. def test_global():

2. with pytest.deprecated_call():

3. myobject.deprecated_method()

用警告函数断言警告

你可以检查代码是否引发了特定警告pytest.warns,其工作方式类似于[引发：

1. import warnings

2. import pytest

4. def test_warning():

5. with pytest.warns(UserWarning):

6. warnings.warn("my warning",UserWarning)

如果未提出相关警告,测试将失败。match断言异常与文本或正则表达式匹配的关键字参数：

1. >>> with warns(UserWarning,match='must be 0 or None'):

2. ... warnings.warn("value must be 0 or None",UserWarning)

4. >>> with warns(UserWarning,match=r'must be \d+/pre>):

5. ... warnings.warn("value must be 42",UserWarning)

7. >>> with warns(UserWarning,match=r'must be \d+/pre>):

8. ... warnings.warn("this is not here",UserWarning)

9. Traceback (most recent call last):

10. ...

11. Failed: DID NOT WARN. No warnings of type ...UserWarning... was emitted...

你还可以调用pytest.warns函数或代码字符串：

1. pytest.warns(expected_warning,func,*args,**kwargs)

2. pytest.warns(expected_warning,"func(*args,**kwargs)")

该函数还返回所有引发警告(作为warnings.WarningMessage对象)的列表,你可以查询其他信息：

1. with pytest.warns(RuntimeWarning) as record:

2. warnings.warn("another warning",RuntimeWarning)

4. # check that only one warning was raised

5. assert len(record) == 1

6. # check that the message matches

7. assert record[0].message.args[0] == "another warning"

自定义失败消息

记录警告提供了在未发出警告或满足其他条件时生成自定义测试失败消息的机会。

1. def test():

2. with pytest.warns(Warning) as record:

3. f()

4. if not record:

5. pytest.fail("Expected a warning!")

如果在呼叫时没有发出警告f,那么将评估为。然后,你可以使用自定义错误消息进行调用。notrecordTruepytest.fail

内部pytest警告

pytest可能会在某些情况下生成自己的警告,例如使用不当或不推荐使用的函数。

例如,如果遇到匹配python_classes但也定义__init__构造函数的类,pytest将发出警告,因为这会阻止实例化类：

1. # content of test_pytest_warnings.py

2. class Test:

3. def __init__(self):

4. pass

6. def test_foo(self):

7. assert 1 == 1

感谢每一个认真阅读我文章的人，礼尚往来总是要有的，虽然不是什么很值钱的东西，如果你用得到的话可以直接拿走：

这些资料，对于【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴上万个测试工程师们走过最艰难的路程，希望也能帮助到你!有需要的小伙伴可以点击下方小卡片领取