Python测试框架pytest如何使用(pytest,python,开发技术)

前言

pytest是一个非常成熟的全功能的Python测试框架，主要有以下几个特点：

• 简单灵活，容易上手

• 支持参数化

• 能够支持简单的单元测试和复杂的功能测试，还可以用来做selenium/appnium等自动化测试、接口自

• 动化测试（pytest+requests）

• pytest具有很多第三方插件，并且可以自定义扩展，比较好用的如pytest-selenium（集成

• selenium）、pytest-html（完美html测试报告生成）、pytest-rerunfailures（失败case重复执

• 行）、pytest-xdist（多CPU分发）等

• 测试用例的skip和xfail处理

• 可以很好的和jenkins集成

• report框架----allure 也支持了pytest

1.pytest安装

1.1安装

pipinstall-Upytest

1.2验证安装

pytest--version#会展示当前已安装版本

1.3pytest文档

官方文档：https://docs.pytest.org/en/latest/contents.html

在pytest框架中，有如下约束：

• 所有的单测文件名都需要满足test_*.py格式或*_test.py格式。

• 在单测文件中，测试类以Test开头，并且不能带有 init
  方法(注意：定义class时，需要以T开头，不然pytest是不会去运行该class的)

• 在单测类中，可以包含一个或多个test_开头的函数。

• 在执行pytest命令时，会自动从当前目录及子目录中寻找符合上述约束的测试函数来执行。

1.4 Pytest运行方式

#file_name:test_abc.pyimportpytest#引入pytest包deftest_a():#test开头的测试函数print("------->test_a")assert1#断言成功deftest_b():print("------->test_b")assert0#断言失败if__name__=='__main__':pytest.main("-stest_abc.py")#调用pytest的main函数执行测试

1.测试类主函数模式

pytest.main("-stest_abc.py")

2.命令行模式

pytest文件路径／测试文件名例如：pytest./test_abc.py

1.5PytestExit Code 含义清单

Exit code 0 所有用例执行完毕，全部通过

Exit code 1 所有用例执行完毕，存在Failed的测试用例

Exit code 2 用户中断了测试的执行

Exit code 3 测试执行过程发生了内部错误

Exit code 4 pytest 命令行使用错误

Exit code 5 未采集到可用测试用例文件

1.6如何获取帮助信息

查看 pytest 版本

pytest--version

显示可用的内置函数参数

pytest--fixtures

通过命令行查看帮助信息及配置文件选项

pytest--help

1.7控制测试用例执行

1.在第N个用例失败后，结束测试执行

pytest-x#第01次失败，就停止测试pytest--maxfail=2#出现2个失败就终止测试

2.指定测试模块

pytesttest_mod.py

3.指定测试目录

pytesttesting/

4.通过关键字表达式过滤执行

pytest-k"MyClassandnotmethod"

这条命令会匹配文件名、类名、方法名匹配表达式的用例，这里这条命令会运行 TestMyClass.test_something， 不会执行 TestMyClass.test_method_simple

5.通过 node id 指定测试用例

nodeid由模块文件名、分隔符、类名、方法名、参数构成，举例如下：
运行模块中的指定用例

pytesttest_mod.py::test_func

运行模块中的指定方法

ytesttest_mod.py::TestClass::test_method

6.通过标记表达式执行

pytest-mslow

这条命令会执行被装饰器 @pytest.mark.slow 装饰的所有测试用例

7.通过包执行测试

pytest--pyargspkg.testing

这条命令会自动导入包 pkg.testing，并使用该包所在的目录，执行下面的用例。

1.8 多进程运行cases

当cases量很多时，运行时间也会变的很长，如果想缩短脚本运行的时长，就可以用多进程来运行。

安装pytest-xdist：

pipinstall-Upytest-xdist

运行模式：

pytesttest_se.py-nNUM

其中NUM填写并发的进程数。

1.9 重试运行cases

在做接口测试时，有事会遇到503或短时的网络波动，导致case运行失败，而这并非是我们期望的结果，此时可以就可以通过重试运行cases的方式来解决。

安装pytest-rerunfailures：

pipinstall-Upytest-rerunfailures

运行模式：

pytesttest_se.py--rerunsNUM

NUM填写重试的次数。

1.10 显示print内容

在运行测试脚本时，为了调试或打印一些内容，我们会在代码中加一些print内容，但是在运行pytest时，这些内容不会显示出来。如果带上-s，就可以显示了。

运行模式：

pytesttest_se.py-s

另外，pytest的多种运行模式是可以叠加执行的，比如说，你想同时运行4个进程，又想打印出print的内容。可以用：

pytesttest_se.py-s-n4

2.Pytest的setup和teardown函数

