Pytest成魔之路 —— fixture 之大解剖！

1. 简介

fixture是pytest的一个闪光点，pytest要精通怎么能不学习fixture呢？跟着我一起深入学习fixture吧。其实unittest和nose都支持fixture，但是pytest做得更炫。

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

fixture有明确的名字，在其他函数，模块，类或整个工程调用它时会被激活。
fixture是基于模块来执行的，每个fixture的名字就可以触发一个fixture的函数，它自身也可以调用其他的fixture。
我们可以把fixture看做是资源，在你的测试用例执行之前需要去配置这些资源，执行完后需要去释放资源。比如module类型的fixture，适合于那些许多测试用例都只需要执行一次的操作。
fixture还提供了参数化功能，根据配置和不同组件来选择不同的参数。
fixture主要的目的是为了提供一种可靠和可重复性的手段去运行那些最基本的测试内容。比如在测试网站的功能时，每个测试用例都要登录和退出，利用fixture就可以只做一次，否则每个测试用例都要做这两步也是冗余。

pytest 提供的 fixture 实现 unittest 中 setup/teardown 功能，可以在每次执行case之前初始化数据。不同点是，fixture 可以只在执行某几个特定 case 前运行，只需要在运行 case 前调用即可。比 setup/teardown 使用起来更灵活。上一篇讲到用例加setup和teardown可以实现在测试用例之前或之后加入一些操作，但这种是整个脚本全局生效的，如果我想实现以下场景：用例1需要先登录，用例2不需要登录，用例3需要先登录。很显然这就无法用setup和teardown来实现了。这就是本篇学习的目的，自定义测试用例的预置条件

2. fixture scope 作用范围

先看下 fixture 函数的定义：

　　使用装饰器标记fixture的功能可以使用此装饰器（带或不带参数）来定义fixture功能。 fixture功能的名称可以在以后使用引用它会在运行测试之前调用它：test模块或类可以使用pytest.mark.usefixtures（fixturename标记。测试功能可以直接使用fixture名称作为输入参数，在这种情况下，夹具实例从fixture返回功能将被注入。

def fixture(scope="function", params=None, autouse=False, ids=None, name=None):
    """
    :arg scope:    可选四组参数：function（默认）、calss、module、package/session

    :arg params:   一个可选的参数列表，它将导致多个参数调用fixture函数和所有测试使用它。

    :arg autouse:  如果为True，则fixture func将为所有测试激活可以看到它。如果为False(默认值)，则需要显式激活fixture。

    :arg ids:      每个参数对应的字符串id列表，因此它们是测试id的一部分。如果没有提供id，它们将从参数中自动生成。

    :arg name:     fixture的名称。 这默认为装饰函数的名称。 如果fixture在定义它的同一模块中使用，夹具的功能名称将被请求夹具的功能arg遮蔽; 解决这个问题的一种方法是将装饰函数命名 “fixture_ <fixturename>”然后使用”@ pytest.fixture（name ='<fixturename>'）”。
　　"""

重点说下 scope 四组参数的意义：

function：每个方法（函数）都会执行一次。
class：每个类都会执行一次。类中有多个方法调用，只在第一个方法调用时执行。
module：一个 .py 文件执行一次。一个.py 文件可能包含多个类和方法。
package/session：多个文件调用一次，可以跨 .py 文件。

在所需要调用的函数前面加个装饰器 @pytest.fixture()。举一个简单的例子：

3. fixture 优点

1.firture相对于setup和teardown来说应该有以下几点优势：

命名方式灵活，不局限于setup和teardown这几个命名
conftest.py 配置里可以实现数据共享，不需要import就能自动找到一些配置
scope=”module” 可以实现多个.py跨文件共享前置
scope=”session” 以实现多个.py跨文件使用一个session来完成多个用例

4. fixture参数传入（scope=”function”）

例如这样的测试场景：宏哥这里就拿博客园举个例子：

测试用例1：需要登录博客园，发布随笔

测试用例2：不需要登录博客园，浏览文章

测试用例3：需要登录博客园，删除随笔

4.1 代码实现：

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

现在我也找了很多测试的朋友，做了一个分享技术的交流群，共享了很多我们收集的技术文档和视频教程。
如果你不想再体验自学时找不到资源，没人解答问题，坚持几天便放弃的感受
可以加入我们一起交流。而且还有很多在自动化，性能，安全，测试开发等等方面有一定建树的技术大牛
分享他们的经验，还会分享很多直播讲座和技术沙龙
可以免费学习！划重点！开源的！！！
qq群号：691998057【暗号：csdn999】

4.2 参考代码：

# coding=utf-8
# 1.先设置编码，utf-8可支持中英文，如上，一般放在第一行

# 2.注释：包括记录创建时间，创建人，项目名称。
'''
Created on 2020-1-09
@author: 北京-宏哥
Project:《带你装B，带你飞》pytest修仙之路4 - fixture简介 & yield
'''
# 3.导入模块
#  content of  test_bjhg_class1.py

import pytest

