Python测试框架之pytest快速入门

pytest是一种流行的Python测试框架,支持创建简单的单元测试,也支持创建复杂的功能和集成测试。它提供了一系列有用的功能,能够方便地编写,组织和运行测试用例,并生成丰富的测试报告。

pytest的主要特点包括:

  • 自动发现测试用例:pytest会自动查找项目中以test_或者以_test结尾的函数或类,并执行它们。
  • 参数化测试:pytest允许使用@pytest.mark.parametrize标记来指定多组输入参数和预期输出值,以简化测试用例的编写和管理。
  • 丰富的断言方式:pytest支持多种断言方法,如assert语句、pytest.assert函数、pytest-assume插件以及第三方断言库等,可以让开发人员更轻松地编写和维护测试用例。
  • 插件化架构:pytest允许通过插件来扩展其功能,它有很多官方和社区提供的插件,可以帮助开发人员处理日志、代码覆盖率、性能测试等各种任务。
  • 可与unittestnose无缝对接
  • 丰富的测试报告:pytest会自动生成丰富的测试报告,包括测试用例的执行情况、失败原因、覆盖状态等信息,并支持多种输出格式,如HTML,JUnit XML等。
    使用pytest编写和运行测试用例相对于其他测试框架来说更加简洁和灵活,同时它也是Python社区中广泛使用的测试工具之一。

使用标准库unittest进行单元测试

介绍pytest之前, 先来看一下Python内置的测试库unittest, unittest是Python 标准库的一部分,在安装完Python之后就可以使用, 不需要安装任何其他模块。
Python unittest是Python自带的一个单元测试框架,用于编写和运行测试用例,以确保代码的正确性和可靠性。unittest提供了一系列的工具和断言方法,使得编写测试用例变得更加简单和高效。通过使用unittest,开发人员可以快速运行测试用例并自动化测试过程,从而节省时间和人力成本。
在Python中,unittest常被用作测试框架,它不仅仅用于单元测试,还可以进行集成测试和功能测试。unittest框架提供了丰富的API、测试控制器以及测试加载器,使得测试用例的编写和执行变得更容易。
使用unittest编写测试用例的流程如下:

  1. 创建一个测试类,继承unittest.TestCase类。
  2. 在测试类中编写测试方法。测试方法必须以test_开头,用于测试代码的特定功能。
  3. 在测试方法中使用断言方法(如assertEqual、assertTrue等)判断代码的执行结果是否符合预期。
  4. 运行测试用例,并查看测试报告,根据测试结果进行代码调整和优化。

直接上代码示例:

import unittest

def add(a, b):
    return a + b

class TestAdd(unittest.TestCase):

    def test_add(self):
        self.assertEqual(add(1, 2), 3)

if __name__ == '__main__':
    unittest.main()

一个测试用例是一个完整的单元测试流程,包括测试前的准备环节、执行测试动作的环节、与期望结果的对比的环节。在unittest中,测试用例是通过继承unittest.TestCase类来实现的,这个示例中定义了一个名为 add 的函数,并且使用了 Python 的 unittest 模块对这个函数进行了测试。

  • TestAdd 类继承自 unittest.TestCase 类,并包含了一个名为 test_add 的测试方法。
  • 在这个方法中,使用 self.assertEqual 方法来检查 add 函数是否正确计算了加法。最后,使用 unittest.main() 运行测试。

运行成功的界面如下:

在这里插入图片描述

如果运行失败是怎么显示的呢? 修改上面的 self.assertEqual(add(1, 2), 3) => self.assertEqual(add(1, 2), 4) 让测试失败, 失败的界面如下:
Python测试框架之pytest快速入门_第1张图片

安装 pytest

如果没有安装pytest,可以使用pip来安装:

pip install pytest

如果不确定有没有安装pytest, 可以使用 pip list 查看安装的模块, 比如:
Python测试框架之pytest快速入门_第2张图片

pytest 安装成功的界面如下:
Python测试框架之pytest快速入门_第3张图片

使用 pytest 编写单元测试

pytest工具会自动找到文件名和函数名都以test开头的测试用例。

这里定义一个加法函数并对这个函数进行测试, 首先创建一个名为test_sample.py的文件,内容如下:

def add(a, b):
    return a + b



def test_add():
    assert add(1, 2) == 3

运行pytest 测试

命令行切换到包含test_sample.py的目录,运行pytest命令,pytest会运行所有发现的测试,并产生一个测试报告,运行的效果如下图:
在这里插入图片描述

测试失败情况下,pytest 怎么显示呢?pytest会详细地显示哪个测试失败,以及失败的详细原因。这里故意定义一个执行错误的函数test_add2(), 代码如下:

def add(a, b):
    return a + b

def test_add():
    assert add(1, 2) == 3

def test_add2():    
    assert add(1, 2) == 4

执行后的效果如下图:
Python测试框架之pytest快速入门_第4张图片

除了在命令行控制台运行和查看pytest的结果外, 也可以在VS Code 的Testing的活动栏,运行和查看结果。效果如下图:
Python测试框架之pytest快速入门_第5张图片

需要注意的是: 点击Testing的活动栏之后, 需要选择测试的框架为 pytest。

使用pytest 运行功能测试

pytest是一个非常灵活强大的 Python 测试框架,它既能进行单元测试,也能进行功能测试, 通常与 Flask(轻量级的 Python web 框架)一起使用。
Flask 模块需要先安装, 安装方式是 pip install flask, 安装完成之后就可以编写Flask代码了,
这里定义一个 Flask Web 应用,并且需要测试当访问/hello时是否能返回 “Hello, World!”, 代码如下:

from flask import Flask

def create_app():
    app = Flask(__name__)

    @app.route('/hello')
    def hello():
        return 'Hello, World!'

    return app

if __name__ == '__main__':
    app = create_app()
    app.run()

运行之后通过浏览器访问的效果如下图:
Python测试框架之pytest快速入门_第6张图片

接下来, 使用pytest来进行功能测试,使用Flask的测试客户端来模拟访问, 定义测试的文件test_app.py , 内容如下:

import pytest
from app import create_app
    
@pytest.fixture
def client():
    app = create_app()
    app.config['TESTING'] = True
    with app.test_client() as client:
        yield client

def test_hello(client):
    response = client.get('/hello')
    assert response.data == b'Hello, World!'
  • 使用 @pytest.fixture 装饰器定义了一个名为 client 的测试夹具。该夹具在测试过程中可以作为参数传递给测试函数。在这个夹具函数中,创建了一个测试用的 Flask 应用,并将其配置为测试模式。
  • 定义了一个名为 test_hello 的测试函数,并将上述夹具 client 作为参数传递进去。在测试函数中,使用 client.get(‘/hello’) 发起了一个 GET 请求,并检查返回值是否等于 b’Hello, World!'。如果返回值和预期值不一致,那么测试将会失败。
  • 在 Python 中,当字符串前面带有前缀b时,表示这是一个 bytes 类型的字符串,而不是普通的 str 类型。bytes 类型的字符串在 Python 中是一种原生的二进制序列类型,它的每个字符都是一个字节,可以存储任意的二进制数据。
    在 Flask 应用中,当使用response.data获取 HTTP 响应的内容时,返回的是 bytes 类型的内容,因为 HTTP 响应的内容是以二进制字节流的形式传输的。因此,在进行 HTTP 响应内容的比较时,需要使用 bytes 类型的字符串,而不是普通的 str 类型字符串。

运行测试的效果如下图:
Python测试框架之pytest快速入门_第7张图片

参考

  • pytest官方站点: https://docs.pytest.org/en/7.4.x/


你可能感兴趣的:(python,pytest,unittest)