1.setup和teardown主要分为：模块级,类级，功能级，函数级。

2.存在于测试类内部

代码示例：

函数级别setup()／teardown()

运行于测试方法的始末，即:运行一次测试函数会运行一次setup和teardown

importpytestclassTest_ABC:#函数级开始defsetup(self):print("------->setup_method")#函数级结束defteardown(self):print("------->teardown_method")deftest_a(self):print("------->test_a")assert1deftest_b(self):print("------->test_b")if__name__=='__main__':pytest.main("-stest_abc.py")

执行结果：test_abc.py------->setup_method#第一次setup()------->test_a.------->teardown_method#第一次teardown()------->setup_method#第二次setup()------->test_b.------->teardown_method#第二次teardown()

类级别

运行于测试类的始末，即:在一个测试内只运行一次setup_class和teardown_class，不关心测试类内有多少个测试函数。

代码示例：

importpytestclassTest_ABC:#测试类级开始defsetup_class(self):print("------->setup_class")#测试类级结束defteardown_class(self):print("------->teardown_class")deftest_a(self):print("------->test_a")assert1deftest_b(self):print("------->test_b")if__name__=='__main__':pytest.main("-stest_abc.py")

执行结果：test_abc.py------->setup_class#第一次setup_class()------->test_a.------->test_bF------->teardown_class#第一次teardown_class()

3.Pytest配置文件

pytest的配置文件通常放在测试目录下，名称为pytest.ini，命令行运行时会使用该配置文件中的配置.

#配置pytest命令行运行参数[pytest]addopts=-s...#空格分隔，可添加多个命令行参数-所有参数均为插件包的参数配置测试搜索的路径testpaths=./scripts#当前目录下的scripts文件夹-可自定义#配置测试搜索的文件名称python_files=test*.py#当前目录下的scripts文件夹下，以test开头，以.py结尾的所有文件-可自定义配置测试搜索的测试类名python_classes=Test_*#当前目录下的scripts文件夹下，以test开头，以.py结尾的所有文件中，以Test开头的类-可自定义配置测试搜索的测试函数名python_functions=test_*#当前目录下的scripts文件夹下，以test开头，以.py结尾的所有文件中，以Test开头的类内，以test_开头的方法-可自定义

4 Pytest常用插件

插件列表网址：https://plugincompat.herokuapp.com

包含很多插件包，大家可依据工作的需求选择使用。

4.1 前置条件：

1.文件路径：

-Test_App--test_abc.py--pytest.ini

2.pyetst.ini配置文件内容：

[pytest]#命令行参数addopts=-s#搜索文件名python_files=test_*.py#搜索的类名python_classes=Test_*#搜索的函数名python_functions=test_*

4.2 Pytest测试报告

pytest-HTML是一个插件，pytest用于生成测试结果的HTML报告。兼容Python 2.7,3.6

安装方式：pip install pytest-html

pipinstallpytest-html

通过命令行方式，生成xml/html格式的测试报告，存储于用户指定路径。插件名称：pytest-html

使用方法： 命令行格式：pytest --html=用户路径/report.html

示例：

importpytestclassTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")deftest_a(self):print("------->test_a")assert1deftest_b(self):print("------->test_b")assert0#断言失败```运行方式：1.修改Test_App/pytest.ini文件，添加报告参数，即：addopts=-s--html=./report.html#-s:输出程序运行信息#--html=./report.html在当前目录下生成report.html文件️若要生成xml文件，可将--html=./report.html改成--html=./report.xml2.命令行进入Test_App目录3.执行命令：pytest执行结果：1.在当前目录会生成assets文件夹和report.html文件

5.pytest的高阶用法(一)

前置条件：

1.文件路径：

Test_App--test_abc.py--pytest.ini

2.pyetst.ini配置文件内容：

[pytest]命令行参数addopts=-s搜索文件名python_files=test*.py搜索的类名python_classes=Test*搜索的函数名python_functions=test_*

5.1pytest之fixture

fixture修饰器来标记固定的工厂函数,在其他函数，模块，类或整个工程调用它时会被激活并优先执行,通常会被用于完成预置处理和重复操作。

方法：

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

常用参数:

scope：被标记方法的作用域

function(default)：作用于每个测试方法，每个test都运行一次

class：作用于整个类，每个class的所有test只运行一次

module：作用于整个模块，每个module的所有test只运行一次

session：作用于整个session(慎用)，每个session只运行一次

params：(list类型)提供参数数据，供调用标记方法的函数使用

autouse：是否自动运行,默认为False不运行，设置为True自动运行

5.2fixture第一个例子(通过参数引用)

示例：