# 不带参数时默认scope="function"
@pytest.fixture(scope='function')
def login():
    print("登录博客园")

def test_1(login):
    print('测试用例1,登录博客园之后发布随笔111')

def test_2():
    print('测试用例2,不需要登录博客园，浏览文章222')

def test_3(login):
    print('测试用例2,登录博客园之后删除随笔333')
if __name__ == "__main__":
    pytest.main(["-s", "test_bjhg_class1.py"])

4.3 运行结果：

运行代码后，控制台打印如下图的结果

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

2.如果@pytest.fixture()里面没有参数，那么默认scope=”function”，也就是此时的级别的function，针对函数有效。

5. conftest.py配置

5.1 conftest.py配置需要注意以下点：

conftest.py配置脚本名称是固定的，不能改名称

conftest.py与运行的用例要在同一个pakage下，并且有init.py文件

不需要import导入 conftest.py，pytest用例会自动查找

1.上面一个测试场景是在同一个.py文件中，多个用例调用一个登陆功能，如果有多个.py的文件都需要调用这个登陆功能的话，那就不能把登陆写到用例里面去了。
此时应该要有一个配置文件，单独管理一些预置的操作场景，pytest里面默认读取conftest.py里面的配置

5.2 conftest.py

5.2.1 代码实现：

5.2.2 参考代码：

# coding=utf-8
# 1.先设置编码，utf-8可支持中英文，如上，一般放在第一行

# 2.注释：包括记录创建时间，创建人，项目名称。
'''
Created on 2020-1-09
@author: 北京-宏哥
Project:《带你装B，带你飞》pytest修仙之路4 - fixture简介 & yield
'''
# 3.导入模块
#  content of  conftest.py

import pytest

# 不带参数时默认scope="function"
@pytest.fixture(scope='function')
def login():
    print("登录博客园")

5.3 test_fix1.py

5.3.1 代码实现：

5.3.2 参考代码：

# coding=utf-8
# 1.先设置编码，utf-8可支持中英文，如上，一般放在第一行

# 2.注释：包括记录创建时间，创建人，项目名称。
'''
Created on 2020-1-09
@author: 北京-宏哥
Project:《带你装B，带你飞》pytest修仙之路4 - fixture简介 & yield
'''
# 3.导入模块
#  content of  test_fix1.py

import pytest

def test_1(login):
    print('测试用例1,登录博客园之后发布随笔111')

def test_2():
    print('测试用例2,不需要登录博客园，浏览文章222')

def test_3(login):
    print('测试用例2,登录博客园之后删除随笔333')
if __name__ == "__main__":
    pytest.main(["-s", "test_fix1.py"])

5.3.3 运行结果：

运行代码后，控制台打印如下图的结果

5.4 test_fix2.py

5.4.1 代码实现：

5.4.2 参考代码：

# coding=utf-8
# 1.先设置编码，utf-8可支持中英文，如上，一般放在第一行

# 2.注释：包括记录创建时间，创建人，项目名称。
'''
Created on 2020-1-09
@author: 北京-宏哥
Project:《带你装B，带你飞》pytest修仙之路4 - fixture简介 & yield
'''
# 3.导入模块
#  content of  test_fix2.py

import pytest


def test_4(login):
    print('测试用例4,登录博客园之后修改头像444')

def test_5():
    print('测试用例5,不需要登录博客园，浏览首页555')

def test_6(login):
    print('测试用例6,登录博客园之后保存随笔666')
if __name__ == "__main__":
    pytest.main(["-s", "test_fix2.py"])

5.4.3 运行结果：

运行代码后，控制台打印如下图的结果

单独运行test_fix1.py和test_fix2.py都能调用到login()方法，这样就能实现一些公共的操作可以单独拿出来了

6. 小结

　　如果你的程序出现了下面的错误,就是开始忘记添加‘import pytest'，所以不要忘记哦。

=================================== ERRORS ====================================
_________________ ERROR collecting test_fixture_decorator.py __________________
test_fixture_decorator.py:2: in <module>
    @pytest.fixture()
E   NameError: name 'pytest' is not defined
!!!!!!!!!!!!!!!!!!! Interrupted: 1 errors during collection !!!!!!!!!!!!!!!!!!!
=========================== 1 error in 0.36 seconds ===========================

　　好了，今天的分享就到这里吧！！！谢谢各位的耐心阅读。有问题加群交流讨论！！！

下面是配套资料，对于做【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！

最后：可以在公众号：自动化测试老司机！ 免费领取一份216页软件测试工程师面试宝典文档资料。以及相对应的视频学习教程免费分享！，其中包括了有基础知识、Linux必备、Shell、互联网程序原理、Mysql数据库、抓包工具专题、接口测试工具、测试进阶-Python编程、Web自动化测试、APP自动化测试、接口自动化测试、测试高级持续集成、测试架构开发测试框架、性能测试、安全测试等。

如果我的博客对你有帮助、如果你喜欢我的博客内容，请 “点赞” “评论” “收藏” 一键三连哦！