单元测试框架pytest

前提

pytest是一个非官方的单元测试框架，需要先进行安装。所以pip一下

技术点

一、运行参数（进入到相应目录）

1、无参数运行

运行目录下的所有py文件：pytest
运行目录下某一个py文件：pytest test_01.py
运行目录下py文件中的某个类：pytest test_02.py::TestClass
运行目录下py文件中某个类的某个方法：pytest test_02.py::TestClass::test_one
指定目录运行：pytest testpy

2、-v参数

打印详细的日志信息

3、-s参数

代码里面有 print 输出语句，想在运行结果中打印 print 输出

4、-k参数

pytest -k '类名' //运行指定的类
pytest -k '方法名' //运行指定的方法
pytest -k '类名 and not 方法名' //运行类里的方法，不包含某个方法

5、-x参数

遇到失败用例立即停止运行

6、--maxfail参数

用例失败个数达到阀值后停止运行
pytest --maxfail 2 test_02.py

7、-m参数

只运行标记 @pytest.mark.[标记名]的方法和类

比如类名上添加：

@pytest.mark.oneone，

执行命令：pytest -m "oneone" test_02.py

如果有多个标记可以用 and 或 or 进行组合

8、--durations参数

获取执行最慢的一个：pytest --durations=1

9、--collect-only参数

只收集用例不执行，可用于统计用例数

二、pytest框架结构

import pytest

