pytest系列——assert断言

迅捷小莫

本公众号日常更新自动化技术，编程知识，迅捷掌握一切测试工程师需要的技术！

12篇原创内容

公众号

Pytest

自动化测试中 ，有一个很重要的概念——断言。那什么是断言呢？用大白话来讲 ，断言无非就是给你的测试下一个结论：PASS OR FAIL。这样我们才能在执行结果中判断出用例的执行成功或失败。

在我们使用pytest的过程中，之前也提到过 用例的几种状态，分别是passed,failed,skipped,xpassed,xfailed。我们通常需要给每个用例添加断言，以保证我们用例执行的正确性。在pytest中，我们通常直接使用python自带的assert关键字。

01

为什么需要断言？

在此前经常碰到有些同学对断言的概念并不清晰，我们来看看下面的代码：

import pytest  # 导入pytest


def test_001():
    print("test_001 done")
    assert False  # 添加断言，使其失败


def test_002():
    print("test_002 done")
    print("test failed")  # 打印失败
    return False  # 返回错误


if __name__ == '__main__':  # 定义主函数
    pytest.main()  # 调用pytest

我们分别给两个测试函数，一个使用了断言（assert False，一定会失败），一个使用了return False。那这两个执行结果有什么区别呢？往下看：

test_001报错，而test_002没有报错，这是为什么呢？可能某些初学者会有这样的疑惑，pytest是根据什么来判断你的用例是失败的呢？

1. 用例执行过程有错误产生,这种错误通常是代码错误导致的问题，pytest会记录状态为FAILED

2. 发生了断言失败，记录为 FAILED

但是，实际上这两种是属于一种情况，因为我们如果发生断言错误，系统会抛出AssertionError:

所以总的来说，即如果运行过程中，发生了代码异常，pytest认为那就是用例执行失败。

02

怎么合理使用断言？

首先，我们要明确自己的测试目标是什么，比如是跑接口自动化，或者ui自动化，或者一些单元测试。第二，我们要明确什么可以代表测试用例“真正成功”。什么叫真正成功，难道还有假的成功不成？小提莫想说，确实有。

举个例子，我们现在想测试一个登入接口，login，接口文档如下：

登入接口文档

接口地址：/apis/login

请求方式：POST

请求格式：application/json

请求参数：

字段	说明	类型	是否必填
username	账号	String	是
password	密码	String	是

响应参数：

字段	说明	类型	备注
success	是否成功	Boolean	true false
code	响应码	Integer	0 登入成功     101 密码错误     102 账号不存在    103 账号密码为空
msg	提示信息	String	登入成功 密码错误 账号不存在 账号密码为空

可以看到上面的文档，我们在写接口测试用例的时候，需要对它怎么进行断言呢？

首先，断言和我的输入肯定是匹配的，断言其实就是我的预期结果，也就是我们黑盒测试中描述的那样：

我们向我们的测试对象（此时是login接口）输入x, y参数，那我们就会得到一个z的响应。比如我x, y分别代表账号和密码，那我此刻可以改变我的x, y的参数，得到不同的响应。所以在测试之前，我已经知道我想要的是什么了 （指的是断言）。比如x, y是正确的账号密码，那我的断言即为“登入成功”。输入密码错误，则为“密码错误”。如下图：

所以我们理清思路，转化成代码：

import pytest
import requests

user, pwd = ('admin', 123456)


def test_login_success():
    """
    登入成功
    :return: 
    """
    json = {
        "username": "admin",
        "password": 123456
    }
    response = requests.post(url='apis/login', json=json).json()
    assert response['msg'] == "登入成功"


def test_login_pwd_error():
    """
    密码错误
    :return: 
    """
    json = {
        "username": "admin",
        "password": 12345
    }
    response = requests.post(url='apis/login', json=json).json()
    assert response['msg'] == "密码错误"


def test_login_usr_not_exist():
    """
    账号不存在
    :return: 
    """
    json = {
        "username": "admin",
        "password": 12345
    }
    response = requests.post(url='apis/login', json=json).json()
    assert response['msg'] == "账号不存在"

我们只需要拿到msg来做断言即可，当然也可以用code也是可以的。

不过在断言的时候，我发现有的朋友会使用HTTP STATUS CODE来做断言，这个也就是我们常说的HTTP状态码，可能有的小伙伴会判断CODE=200, 那这种是非常不正确的做法，也就是小提莫前面提到的“真正成功”，它显然是不符合的。因为状态码200仅仅是代表接口通畅，而并非业务成功！我们一定要使用接口的业务字段 进行断言，才算达到要求的断言。

那本期内容介绍了如何使用断言，也终于把很多人的疑惑解开，到底怎么使用断言现在终于懂了呐。

see you later.

扫码关注哦～

迅捷小莫

本公众号日常更新自动化技术，编程知识，迅捷掌握一切测试工程师需要的技术！

13篇原创内容

公众号