Pytest权威教程06-使用Marks标记测试用例

使用Marks标记测试用例
- 在未知标记上引发异常： -strict
- 标记改造和迭代
  - 升级代码

返回: Pytest权威教程

使用Marks标记测试用例

通过使用pytest.mark你可以轻松地在测试用例上设置元数据。例如, 一些常用的内置标记：

skip - 始终跳过该测试用例
skipif - 遇到特定情况跳过该测试用例
xfail - 遇到特定情况,产生一个“期望失败”输出
parametrize - 在同一个测试用例上运行多次调用(译者注: 参数化数据驱动)

创建自定义标记或将标记应用于整个测试类或模块很容易。文档中包含有关标记的示例,详情可参阅[使用自定义标记。

注意：

标记只对测试用例有效,对fixtures方法无效。

在未知标记上引发异常： -strict

当使用--strict命令行参数时,未在pytest.ini文件中注册的任何标记都将引发异常。

标记可以通过以下方式注册：

[pytest]

markers =

    slow

    serial

这可用于防止用户意外输错标记名称。想要强制执行此操作的测试套件应将--strict添加到addopts：

[pytest]

addopts = --strict

markers =

    slow

    serial

标记改造和迭代

3.6版本新函数

pytest的标记传统地实现是通过简单地在测试函数的__dict__中添加属性来进行标记。结果,标记意外的随着类的集成而传递。此外,使用@pytest.mark装饰器应用的标记和通过node.add_marker添加的标记存储的位置不同,用于检索它们的API也

不一致。

这样,如果不深入了解测试代码内部结构,技术上几乎无法正确使用参数化数据,从而导致在高级的使用方法中出现细微且难以理解的bug。

根据标记声明/更改的方式,你都可以获得一个MarkerInfo对象,其中也可能会包含来自同级类的标记。当使用参数化标记,或node.add_marker时,会丢弃之前的使用装饰器声明的MarkDecorators标记。MarkerInfo对象实际上是使用同一标记名的多个标记的合并视图,当然,MarkerInfo也可以像单个标记一样使用。

最重要的是,即使标记是在类/模块上声明的,实际上,标记只能在函数中访问。原因是模块,类和函数/方法无法以相同的方式访问标记。

在pytest 3.6版本中引入了一个访问标记的新API,以解决初始设计中的问题,提供_pytest.nodes.Node.iter_markers()方法以一致的方式迭代标记并重新进行内部处理,这很好地解决了初始设计的问题。

升级代码

不推荐使用原有的Node.get_marker(name)函数,因为它返回一个内部MarkerInfo对象,该对象包含应用于该节点的所有标记的合并名称和所有参数。

通常,有两种方案可以处理标记：

标记互相覆盖。顺序很重要,但你只需要将你的标记视为单独的标记即可。例如。对于测试用例中的log_level('debug')会覆盖模块级别的log_level('info')。

在这种情况下,可以使用Node.get_closest_marker(name)：

# 替换这个:

marker = item.get_marker("log_level")

if marker:

    level = marker.args[0]

# 通过这个:

marker = item.get_closest_marker("log_level")

if marker:

    level = marker.args[0]

在特定条件下使用标记。例如,skipif(condition)标记,意味着你只想测试所有非condition条件的用例,顺序不重要。你可以将这个标记视为一个满足该条件的集合使用。

在这种情况下,迭代每个标记并单独处理它们的*args和**kwargs参数。

# 替换这个：

skipif = item.get_marker("skipif")

if skipif:

    for condition in skipif.args:

        # eval condition

        ...

# 通过这个:

for skipif in item.iter_markers("skipif"):

    condition = skipif.args[0]

    # eval condition

如果你不确定或遇到任何难题,你可以考虑提出一个待解决问题。

注意：

在未来的Pytest主要版本中,我们将引入基于类的标记,在这些标记处,标记将不再局限于Mark的实例。