pytest Fixture装饰器学习笔记（二）

一、fixture介绍

　　fixture是pytest特有的功能，它用pytest.fixture标识，定义在函数前面。在你编写测试函数的时候，你可以将此函数名称作为传入参数，pytest将会以依赖注入方式，将该函数的返回值作为测试函数的传入参数。

　　fixture有明确的名字，在其他函数，模块，类或者整个工程调用它时被激活。

　　fixture是基于模块来执行的，每个fixture的名字就可以触发一个fixture的函数，它自身也可以调用其他的fixture。

　　我们可以把fixture看作是资源，在你的测试用例执行之前需要去配置这些资源，执行完成后需要去释放资源。比如module类型的fixture，适合于那些许多测试用例都只需要执行一次的操作。

　　fixture还提供了参数化功能，根据配置和不同组件来选择不同的参数。

　　fixture主要的目的是为了提供一种可靠和可重复性的手段去运行那些最基本的测试内容。比如在测试网站的功能时，每个测试用例都要登陆和退出，利用fixture就可以只做一次，否则每个测试用例都要做这两步也是冗余。

　　下面会反复提高python的module概念，python中的一个module对应的就是一个.py文件。其中定义的所有函数或者变量都属于这个module。这个module对于所有函数而言就相当于一个全局的命名空间，而每个函数又都有自己局部的命名空间。

二、fixture基础实例入门

把一个函数定义为fixture很简单，只要在函数声明之前加上“@pytest.fixture”即可。其他函数要来调用这个fixture，只用把它当作一个输入的参数即可。

文件名称：test_fixture_basic.py

import pytest

@pytest.fixture()
def before():
    print ('nbefore each test')

def test_1(before):
    print ('test_1()')

def test_2(before):
    print ('test_2()')
    assert 0

 运行结果如下图：test_1和test_2运行之前都调用了before，也就是before执行了两次。默认情况下，fixture是每个测试用例如果调用了该fixture就会执行一次的。

三、调用fixture的三种方式

　　1. 在测试用例中直接调用它，例如第二部分的基础实例

　　2. 用fixture装饰器调用fixture

　　可以用以下三种不同的方式来写，我只变化了函数名字和类名字，内容没有变。第一种是每个函数前声明，第二种是封装在类里，类里的每个成员函数声明，第三种是封装在类里在函数前声明。可以看到三种不同方式的运行结果都是一样的。

文件名称：test_fixture_decorator.py

import pytest

@pytest.fixture()
def before():
    print('
before each test')

@pytest.mark.usefixtures("before")
def test_1():
    print('test_1()')

@pytest.mark.usefixtures("before")
def test_2():
    print('test_2()')

class Test1:
    @pytest.mark.usefixtures("before")
    def test_3(self):
        print('test_1()')

    @pytest.mark.usefixtures("before")
    def test_4(self):
        print('test_2()')

@pytest.mark.usefixtures("before")
class Test2:
    def test_5(self):
        print('test_1()')

    def test_6(self):
        print('test_2()')

 运行结果如下图：和上面的基础实例运效果一样。 

　　3. 用autouse调用fixture

　　fixture装饰器的一个optional可选的参数autouse，默认设置为False.

源代码如下：
def fixture(scope="function", params=None, autouse=False, ids=None, name=None):
    if callable(scope) and params is None and autouse is False:
        # direct decoration
        return FixtureFunctionMarker("function", params, autouse, name=name)(scope)
    if params is not None and not isinstance(params, (list, tuple)):
        params = list(params)
    return FixtureFunctionMarker(scope, params, autouse, ids=ids, name=name)

　　当默认False时就可以用上面两种方式调用fixture。

　　当设置True时，在一个session内的所有的test都会自动调用这个fixture。权限大，责任也大，所以用该功能时也要谨慎小心。

mport time
import pytest

@pytest.fixture(scope="module", autouse=True)
def mod_header(request):
    print('
-----------------')
    print('module      : %s' % request.module.__name__)
    print('-----------------')

@pytest.fixture(scope="function", autouse=True)
def func_header(request):
    print('
-----------------')
    print('function    : %s' % request.function.__name__)
    print('time        : %s' % time.asctime())
    print('-----------------')

def test_one():
    print('in test_one()')

def test_two():
    print('in test_two()')

从下面的运行结果，可以看到mod_header在该module内运行了一次，而func_header对于每个test都运行了一次，总共两次。该方式如果用得好，还是可以使代码更为简洁。
但是对于不熟悉自己组的测试框架的人来说，在pytest里面去新写测试用例，需要去了解是否已有一些fixture是module或者class级别的需要注意。

四、fixture scope

function：每个test都运行，默认是function的scope
class：每个class的所有test只运行一次
module：每个module的所有test只运行一次
session：每个session只运行一次

比如你的所有test都需要连接同一个数据库，那可以设置为module，只需要连接一次数据库，对于module内的所有test，这样可以极大的提高运行效率。

五、fixture返回值

在上面的例子中，fixture返回值都是默认None，我们可以选择让fixture返回我们需要的东西。如果你的fixture需要配置一些数据，读个文件，或者连接一个数据库，那么你可以让fixture返回这些数据或资源。

如何带参数
fixture还可以带参数，可以把参数赋值给params，默认是None。对于param里面的每个值，fixture都会去调用执行一次，就像执行for循环一样把params里的值遍历一次。
test_fixture_param.py

import pytest

@pytest.fixture(params=[1, 2, 3])
def test_data(request):
    return request.param

def test_not_2(test_data):
    print('test_data: %s' % test_data)
    assert test_data != 2

可以看到test_not_2里面把用test_data里面定义的3个参数运行里三次。

 参考资料：https://www.jianshu.com/p/54b0f4016300