def setup_module():
    print("
setup_module，只执行一次，当有多个测试类的时候使用")
def teardown_module():
    print("
teardown_module，只执行一次，当有多个测试类的时候使用")


# setup_function teardown_function作用于类外的函数
def setup_function():
    print("
setup_function")
def teardown_function():
    print("
setup_function")

def test_cls_out():
    print("类外的函数方法")


class TestPytest1:
    def setup_class(self):
        print("
setup_class1，只执行一次，当有多个测试方法的时候使用")
    def teardown_class(self):
        print("
teardown_class1，只执行一次，当有多个测试方法的时候使用")


    def setup_method(self):
        print("
setup_method1，每个测试方法都执行一次")
    def teardown_method(self):
        print("teardown_method1，每个测试方法都执行一次")


    def setup(self):
        print("setup")
    def teardown(self):
        print("teardown")


    def test_three(self):
        print("test_three，测试用例")

    def test_four(self):
        print("test_four，测试用例")

三、控制执行顺序

安装：pip install pytest-ordering
负数越小越先执行(-100,-18,-1)
正数越小越先执行(1,18,100)

import pytest


class Testpy:
    @pytest.mark.run(order=1)
    def test_one(self):
        print(111)

    @pytest.mark.run(order=18)
    def test_two(self):
        print(222)

    @pytest.mark.run(order=100)
    def test_three(self):
        print(333)

四、并发执行

安装：pip install pytest-xdist
多个CPU并行执行用例，如果参数为 auto 自动检测系统的 CPU 数目；如果参数为数字，则指定运行测试的处理器进程数。
pytest -n auto
pytest -n [num]

五、pytest-html 生成测试报告

安装：pip install pytest-html
指定报告的存放路径
--html=./report/report.html
 加这个参数生成的报告css不是独立的
 --self-contained-html

六、assert断言

assert a
assert a == b
assert a in b
assert not a
assert a != b (a <> b一般不再使用)

七、@pytest.fixture

fixture 有一个参数 scope，通过 scope 可以控制 fixture 的作用范围，根据作用范围大小划分：session> module> class> function
具体作用范围如下：
　　function 函数或者方法级别都会被调用（默认）
　　class 类级别调用一次
　　module 模块级别调用一次
　　session 是多个文件调用一次(可以跨.py文件调用，每个.py文件就是module)

1、以参数的形式传入到方法里执行

import pytest

@pytest.fixture()
def login():
    print("登录需要的操作步骤")

@pytest.fixture()
def operate():
    print("用例的执行步骤")

@pytest.fixture()
def xiao():
    print("1234567890")

# 需要在函数中传入函数名，函数上需要先标记上 @pytest.fixture()
def test_case1(login, operate, xiao):
    print("test_case1，需要登录执行完毕")

2、fixture的两种引用方式

import pytest


@pytest.fixture()
def open():
    print("打开浏览器")
    yield

    print("执行teardown !")
    print("最后关闭浏览器")


# 方式一：装饰器方式引用
@pytest.mark.usefixtures("open")
def test_search1():
    print("test_search1")
    # raise NameError
    pass


# 方式二：在函数中传入
def test_search2(open):
    print("test_search2")
    # raise NameError
    pass

3、conftest.py应用
conftest.py等同于scope=session
pytest test_scope1.py test_scope2.py

相应代码见：https://github.com/hanshoukai/pytest_fixture

fixture为function

fixture为class

 

 fixture为module

  fixture为session

4、自动执行fixture装饰下的函数
conftest.py中标记为：@pytest.fixture(autouse="true")

每个测试函数都会自动调用该前置函数

5、fixture传递参数

import pytest

@pytest.fixture(params=[1, 2, 3])
def params(request):
    return request.param

def test_com(params):
    print(f"测试数据：{params}")
    assert params < 5

八、@pytest.mark.parametrize参数化

传一个参数

# 传一个参数
@pytest.mark.parametrize("user", ["13552977251", "13552554252"])
def test_user(user):
    print(user)

传两个参数

@pytest.mark.parametrize("test_input,expected", [("3+5", 8), ("2+5", 7), ("7*5", 35)])
如上 "test_input,expected" 可以修改为 列表或者元组 的形式
列表：@pytest.mark.parametrize(["test_input","expected"], [("3+5", 8), ("2+5", 7), ("7*5", 35)])
元组：@pytest.mark.parametrize(("test_input","expected"), [("3+5", 8), ("2+5", 7), ("7*5", 35)])

# 传两个参数
@pytest.mark.parametrize("test_input,expected", [("3+5", 8), ("2+5", 7), ("7*5", 35)])
def test_function(test_input, expected):
    # eval可以将字符串转成3+5的表达方式
    print(test_input, expected)
    assert eval(test_input) == expected

传三个参数 三组数据，ids是别名必须与参数的数量保持一致

参数组合

# 参数组合
@pytest.mark.parametrize("x", [1, 2])
@pytest.mark.parametrize("y", [3, 4, 5])
def test_num(x, y):
    # print(f"测试数据组合x: {x} , y:{y}")
    print("测试数据组合x："+str(x)+" y："+str(y))

函数返回值类型

# 函数返回值类型
def return_data():
    return [(1, 2), (3, 4)]

@pytest.mark.parametrize("a,b", return_data())
def test_data(a, b):
    print(a)
    print(b)

用yaml文件做为参数化的数据源

companyid.yaml

-
  - 23725503
  - 24721214
  - 2352987806

data.yaml

-
  - 20
  - 30
-
  - 40
  - 50

脚本：

import pytest
import yaml


@pytest.mark.parametrize('a, b', yaml.safe_load(open("data.yaml", encoding='utf-8')))
# @allure.step("方法的描述信息")
def test_fo(a, b):
    print(a)
    print(b)


@pytest.mark.parametrize('company_id', yaml.safe_load(open("companyid.yaml", encoding='utf-8')))
# @allure.step("方法的描述信息")
def test_foo(company_id):
    print("企业ID：", company_id)

九、pytest.ini模板

[pytest]
# 空格分隔，可添加多个命令行参数  重试两次每隔5秒  生成报告
addopts = -sv --reruns 2 --reruns-delay 5 --html=./report/report.html --self-contained-html
#addopts = -s -v --alluredir=./result
# 当前目录下
testpaths = ./testcase/
#配置测试搜索的文件名称,当前目录下以test开头，以.py结尾的所有文件
python_files = test*.py
#配置测试搜索的测试类名,当前目录下以Test开头的所有类
python_classes = Test
#配置测试搜索的测试类名,当前目录下以test_开头的所有方法
python_functions = test_*

十、更多插件

用例失败后自动重新运行：pytest-rerunfailures

使用方法：pytest test_x.py --reruns=2 --reruns-delay 5  #失败后重试2次，每次间隔5秒

在脚本中指定定义重跑的次数，这个时候在运行的时候，就无需加上 --reruns 这个参数

@pytest.mark.flaky(reruns=6, reruns_delay=2)
def test_example(self):
    print(3)