classTest_ABC:@pytest.fixture()defbefore(self):print("------->before")deftest_a(self,before):#️test_a方法传入了被fixture标识的函数，已变量的形式print("------->test_a")assert1if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->before#发现before会优先于测试函数运行------->test_a.

5.3.fixture第二个例子(通过函数引用)

示例：

importpytest@pytest.fixture()#fixture标记的函数可以应用于测试类外部defbefore():print("------->before")@pytest.mark.usefixtures("before")classTest_ABC:defsetup(self):print("------->setup")deftest_a(self):print("------->test_a")assert1if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->before#发现before会优先于测试类运行------->setup------->test_a.

5.4.fixture第三个例子(默认设置为运行)

示例：

importpytest@pytest.fixture(autouse=True)#设置为默认运行defbefore():print("------->before")classTest_ABC:defsetup(self):print("------->setup")deftest_a(self):print("------->test_a")assert1if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->before#发现before自动优先于测试类运行------->setup------->test_a.

5.5.fixture第四个例子(设置作用域为function)

示例：

importpytest@pytest.fixture(scope='function',autouse=True)#作用域设置为function，自动运行defbefore():print("------->before")classTest_ABC:defsetup(self):print("------->setup")deftest_a(self):print("------->test_a")assert1deftest_b(self):print("------->test_b")assert1if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->before#运行第一次------->setup------->test_a.------->before#运行第二次------->setup------->test_b.

5.6.fixture第五个例子(设置作用域为class)

示例：

importpytest@pytest.fixture(scope='class',autouse=True)#作用域设置为class，自动运行defbefore():print("------->before")classTest_ABC:defsetup(self):print("------->setup")deftest_a(self):print("------->test_a")assert1deftest_b(self):print("------->test_b")assert1if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->before#发现只运行一次------->setup------->test_a.------->setup------->test_b.

5.7.fixture第六个例子(返回值)

示例一:

importpytest@pytest.fixture()defneed_data():return2#返回数字2classTest_ABC:deftest_a(self,need_data):print("------->test_a")assertneed_data!=3#拿到返回值做一次断言if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：test_abc.py------->test_a.``

示例二:

importpytest@pytest.fixture(params=[1,2,3])defneed_data(request):#传入参数request系统封装参数returnrequest.param#取列表中单个值，默认的取值方式classTest_ABC:deftest_a(self,need_data):print("------->test_a")assertneed_data!=3#断言need_data不等于3if__name__=='__main__':pytest.main("-stest_abc.py")执行结果：#可以发现结果运行了三次test_abc.py1------->test_a.2------->test_a.3------->test_aF

6.Pytest高阶用法(二)

前置条件：

1.文件路径：

-Test_App--test_abc.py--pytest.ini

2.pyetst.ini配置文件内容：

[pytest]命令行参数addopts=-s搜索文件名python_files=test_*.py搜索的类名python_classes=Test_*搜索的函数名python_functions=test_*

6.1.跳过测试函数

根据特定的条件，不执行标识的测试函数.

方法：

skipif(condition, reason=None)

参数：

condition：跳过的条件，必传参数

reason：标注原因，必传参数

使用方法：

@pytest.mark.skipif(condition, reason="xxx")

示例：

importpytestclassTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")deftest_a(self):print("------->test_a")assert1@pytest.mark.skipif(condition=2>1,reason="跳过该函数")#跳过测试函数test_bdeftest_b(self):print("------->test_b")assert0执行结果：test_abc.py------->setup_class------->test_a#只执行了函数test_a.------->teardown_classs#跳过函数```

6.2 标记为预期失败函数

标记测试函数为失败函数

方法：

xfail(condition=None, reason=None, raises=None, run=True, strict=False)

常用参数：

condition：预期失败的条件，必传参数

reason：失败的原因，必传参数

使用方法：

@pytest.mark.xfail(condition, reason="xx")

示例：

importpytestclassTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")deftest_a(self):print("------->test_a")assert1@pytest.mark.xfail(2>1,reason="标注为预期失败")#标记为预期失败函数test_bdeftest_b(self):print("------->test_b")assert0执行结果：test_abc.py------->setup_class------->test_a.------->test_b------->teardown_classx#失败标记

6.3 函数数据参数化

方便测试函数对测试属于的获取。

方法：

parametrize(argnames, argvalues, indirect=False, ids=None, scope=None)

常用参数：

argnames：参数名

argvalues：参数对应值，类型必须为list

当参数为一个时格式：[value]

当参数个数大于一个时，格式为:

[(param_value1,param_value2.....),(param_value1,param_value2.....)]

使用方法:

@pytest.mark.parametrize(argnames,argvalues)

参数值为N个，测试方法就会运行N次

单个参数示例：

importpytestclassTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")

