pytest关键字详解

一、pytest之跳过用例 @pytest.mark.skip和@ pytest.mark.skipif

1-1、@pytest.mark.skip (无条件跳过，只要使用了这个关键字就会跳过)

参数：reason（跳过的原因）

该参数非必传，可传可不传

代码：

import pytest
class TestIndex():
    @pytest.mark.skip(reason='跳过该用例')
    def test_myself(self):
        print '我被跳过了'

    def test_class(self):
        print '我没被跳过'

运行结果：

1-2、@pytest.mark.skipif（有条件跳过，只有符合条件才会跳过）

参数：

reason（跳过的原因）该参数非必传，可传可不传

condition  （跳过条件），只有当该条件结果为True时才会跳过该用例

代码：

import pytest
class TestIndex():
    @pytest.mark.skipif(condition=2>1,reason='因为2>1为真，所以跳过该用例')
    def test_myself(self):
        print '我被跳过了'

    def test_class(self):
        print '我没被跳过'

运行结果：

 1-3、除了上面两个注解以外，还可以通过调用pytest.skip()来跳过用例

代码：

import pytest
class TestIndex():
    def test_myself(self):
        pytest.skip(msg='跳过该用例')
        print '我被跳过了'

    def test_class(self):
        print '我没被跳过'

 运行结果：

 跳过用例类或用例函数的方法一样，使用1或2两个注解修饰即可

跳过模块则需要使用变量pytestmark，让它等于标签

import pytest
pytestmark=pytest.mark.skipif(condition=2>1,reason='因为2>1为真，所以跳过该用例')
class TestIndex():
    def test_myself(self):
        print '我被跳过了'

    def test_class(self):
        print '我没被跳过'

运行结果：

二、 标签@pytest.mark.parametrize（）详解：

该标签是一种参数化方式，pytest有两种参数化方式，除了此标签外，还有一种是@pytest.fixture(params=[]),这个在这里不做解释，在后面fixture篇会详细说明

接下来解释说明@pytest.mark.parametrize()的各个参数

2-1、argnames、argvalues

必传参数，argnames定义参数名，argvalues为参数值

argnames数量与argvalues数量一一对应

用法：

2-1-1、单参数单值

代码：

import pytest
class TestIndex():
    @pytest.mark.parametrize(argnames='arg',argvalues=['我是参数arg'])
    def test_myself(self, arg):
        print arg

运行结果：

2-1-2、单参数多值

代码：

import pytest
class TestIndex():
    @pytest.mark.parametrize(argnames='arg',argvalues=['我是参数arg',(1),['arg']])
    def test_myself(self, arg):
        print arg

运行结果：

标签中设置了三组值，用例执行了三次，这就是pytest 的数据驱动，参数值有n组，用例就会遍历执行n次

2-1-3、多参数多值

代码：

import pytest
class TestIndex():
    @pytest.mark.parametrize(argnames="arg1,arg2",
                             argvalues=[("我是第一个参数",'我是第二个参数'),('第二次第一个参数','第二次第二个参数')])
    def test_myself(self, arg1, arg2):
        print arg1+'、'+arg2

 运行结果：

这里多参数时，参数值是一个元组，一个元组是一组参数

2-2、 indirect

1），indirect一般与pytest的request、fixture组合使用

2），当indirect为true时，argnames则要传入fixture的函数名，不再是普通参数，而是要被调用的fixture函数，argvalues则是要给这个参数传的值

3），作用其实与pytest.fixture(params)一样，但使用了@pytest.mark.parametrize相当于参数化了fixture

2-2-1.单fixture单值（列表形式传值）

代码：

import pytest
class TestIndex():
    @pytest.fixture()
    def qianzhi(self,request):   #request是pytest的固定用法，用于接收传参并调用
        user = request.param
        print '传入的用户名：%s' % user
        return user               #如果想fixture有返回值，直接return即可，这个返回值可以在调用                                            
                                  #它的测试函数中使用

    user = ['张三','李四']

    @pytest.mark.parametrize('qianzhi', user, indirect=True)   # 这里的'qianzhi'就是调用的    
                                                               # fixture的函数名，user为传递 
                                                               # 给fixture的值
    def test_myself(self, qianzhi):    #  这里入参的qianzhi就是fixture的调用，便且可以拿到 
                                       #  fixture的返回值，如果fixture有返回值
        print '测试类接收的用户名：%s' % qianzhi

运行结果：

 2-2-2.单fixture多值（字典形式传值）

代码：

import pytest
class TestIndex():
    @pytest.fixture()
    def qianzhi(self,request):
        user = request.param
        print '传入的用户名：%s,密码：%s' % (user['user'],user['pwd'])
        return user

    user = [
        {'user':'张三','pwd': '123'},
        {'user':'李四','pwd': '456'}]

    @pytest.mark.parametrize('qianzhi', user, indirect=True)
    def test_myself(self, qianzhi):
        print '测试类接收的用户名：%s,密码：%s' % (qianzhi['user'],qianzhi['pwd'])

