pytest自动化测试fixture的作用域实例化顺序及可用

编辑: admin 分类: python 发布时间: 2022-02-22 来源:互联网
目录
  • 1. fixture的作用域
    • 1.1 scope
      • 1.function:
      • 2.class:
      • 3.module:
      • 4.package:
      • 5.session:
    • 1.2 动态作用域(Dynamic scope)
      • 1.带参数-k运行
      • 2.无参数-k运行
  • 2. fixture的实例化顺序
    • 2.1 作用域级别高的fixture先执行
      • 2.2 fixture函数的依赖项先执行
        • 2.3 自动使用的fixture在其作用域内首先执行
        • 本节总结
          • 3. fixture的可用性

            1. fixture的作用域

            1.1 scope

            通过前面文章的介绍,我们知道@pytest.fixture()有一个scope参数,并且有五个作用域级别,这五个作用域级别的说明总结如下:

            注意:fixture是在测试首次请求时创建的,并基于它们的作用域被销毁。

            scope 说明 function 默认值,函数或方法级别被调用,当函数执行结束后,fixture则被销毁 class 类级别调用一次,当类中的最后一个测试函数执行结束后,fixture则被销毁 module 模块级别(每一个.py文件)调用一次,当模块中最后一个测试函数执行结束后,fixture则被销毁 package 包(一个文件夹下的.py文件)级别调用一次,当包中最后一个测试函数执行结束后,fixture则被销毁 session 多个文件调用一次,当多文件中最后一个测试函数执行结束后,fixture则被销毁

            单看说明,还是不太好理解的,所以下面我们通过示例来了解一下scope的用法。

            示例1:

            1.function:

            演示代码:

            import pytest
            @pytest.fixture()
            def login():
                print('登陆操作')
                yield
                print('注销操作')
            class TestClass:
                def test_case1(self,login):
                    print("TestClass:test_case1")
            
                def test_case2(self):
                    print("TestClass:test_case2")
                    
            

            运行结果:

            在这里插入图片描述

            说明:

            演示代码中,我们定义了一个fixture函数——login 和两个测试函数 test_case1test_case2

            装饰器@pytest.fixture()没有指定scope参数,因此使用默认值:function

            test_case1test_case2TestClass类中,且test_case1调用了logintest_case2未调用。

            通过运行结果,我们可以看出来,scope=function的fixture——login,只在调用了它的test_case1这个测试函数前后执行。test_case2未执行。

            2.class:

            演示代码:

            import pytest
            @pytest.fixture(scope='class')   #名为login的fixture,完成登陆和注册操作
            def login():
                print('登陆操作')
                yield
                print('注销操作')
            class TestClass1:
                def test_case1(self,login):  #调用了login
                    print("TestClass1:test_case1")
                def test_case2(self):
                    print("TestClass1:test_case2")
            class TestClass2:
                def test_case1(self):
                    print("TestClass2:test_case1")
                def test_case2(self,login):  #调用了login
                    print("TestClass2:test_case2")
            @pytest.mark.usefixtures("login")  #TestClass3这个类,使用usefixtures调用了login
            class TestClass3:
                def test_case1(self):
                    print("TestClass3:test_case1")
                def test_case2(self):
                    print("TestClass3:test_case2")
            
            

            运行结果:

            在这里插入图片描述

            说明:

            演示代码中我们定义了一个fixture——login;三个测试类——TestClass1TestClass2TestClass3,这个三个测试类中都定了两个测试函数——test_case1test_case2

            对fixture函数我们声明了其作用域——scope='class'
            TestClass1中,只有test_case1调用了login
            TestClass2中,只有test_case1调用了login
            TestClass3,我们使用@pytest.mark.usefixtures("login"),让整个类调用了login

            查看运行结果我们可以发现:
            TestClass1中,test_case1运行前有”登陆操作“打印,并在test_case2执行后有”注销操作“显打印。
            TestClass2中,只有test_case2运行前有”登陆操作“打印,并在test_case2执行后有”注销操作“打印。而test_case1执行前后并无任何数据打印。
            TestClass3则与Testclass1执行后数据显示一致。

            TestClass1TestClass2结果的不同是由什么原因造成的呢?
            官方文档在介绍fixture的scope的时候,有这样一句话,上文中也有提到:fixture是在测试首次请求时创建的,并基于它们的作用域被销毁。(Fixtures are created when first requested by a test, and are destroyed based on their scope。)
            对于TestClass1test_case1调用了login,因此会在test_case1执行的时候,创建login,并在其执行之前打印了”登陆操作“。又根据login的scope——class,在TestClass1的最后一个测试函数test_case2执行后,根据login的功能打印”注销操作“,并销毁login
            对于TestClass2login是由test_case2调用的,而test_case1test_case2先执行,所以test_case1执行的时候login还未被调用,fixture未被创建。直到执行test_case2时,login才被创建并进行了对应的操作。
            后面其他类型的作用域示例中将不会在演示此种情况。

            3.module:

            演示代码:

            import pytest
            @pytest.fixture(scope='module')   #名为login的fixture,完成登陆和注册操作
            def login():
                print('登陆操作')
                yield
                print('注销操作')
            @pytest.mark.usefixtures("login")
            class TestClass1:
                def test_case1(self):
                    print("TestClass1:test_case1")
                def test_case2(self):
                    print("TestClass1:test_case2")
            class TestClass2:
                def test_case1(self):
                    print("TestClass2:test_case1")
                def test_case2(self):
                    print("TestClass2:test_case2")
            
            
            

            运行结果:

            在这里插入图片描述

            说明:

            演示代码中,我们定义了:
            一个fixture——login(),并且声明其scope=”module“
            两个测试类——TestClass1TestClass2
            两个测试类中分别定义了两个测试函数——test_case1test_case2
            TestClass1使用@pytest.mark.usefixtures("login")的方法,调用了login()

            运行结果显示:
            执行时,自第一个测试函数TestClass1中的test_case1调用login()时,该fixture被创建,并且按照login()实现的功能打印"登陆操作",并在当前模块中(一个.py文件)最后一个测试函数TestClass2中的test_case2执行结束后,按照login()实现的功能打印"注销操作",然后被销毁。

            4.package:

            演示代码:

            首先看一下测试包目录,新增一个conftest.py。里面所有的模块都是上面的演示代码。修改这些模块里代码,注释调feature函数,删掉调用即可。

            在这里插入图片描述

            conftest.py

            import pytest
            @pytest.fixture(scope='package',autouse=True)   #名为login的fixture,完成登陆和注册操作
            def login():
                print('登陆操作')
                yield
                print('注销操作')
                
            

            使用命令行运行:

            在这里插入图片描述

            运行结果:

            在这里插入图片描述

            说明:
            conftest.py中声明了一个fixture——login(),并且设置scope='package'autouse=True

            使用命令行方式运行test_scope这个测试包中的所有模块。查看运行结果,在test_scope中第一个测试函数调用login()的时候,login创建,并按照功能打印”登陆操作“。在test_scope中最后一个测试函数运行结束后,按照login()功能打印出”注销操作“,并销毁login()

            5.session:

            使用package的演示代码,需改conftest.pylogin()scope='session',然后我们直接在终端中使用命令行运行多个文件。

            运行以下命令:

            在这里插入图片描述

            运行结果:

            在这里插入图片描述

            说明:

            使用命令行方式运行test_scope这个测试包中的test_class.py和test_function.py。查看运行结果,在test_class.py中第一个测试函数调用login()的时候,login创建,并按照功能打印”登陆操作“。在test_function.py中最后一个测试函数运行结束后,按照login()功能打印出”注销操作“,并销毁login()

            1.2 动态作用域(Dynamic scope)

            在某些情况下,我希望在不更改代码的情况下更改feature的作用域。pytest的从5.2版本开始,提供了动态作用域的方法,来解决这种情况。

            通过官方文档的说明,我们了解到,可以将一个可调用对象传递给scope来实现动态作用域。这个可调用对象必须满足以下三个条件:

            1.这个可调用对象返回类型需是string,且必须是有效的scope级别,即只能返回"function""class""module""package""session"中的一个。
            2.在fixture定义期间,这个可调用对象只能被执行一次,不能被多次调用。
            3.这个可调用对象定义的时候,必须使用fixture_nameconfig作为参数。

            下面通过示例给大家演示以下用法。

            示例2:

            演示代码:

            import pytest
            def dynamic_fixture_scope(fixture_name,config):
                if config.getoption("-k",None):   
                    return "function"
                return "class"
            @pytest.fixture(scope=dynamic_fixture_scope,autouse=True)
            def login():
                print('登陆操作')
                yield
                print('注销操作')
            class TestClass1:
                def test_A(self):
                    print("这是TestClass1:test_A")
                def test_B(self):
                    print("这是TestClass1:test_B")
            class TestClass2:
                def test_A(self):
                    print("这是TestClass2:test_A")
            
            

            说明:

            dynamic_fixture_scope:用来管理fixture的作用域,这个函数按照pytest官方文档的要求,带有fixture_nameconfig两个关键字作为参数,并且实现下述功能:

            1.当用命令行运行测试时,运行命令中带有‘-k'参数,则被调的fixture函数的作用域为"function"

            2.其余情况下,被调的fixture的函数为"class"

            login:一个使用动态作用域方法的fixture,其scope=dynamic_fixture_scope。为了方便演示,autouse也被设置为True

            下面我们分两种情况来运行看看:

            1.带参数-k运行

            运行命令:我们只运行测试名称中包含test_A的测试函数。

            pytest -vs -k 'test_A' test_dynamicscope.py
            

            运行结果:

            在这里插入图片描述

            通过运行结果可以看到,当命令行中出现-k参数的时候,loginscope确实是function级别的。两个被选中的测试函数分别在不同的测试类中,但是都调用了login

            2.无参数-k运行

            运行命令:我们不带参数-k运行。

            pytest -vs test_dynamicscope.py 
            

            运行结果:

            在这里插入图片描述

            通过运行结果可以看到,无-k参数的时候,loginscope确实是class级别的。

            2. fixture的实例化顺序

            根据官方文档,我们了解到影响fixture实例化顺序的三个因素是:

            1. 作用域(scope)
            2. 依赖项
            3. 自动调用(autouse)

            而fixture名称、测试函数名称以及定义它们的位置一般都不会影响执行顺序。

            下面介绍一下这个三个因素是如何影响实例化顺序的。

            2.1 作用域级别高的fixture先执行

            我们直接使用官方文档提供的示例来说明。

            示例3:

            演示代码:

            import pytest
            @pytest.fixture(scope="session")
            def order():
                return []
            @pytest.fixture
            def func(order):
                order.append("function")
            @pytest.fixture(scope="class")
            def cls(order):
                order.append("class")
            @pytest.fixture(scope="module")
            def mod(order):
                order.append("module")
            @pytest.fixture(scope="package")
            def pack(order):
                order.append("package")
            @pytest.fixture(scope="session")
            def sess(order):
                order.append("session")
            class TestClass:
                def test_order(self, func, cls, mod, pack, sess, order):
                    assert order == ["session", "package", "module", "class", "function"]
            
            

            运行结果:

            在这里插入图片描述

            说明:
            演示代码中我们定义了:
            六个fixture函数:

            order:scope为session级别,返回一个空list。func: 调用了order,scope为默认的function级别,并实现向order返回的列表中插入”function“的操作。cls:调用了order,scope为class级别,并实现向order返回的列表中插入”class“的操作。mod:调用了order,scope为module级别,并实现向order返回的列表中插入”module“的操作。pack:调用了order,scope为package级别,并实现向order返回的列表中插入”package“的操作。sess:调用了order,scope为session级别,并实现向order返回的列表中插入”session“的操作。

            一个测试函数:
            test_order:主要目的是通过list中元素的顺序来判断是否按照预想的顺序执行fixture。

            根据运行结果显示,测试断言通过,也就是fixture的执行顺序是按照我们预期的scope的级别由高到低去执行的。

            test_order调用fixture的顺序是func, cls, mod, pack, sess, order,而实际执行的顺序是order, sess, pack, mod, cls, func。由此可见,我们在调用时定义的顺序不会影响到fixture的实际执行顺序的。

            官网执行顺序图:

            在这里插入图片描述

            其中sessorder的scope都是session级别的,但是因为order是sess的依赖项,所以会先调用order,这个一点正好我们下面要说明。

            2.2 fixture函数的依赖项先执行

            前面文章中有说过,fixture函数是可以调用另外一个fixture函数的。在执行的时候,也是先执行调用的那个fixture函数。举了例子,fixture a 调用了fixture b,当测试函数调用fixture a的时候,会先去执行fixture b 然后再执行fixture a,最后执行测试函数。

            这是因为fixture b 是fixture a 的依赖项,fixture a 可能会需要fixture b提供一些条件才能正常被执行。

            下面我们来看一下官方文档提供的一个例子,

            示例4:

            演示代码:

            import pytest
            @pytest.fixture
            def order():
                return []
            @pytest.fixture
            def a(order):
                order.append("a")
            @pytest.fixture
            def b(a, order):
                order.append("b")
            @pytest.fixture
            def c(a, b, order):
                order.append("c")
            @pytest.fixture
            def d(c, b, order):
                order.append("d")
            @pytest.fixture
            def e(d, b, order):
                order.append("e")
            @pytest.fixture
            def f(e, order):
                order.append("f")
            @pytest.fixture
            def g(f, c, order):
                order.append("g")
            def test_order(g, order):
                assert order == ["a", "b", "c", "d", "e", "f", "g"]
            
            

            运行结果:

            在这里插入图片描述

            说明:

            演示代码中定义了八个fixture函数和一个测试函数,其中:
            fixture函数有:ordeabcdefg
            测试函数有:test_order

            a调用了order
            b调用了a, order
            c调用了a, b, order
            d调用了c, b, order
            f调用了e, order
            g调用了f, c, order
            test_order调用了gorder

            我们来整理以上所有函数的依赖关系,他们之间的依赖关系如图所示:

            在这里插入图片描述

            之前文章也有说过,在同一次测试执行过程中,fixture是可以被多次调用的,但是不会被多次执行。执行一次后,fixture的实例对象和返回值会存在缓存中,下次再被调用的时候是直接从缓存中获取的。

            所以上面的顺序我们可以再简化一下:

            在这里插入图片描述

            执行完所有依赖的fixture函数后,我们得到的order的结果为:['a','b','c','d','e'],因此测试断言通过。

            2.3 自动使用的fixture在其作用域内首先执行

            根据官方文档的说明,我们可以得到一下两点重要内容:

            1.当测试函数调用的fixture的作用域级别都一样,那么会首先调用自动使用的fixture。

            示例5:

            import pytest
            @pytest.fixture
            def order():
                return []
            @pytest.fixture
            def func(order):
                order.append("function")
            @pytest.fixture(autouse=True) #修改cls为自动使用fixture
            def cls(order):
                order.append("class")
            @pytest.fixture
            def mod(order):
                order.append("module")
            @pytest.fixture
            def pack(order):
                order.append("package")
            @pytest.fixture
            def sess(order):
                order.append("session")
            class TestClass:
                def test_order(self, func, cls, mod, pack, sess, order):
                    print(order)
                    assert order == ["session", "package", "module", "class", "function"]
            
            

            运行结果:

            在这里插入图片描述

            说明:

            我们把示例3的代码拿过来修改一下,把所有fixture的scope都改为function级别,并且对cls试着autouse=True。
            test_order请求fixture的顺序是:func, cls, mod, pack, sess

            当scope级别一样的时候,且无依赖关系的时候,fixture的执行顺序应该与调用顺序一致,也应该是func, cls, mod, pack, sess。但是实际运行的结果却是['class', 'function', 'module', 'package', 'session']。由此可以判断出,在scope一致且无依赖的情况下,自动执行的fixture是最先被执行的。

            2.对一个autouse的fixture A来说,若调用了非autouse的fixture B,那么对于调用了fixture A的测试函数来说,fixture B也相当于是autouse的。

            我们再来看一下官方给的一个示例。

            示例6:

            演示代码:

            import pytest
            @pytest.fixture
            def order():
                return []
            @pytest.fixture
            def a(order):
                order.append("a")
            @pytest.fixture
            def b(a, order):
                order.append("b")
            @pytest.fixture(autouse=True)
            def c(b, order):
                order.append("c")
            @pytest.fixture
            def d(b, order):
                order.append("d")
            @pytest.fixture
            def e(d, order):
                order.append("e")
            @pytest.fixture
            def f(e, order):
                order.append("f")
            @pytest.fixture
            def g(f, c, order):
                order.append("g")
            def test_order_and_g(g, order):
                assert order == ["a", "b", "c", "d", "e", "f", "g"]
            
            

            说明:

            演示代码中定义了八个fixture函数和一个测试函数,其中:
            fixture函数有:ordeabcdefg
            测试函数有:test_order

            a调用了order
            b调用了a, order
            c调用了 b, order,且是自动使用fixture;
            d调用了 b, order
            f调用了e, order
            g调用了f, c, order
            test_order调用了gorder

            若c是非自动使用的fixture,代码中fixture的一个执行顺序是什么样的呢?

            下图是运行结果:

            在这里插入图片描述

            根据上面的运行结果和下面的顺序图,我们可以看到,除了g调用了c之外,其他函数都没有调用c,而g也调用了f,所以现在还不清楚c应该在d、e、f之前还是之后执行。对c来说他只需在b之后、g之前执行即可。而实际运行结果,c是在d、e、f之后和g之前执行的。

            对于pytest来说,fixture的执行顺序就是不明确,这种情况很可能会影响测试函数的执行行为,影响了测试结果。

            在这里插入图片描述

            所以,我们需要明确fixture的执行顺序。

            当我们使c为自动使用fixture时,这个顺序又会发生什么变化呢?

            下图为运行结果:

            在这里插入图片描述

            根据上图的运行结果和下图的顺序图,我们可以看出来,当自动使用c后,它的执行优先级就比d要高,所以可以保证c是在d之前执行的。这样使执行顺序明确了。

            在这里插入图片描述

            当c是自动使用的fixture后,根据fixture函数的依赖项先执行这一规则,c所依赖的b、b所依赖的a和a所依赖的order都会被执行。这样对于调用了c的g来说,order、a、b也相当于是自动使用的fixture了,但是当有其他fixture调用order、a、b时,order、a、b仍然保持自己的特性。

            本节总结

            我们来总结一下fixture实例化顺序的一个规则:

            1.fixture的scope级别越高,那么它执行的优先级越高。优先级为:session>package>module>class>function

            2.fixture如果存在依赖项,那么它所依赖的fixture函数会先被执行。

            3.同scope级别fixture中,自动使用的fixture会最先执行;若该fixture存在依赖项,则对于调用了fixture的测试函数来说,这些依赖项也可以看做是自动使用的。

            4.我们在编码的时候最好可以依照以上规则为pytest提供一个清晰的fixture执行顺序,以免影响测试函数的行为和测试结果。

            3. fixture的可用性

            对于测试函数来说,能够调用那些fixture,是由fixture定义的位置决定。

            1.当fixture定义在一个测试类中时,只有该类中的测试函数可调用此fixture,其他测试函数无法调用该fixture。当测试函数在模块的全局范围内定,则模块下的所有测试函数都可以调用它。该特点与全局变量和局部变量相似。

            示例7:

            演示代码:

            import pytest
            class TestClass1:
                @pytest.fixture()
                def login(self):
                    print("login")
                def test_case1(self,login):
                    print("TestClass1::test_case1")
            class TestClass2:
                def test_case2(self,login):
                    print("test_case2")
            

            运行结果:

            在这里插入图片描述

            说明:

            演示代码中定义了两个测试类:TestClass1TestClass2
            TestClass1中定义了一个fixture——login,和测试函数test_case1test_case1有调用login
            TestClass1中定义了一个测试函数test_case2test_case2有调用login

            通过运行结果我们可以看到,与login在同一测试类中的test_case1成功调用了login,但是TestClass2test_case2调用login的时候报错了,报错原因:未发现fixture函数“login”

            2.conftest.py中定义的fixture,可以被同目录下的所有模块中定义的测试函数调用。

            示例8:

            演示代码:

            test_availability/conftest.py:

            import pytest
            @pytest.fixture()
            def login():
                print("login")
                
            

            test_availability/test_availability.py:

            class TestClass1:
                def test_case1(self,login):
                    print("TestClass1::test_case1")
            class TestClass2:
                def test_case2(self,login):
                    print("test_case2")
            

            运行结果:

            在这里插入图片描述

            说明:

            我们在test_availability目录下创建了一个conftest.py,并且定义了一个fixture——login
            在test_availability.py中,我们定义了两个测试函数test_case1test_case1,两个测试函数都调用了login

            查看运行结果,测试函数都成功调用了login

            3.如果安装的第三方插件提供了fixture,任何测试函数都可以正常使用,无需考虑位置因素。

            文末说明:
            以上内容是我在阅读pytest官方文档后,依照个人理解进行整理。内容可能会有理解错误之处,欢迎大家留言指正。谢谢

            更多关于fixture作用域实例化顺序及可用性的资料请关注hwidc其它相关文章!

            【转自:天门网站推广 http://www.5h5q.com/tianmengseo/ 欢迎留下您的宝贵建议】
            更多阅读