pytest学习4-fixtures

源码注释:

def fixture(scope="function", params=None, autouse=False, ids=None, name=None):

 """这是一个标记工厂函数的装饰器.
不管是否带有参数,这个装饰器是用来定义一个fixture函数.
fixture函数的函数名被引用后,能够在运行测试用例前被调用:
测试模块或类可以使用pytest.marker.usefixtures(fixturename)来标记.

测试用例函数可以直接使用被装饰的fixture名称,作为测试函数的输入参数,在这种情况下,
fixture函数将返回一个fixture实例来注入测试用例函数,即作为入参传递。

fixture可以使用‘return’或者‘yield’语句来返回他们的值.使用‘yield’时,
‘yield’语句后的代码块将作为teardown代码执行,不管测试结果如何,必须只生成一次,
也就是说yield语句后的代码只有在最后一次调用后执行.

:参数 scope: 共享scope范围的fixture, 有以下几种:
            ``"function"`` (默认), ``"class"``, ``"module"``,
            ``"session"``,``"package"``(实验中) .

:参数 params: 一个可选的参数列表,能够使得fixture函数的多次调用和所有测试用例函数使用它.

:参数 autouse: 如果为True,那么该fixture函数将被激活,所有测试对象都能使用;
如果为False,那么激活该fixture函数需要显式引用.

:参数 ids: 字符串ids的列表,每个id对应着参数,以便于他们是测试id的一部分,
如果没有提供id,那么将由参数自动生成.

:参数 name: fixture的名称,默认是被装饰的函数的名字.
如果一个fixture在同一个模块中被定义使用,那么该fixture的函数名将被请求fixture的函数参数隐藏. 
解决此问题的方法是命名该装饰函数:
``fixture_<fixturename>````@pytest.fixture(name='<fixturename>')``.
"""

fixture的作用范围

    + fixture里面有个scope参数可以控制fixture的作用范围:session>module>class>function
    + -function:每一个函数或方法都会调用
    + -class:每一个类调用一次,一个类中可以有多个方法
    + -module:每一个.py文件调用一次,该文件内又有多个function和class
    + -session:是多个文件调用一次,可以跨.py文件调用,每个.py文件就是module
    1.fixture为function级别的时候,它的作用范围是每个测试用例来之前运行一次,销毁代码在测试用例之后运行。
    2.fixture为class级别的时候,如果一个class里面有多个用例,都调用了次fixture,那么此fixture只在此class里所有用例开始前执行一次。
    3.fixture为module时,在当前.py脚本里面所有用例开始前只执行一次。
    4.fixture为session级别是可以跨.py模块调用的,也就是当我们有多个.py文件的用例的时候,如果多个用例只需调用一次fixture,那就可以设置为scope="session",并且写到conftest.py文件里。

fixture的调用:

定义fixture跟定义普通函数差不多,唯一区别就是在函数上加个装饰器@pytest.fixture(),fixture命名不要以test开头,跟用例区分开。fixture是有返回值得,没有返回值默认为None。用例调用fixture的返回值,直接就是把fixture的函数名称当做变量名称。
例如:
        import pytest
        @pytest.fixture()
        def test():
            list1=[1,2,3,4,5,6]
            return list1
        def test_func(test):
             print("传入的参数:"+str(test))
            for i in test:
            assert 1==i
    输出:
    ============================ test session starts ==============================
    test_fix-1.py 传入的参数:[1, 2, 3, 4, 5, 6]
    @pytest.fixture()装饰器用于声明函数是一个fixture,如果测试函数的参数列表中包含fixture名,那么pytest会检测到,并在测试函数运行之前执行该fixture。fixture可以完成任务,也可以返回数据给测试函数。
    建议:被fixture装饰的函数别以test命名,比如上面的命名为some_data,而不是test_data。当然,这样命名也没有错,只是为了方便区分是fixture还是测试用例(函数)

多个fixture调用:

    如果用例需要用到多个fixture的返回数据,fixture也可以返回一个元祖,list或字典,然后从里面取出对应数据。
    import pytest
    @pytest.fixture()
    def data1():
            list1=[1,2,3,4,5,6]
            return list1
    @pytest.fixture()
    def data2():
        list1=[3,4,5,6,7,8]
        return list1
    def test_func(data1,data2):
        print("传入的参数:"+str(data1))
        print("传入的参数:"+str(data2))
        assert len(data1)==len(data2)
    if __name__ == '__main__':
        pytest.main["-s","test_fix-1.py"]
    输出:
    test_fix-1.py 传入的参数:[1, 2, 3, 4, 5, 6]
    传入的参数:[3, 4, 5, 6, 7, 8]
    .

conftest.py

    fixture可以放在单独的测试文件里,如果你希望多个测试文件共享fixture,可以在某个公共目录下新建一个conftest.py文件,将fixture放在其中。
    如果你希望fixture的作用域仅限于某个测试文件,那么将它写在该测试文件里。可以供所在目录及其子目录下的测试使用。
    说明:
    尽管conftest.py是python模块,但它不能被当测试文件导入,import conftest的用法是不允许出现的。
    例如:
    conftest.py:
    import pytest
    @pytest.fixture()    
    def data_list():
        return [1,2,3,4,5,6]
    test_fix-1.py:
    def test_func(data_list):
        print("传入的参数:"+str(data_list))
        assert len(data_list)==4
    运行结果:test_fix-1.py 传入的参数:[1, 2, 3, 4, 5, 6]
    当pytest执行test_func函数时,会自动去conftest.py里找data_list并执行,这样比如我们的用例,有些需要登录,有些不需要登录,我们可以给需要登录的用例加上fixture.

fixture配置及yield

     fixture会在测试函数之前运行,但如果fixture函数包含yield,那么系统会在yield处停止,转而执行测试函数,等测试函数执行完毕后再回到fixture,继续执行yield后面的代码。因此,可以将yield之前的代码视为配置(setup)过程,将yield之后的代码视为清理(teardown)过程,无论测试过程中发生了什么,yield之后的代码都会被执行
    例如以下代码:
    @pytest.fixture(scope="module")
    def data_list():
        print("打开浏览器,并且打开百度首页")
        yield
        print("执行teardown!")
        print("最后关闭浏览器")
    def test_func(data_list):
        print("开始执行测试用例一")
    def test_func1(data_list):
        print("开始执行测试用例二")
    输出结果:
    test_fix-1.py 打开浏览器,并且打开百度首页
    开始执行测试用例一
   .开始执行测试用例二
    .执行teardown!
    最后关闭浏览器

--setup-show

    上面的运行结果中,没有具体看到执行结果,可以加入参数--setup-show查看具体执行过程,命令:pytest -s --setup-show test_fix-1.py 

设置autouse=True

    平常写自动化用例会写一些前置的fixture操作,用例需要用到就直接传该函数的参数名称就行了。当用例很多的时候,每次都传这个参数,会比较麻烦。fixture里面有个参数autouse,默认是Fasle没开启的,可以设置为True开启自动使用fixture功能,这样用例就不用每次都去传参了。
    代码:
    @pytest.fixture(scope="session",autouse=True)
    def data_list():
            print("打开浏览器,并且打开百度首页")
            yield
            print("执行teardown!")
            print("最后关闭浏览器")

使用usefixture方法

    使用装饰器@pytest.mark.usefixtures()修饰需要运行的用例
    代码如下:      
    @pytest.mark.usefixtures("data_list")
    def test_func():
        print("开始执行测试用例一")
    @pytest.mark.usefixtures("date_list")
    def test_func1():
        print("开始执行测试用例二")
原文地址:https://www.cnblogs.com/qixc/p/12167484.html