pytest基本使用指南

注：关于pytest的基础要点个人已经总结好了，

 

一. 启动：

　　在主函数main下启动：pytest.main(['-q','test_demo.py'])

　　在命令行启动：pytest ./test_demo.py

　　按标签启动：pytest -m demo（前提是在pytest.ini里配上了标签）

　　在命令行启动多个：pytest test_demo1.py test_demo2.py

　　指定目录启动：pytest.main("d:/pyse/pytest/")

　　运行模块中指定用例：pytest.main("-v -s spec_001_modul_test.py::test_001_spec")

　　运行类中指定用例：pytest.main("-v -s spec_001_modul_test.py::Test_Class::test_003_spec")

　　运行模块中包含demo名称的用例：pytest.main("-v -s -k demo test_demo.py")

　　运行当前文件夹匹配Test_Class的用例：pytest.main('-s -v -k Test_Class')

　　运行规则：pytest 目录/文件::类名::函数名 或者 pytest 目录/文件::函数名

 

二. 启动参数说明：

　　-s: 显示程序中的print/logging输出

　　-v: 丰富信息模式, 输出更详细的用例执行信息

　　-q: 安静模式, 不输出环境信息，只给结果

　　-k：关键字匹配，用and区分：匹配范围（文件名、类名、函数名）

 

三. setup/teardown：

　　setup和teardown函数：运行在每个测试方法的始末

　　setup_class和teardown_class函数：运行在类的始末

 

四. pytest.ini：

　　参数最好都放配置文件里，不用再main里放。每个参数见名知意啦~。由于编码问题，配置文件里不要出现中文。

[pytest]

addopts = -v --html=report/report.html
# addopts = -v --html=report/report.html --rerun=1 --count=1
# addopts = -v --alluredir reports/raw_report

testpaths = ./
python_files = test_*.py
python_classes = Test*
python_functions = test_*
norecursedirs = .venv log report common data .pytest_cache

markers =
    l1:level-1  # by priority
    l2:level-2
    l3:level-3

    smoke:smoke test  # by test type
    integrate:integrate test

    demo:for demo  # by logic
    login:login module
    upload:upload module
    review:review module

 

五. pytest-html:

　　安装它

　　用法：配置文件里添加报告参数：addopts = -s --html=./report.html，若要生成xml文件改一下就行

 

六. pytest-ordering:

　　安装它

　　用法：函数上面加@pytest.mark.run(order=n)

　　优先级：order值全为正数或全为负数时, 值越小,优先级越高；正数和负数同时存在,正数优先级高

 

七. pytest-rerunfailures:

　　安装它

　　用法：命令行格式，pytest --reruns n。n为重试的次数；或添加失败重试参数，即：addopts = -s --reruns 2 --html=./report.html

　　记住命令行是reruns，最好配置参数

 

八. fixture：

　　功能：通常会被用于完成预置处理和重复操作。如在测试网站的功能时，每个测试用例都要登录和退出，利用fixture就可以只做一次；完成setup和teardown操作,处理数据库或文件的打开、关闭操作；将数据提前写入数据库或通过params返回给测试用例。强大吧！

　　pytest.fixture(scope='function', params=None, autouse=False, ids=None, name=None)

　　参数解释:

　　"scope": 被标记方法的作用域;

　　"function": 默认值,表示每个测试方法都要执行一次

　　"class": 作用于整个类, 表示每个类的所有测试方法只运行一次

　　"module": 作用于整个模块, 每个module的所有测试方法只运行一次.

　　"session": 作用于整个session, 每次session只运行一次. ⚠️(此方法慎用!!)

　　params: list类型,默认None, 接收参数值,对于param里面的每个值，fixture都会去遍历执行一次.

　　autouse: 是否自动运行,默认为false, 为true时此session中的所有测试函数都会调用fixture

 

　　以上的所有参数也可以不传。

　　把返回值作为参数使用：某个功能用例上面放@pytest.fixture()，然后该函数名可以作为参数放别的函数里。

　　直接使用：@pytest.mark.usefixtures("before")

 

九. skipif:

　　@pytest.mark.skipif(condition, reason=None)

　　参数解释:

　　condition: 跳过的条件,必传参数

　　eason: 标注原因,必传参数

 

十. xfail:

　　@pytest.mark.xfail(condition=None, reason=None, raises=None, run=True, strict=False)

　　常用参数：

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

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

 

十一. parametrize:

　　@pytest.mark.parametrize(argnames,argvalues)

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

　　常用参数：

　　argnames：参数名

　　argvalues：

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

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

　　当参数个数大于一个时，格式为:[(param_value1,param_value2.....),(param_value1,param_value2.....)]

 

十二. 其他：

　　不需要在main里面写pytest.main，只要是符合命名，默认为pytest启动，都会自动调用pytest

　　如果两个测试函数体里面的内容一样，只会输出一次结果。

　　改了哪儿，直接运行后测的就是哪儿。需要重新定位鼠标，一般把改了的测试函数放最后。这条很重要，不然会以为pytest框架有bug，只是写这个框架的人脑回路很奇怪，但这样很方便。

 

十三. 断言

　　即python的断言：

　　　　assert xx：判断xx为真

　　　　assert not xx：判断xx不为真

　　　　assert a in b：判断b包含a

　　　　assert a == b：判断a等于b

　　　　assert a !=b,"判断a不等于b"(加上括号后面有说明)