@pytest.mark.parametrize("a",[3,6])#a参数被赋予两个值，函数会运行两遍deftest_a(self,a):#参数必须和parametrize里面的参数一致print("testdata:a=%d"%a)asserta%3==0执行结果:test_abc.py------->setup_classtestdata:a=3#运行第一次取值a=3.testdata:a=6#运行第二次取值a=6.------->teardown_class

多个参数示例：

importpytestclassTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")

@pytest.mark.parametrize("a,b",[(1,2),(0,3)])#参数a,b均被赋予两个值，函数会运行两遍deftest_a(self,a,b):#参数必须和parametrize里面的参数一致print("testdata:a=%d,b=%d"%(a,b))asserta+b==3执行结果：test_abc.py------->setup_classtestdata:a=1,b=2#运行第一次取值a=1,b=2.testdata:a=0,b=3#运行第二次取值a=0,b=3.------->teardown_class

函数返回值类型示例：

importpytestdefreturn_test_data():return[(1,2),(0,3)]classTest_ABC:defsetup_class(self):print("------->setup_class")defteardown_class(self):print("------->teardown_class")

@pytest.mark.parametrize("a,b",return_test_data())#使用函数返回值的形式传入参数值deftest_a(self,a,b):print("testdata:a=%d,b=%d"%(a,b))asserta+b==3执行结果：test_abc.py------->setup_classtestdata:a=1,b=2#运行第一次取值a=1,b=2.testdata:a=0,b=3#运行第二次取值a=0,b=3.------->teardown_class

6.4修改 Python traceback 输出

pytest--showlocals#showlocalvariablesintracebackspytest-l#showlocalvariables(shortcut)pytest--tb=auto#(default)'long'tracebacksforthefirstandlast#entry,but'short'stylefortheotherentriespytest--tb=long#exhaustive,informativetracebackformattingpytest--tb=short#shortertracebackformatpytest--tb=line#onlyonelineperfailurepytest--tb=native#Pythonstandardlibraryformattingpytest--tb=no#notracebackatall

--full-trace参数会打印更多的错误输出信息，比参数 --tb=long 还多，即使是 Ctrl+C 触发的错误，也会打印出来

6.5 执行失败的时候跳转到 PDB

执行用例的时候，跟参数 --pdb，这样失败的时候，每次遇到失败，会自动跳转到 PDB

pytest--pdb#每次遇到失败都跳转到PDBpytest-x--pdb#第一次遇到失败就跳转到PDB，结束测试执行pytest--pdb--maxfail=3#只有前三次失败跳转到PDB

6.6 设置断点

在用例脚本中加入如下python代码，pytest会自动关闭执行输出的抓取，这里，其他test脚本不会受到影响，带断点的test上一个test正常输出

importpdb;pdb.set_trace()

6.7 获取用例执行性能数据

获取最慢的10个用例的执行耗时

pytest--durations=10

6.8 生成 JUnitXML 格式的结果文件

这种格式的结果文件可以被Jenkins或其他CI工具解析

pytest--junitxml=path

6.9禁用插件

例如，关闭 doctest 插件

pytest-pno:doctest

6.10 从Python代码中调用pytest

pytest.main()#基本用法pytest.main(['-x','mytestdir'])#传入配置参数//指定自定义的或额外的插件#contentofmyinvoke.pyimportpytestclassMyPlugin(object):defpytest_sessionfinish(self):print("***testrunreportingfinishing")pytest.main(["-qq"],plugins=[MyPlugin()])

6.11 测试脚本迁移后快速部署包含pytest的virtualenv

例如你从Gitlab仓库里clone了项目组的刀刀同学编写的测试脚本到你自己的电脑里，你想修改些东西，并调试，咋办？可以通过下面的操作快速创建 VirtualEnv

cd<repository>pipinstall-e.

This will set up a symlink to your code in site-packages, allowing you to edit your code while
your tests run against it as if it were installed.
Setting up your project in development mode lets you avoid having to reinstall every time you want to run your tests,
and is less brittle than mucking about with sys.path to point your tests at local code.
Also consider using tox

遇到的问题

pytest可以输出覆盖率的html报告

使用命令如下：

pytest-vv--cov=./--cov-report=htmlopenhtmlcov/index.html

有可能遇到报错：

(venv)zhangxiaofans-MacBook-Pro:mgap-mendeljoe$pytest--cov-report=htmlusage:pytest[options][file_or_dir][file_or_dir][...]pytest:error:unrecognizedarguments:--cov-report=htmlinifile:Nonerootdir:/Users/joe/workspace/platform/mgap-mendel/mgap-mendel

原因：

缺少pytest cov的包

解决方法

pipinstallpytest-cov