运行结果：

 

2-2-3. 多fixture多值（嵌入元组的列表形式传参）

代码：

import pytest
class TestIndex():
    @pytest.fixture()
    def login(self,request):
        user = request.param
        print '传入的用户名：%s' %user
        return user
    @pytest.fixture()
    def pwd(self,request):
        user = request.param
        print '传入的密码：%s' % user
        return user

    user = [
        ('张三','123'),
        ('李四','456')]

    @pytest.mark.parametrize("login,pwd", user, indirect=True)
    def test_myself(self, login,pwd):
        print '测试类接收的用户名：%s,密码：%s' % (login,pwd)

运行结果：

 

2-2-4.叠加fixture（单值列表，执行次数是笛卡尔积N*M）

代码：

import pytest
class TestIndex():
    @pytest.fixture()
    def login_user(self,request):
        user = request.param
        print '传入的用户名：%s' %user
        return user
    @pytest.fixture()
    def login_pwd(self,request):
        pwd = request.param
        print '传入的密码：%s' % pwd
        return pwd

    user = ['张三','李四']
    pwd = ['123','456']

    @pytest.mark.parametrize("login_user", user, indirect=True)
    @pytest.mark.parametrize("login_pwd", pwd, indirect=True)
    def test_myself(self, login_user,login_pwd):
        print '测试类接收的用户名：%s,密码：%s' % (login_user,login_pwd)

运行结果：

 

可以看到一共执行了四次，也就是每个fixture传入值的个数的积

总结：当indirect为True时就是调用fixture，将参数传入fixture做一次前置处理，为False时就是普通的参数化

 2-3、ids（用来设置标题）

不设置ids的情况下，pytest执行后会用输入数据作为用例标题显示

使用ids可以自定义用例标题

但注意，使用中文时 会显示unicode编码

解决方法：

在test_case同级目录新建conftest.py文件，在文件中添加以下代码：

from typing import List
def pytest_collection_modifyitems(
    session: "Session", config: "Config", items: List["Item"]
) -> None:
    for item in items:
        item.name = item.name.encode('utf-8').decode('unicode-escape')
        item._nodeid = item.nodeid.encode('utf-8').decode('unicode-escape')

2-4、scope

scope的作用范围取值与fixture 的scope一致，当indirect=True才会被使用

scope的作用范围会覆盖fixture的scope范围，如果同一个被调用的fixture有多个parametrize定义了scope,取第一条的范围，见下例：

2-4-1.小于Fixture的scope范围：

 2-4-2.大于Fixture的scope范围：

  2-4-3.多个parametrize不同的scope范围，为先执行的范围：

 

 2-4-4.与mark变量一起使用，标记子用例

代码：

import pytest

class TestIndex():

    @pytest.mark.parametrize('x,y',[('test','123'),
                                    pytest.param('test1','1234',marks=pytest.mark.xfail)])
    def test_myself(self,x,y):
        print '用户名：%s 密码：%s' % (x,y)

运行结果：

 三、pytest.mark.自定义标签使用

可以标记测试方法、测试类，标记名可以自定义，最好起有意义的名字

同一测试类/方法可同时拥有多个标记

3-1，实例：

import pytest

@pytest.mark.login
class TestIndex():

    @pytest.mark.test
    def test_myself(self):
        print '示例'
    @pytest.mark.start
    def test_myself(self):
        print 'kaishi'

 3-2、运行方法;

pytest -m "自定义标签名" 
或：
pytest.main(['-m 自定义标签名'])

3-3、 组合运行用例:

使用-m参数运行标记的用例，-m参数支持and、or、not等表达式

3-4、 注册、管理mark标记：

当使用 -m 参数执行 mark 标记的用例时，pytest 会发出告警信息 “PytestUnknownMarkWarning: Unknown pytest.mark.login - is this a typo? ”，告诉你这是一个 pytest 未知的一个标记！为了消除告警，我们需要在 pytest 的配置文件中注册 mark 标记！

注册mark标记：

首先在项目根目录创建一个文件 pytest.ini ，这个是 pytest 的配置文件

 然后在 pytest.ini 文件的markers 中写入你的 mark 标记， 冒号 “:” 前面是标记名称，后面是 mark 标记的说明，可以是空字符串

 注意：pytest.ini 文件中只能使用纯英文字符，绝对不能使用中文的字符（尤其是冒号和空格）

 规范使用mark标记：

注册完 mark 标记之后 pytest 便不会再告警，但是有时手残容易写错 mark 名，导致 pytest 找不到用例，一时想不开很难debug，尤其是团队协作时很容易出现类似问题

处理方法：在 pytest.ini 文件中添加参数 “addopts = --strict”

 添加该参数后，当使用未注册的 mark 标记时，pytest会直接报错：“ ‘xxx’ not found in markers configuration option ”，不执行测试任务

 注意：pytest.ini 配置文件不支持注释，不支持注释，不支持注释…