2024年最全Python+Requests+Pytest+YAML+Allure实现接口自动化

2401_84584583

357人浏览 · 2024-05-01 19:51:16

2401_84584583 · 2024-05-01 19:51:16 发布

    if method == "DELETE":
        return self.session.delete(url, **kwargs)
    if method == "PATCH":
        if json:
            data = complexjson.dumps(json)
        return self.session.patch(url, data, **kwargs)


### 四、HTTP接口 封装为 Python接口


在 api/user.py 文件中，将上面封装好的HTTP接口，再次封装为不同的Python接口。不同的Python接口，会处理不同URL下的请求。

class User(RestClient):

def __init__(self, api_root_url, **kwargs):
    super(User, self).__init__(api_root_url, **kwargs)

def list_all_users(self, **kwargs):
    return self.get("/users", **kwargs)

def list_one_user(self, username, **kwargs):
    return self.get("/users/{}".format(username), **kwargs)

def register(self, **kwargs):
    return self.post("/register", **kwargs)

def login(self, **kwargs):
    return self.post("/login", **kwargs)

def update(self, user_id, **kwargs):
    return self.put("/update/user/{}".format(user_id), **kwargs)

def delete(self, name, **kwargs):
    return self.post("/delete/user/{}".format(name), **kwargs)


### 五、关键字返回结果类


在 core/result\_base.py 下，定义了一个空类 ResultBase ，该类主要用于自定义关键字返回结果。

class ResultBase():
pass

“”"
自定义示例：
result = ResultBase()
result.success = False
result.msg = res.json()[“msg”]
result.response = res
“”"`


在多流程的业务场景测试下，通过自定义期望保存的返回数据值，以便更好的进行断言。


### 六、关键字封装


关键字应该是具有一定业务意义的，在封装关键字的时候，可以通过调用多个Python接口来完成。在某些情况下，比如测试一个充值接口的时候，在充值后可能需要调用查询接口得到最新账户余额，来判断查询结果与预期结果是否一致，那么可以这样来进行测试：


1, 首先，可以把 充值-查询 的操作封装为一个关键字，在这个关键字中依次调用充值和查询的接口，并可以自定义关键字的返回结果。  
 2, 接着，在编写测试用例的时候，直接调用关键字来进行测试，这时就可以拿到关键字返回的结果，那么断言的时候，就可以直接对关键字返回结果进行断言。


### 七、测试用例层


**根据用例名分配测试数据**


测试数据位于 data 文件夹下，在这里使用 YAML 来管理测试数据，同时要求测试数据中第一层的名称，需要与测试用例的方法名保持一致，如 test\_get\_all\_user\_info 、test\_delete\_user。

test_get_all_user_info:

期望结果,期望返回码,期望返回信息

except_result, except_code, except_msg

[True, 0, “查询成功”]
省略
test_delete_user:

删除的用户名,期望结果,期望返回码,期望返回信息

username, except_result, except_code, except_msg

[“测试test”, True, 0, “删除用户信息成功”]
[“wintest3”, False, 3006, “该用户不允许删除”]


这里借助 fixture 方法，我们就能够通过 request.function.\_\_name\_\_ 自动获取到当前执行用例的函数名 testcase\_name ，当我们传入测试数据 api\_data 之后，接着便可以使用 api\_data.get(testcase\_name) 来获取到对应用例的测试数据。

import pytest
from testcases.conftest import api_data

@pytest.fixture(scope=“function”)
def testcase_data(request):
testcase_name = request.function.name
return api_data.get(testcase_name)`


**数据准备和清理**


在接口自动化中，为了保证用例可稳定、重复地执行，我们还需要有测试前置操作和后置操作，即数据准备和数据清理工作。

@pytest.fixture(scope=“function”)
def delete_register_user():
“”“注册用户前，先删除数据，用例执行之后，再次删除以清理数据”“”
del_sql = base_data[“init_sql”][“delete_register_user”]
db.execute_db(del_sql)
logger.info(“注册用户操作：清理用户–准备注册新用户”)
logger.info(“执行前置SQL：{}”.format(del_sql))
yield # 用于唤醒 teardown 操作
db.execute_db(del_sql)
logger.info(“注册用户操作：删除注册的用户”)
logger.info(“执行后置SQL：{}”.format(del_sql))


在这里，以用户注册用例为例。对于前置操作，我们应该准备一条删除SQL，用于将数据库中已存在的相同用户删除，对于后置操作，我们应该再执行删除SQL，确保该测试数据正常完成清理工作。


在测试用例中，我们只需要在用例上传入 fixture 的函数参数名 delete\_register\_user ，这样就可以调用 fixture 实现测试前置及后置操作。当然，也可以使用pytest装饰器 @pytest.mark.usefixtures() 来完成，如：

@pytest.mark.usefixtures(“delete_register_user”)`


**Allure用例描述**


在这里，我们结合 Allure 来实现输出测试报告，同时我们可以使用其装饰器来添加一些用例描述并显示到测试报告中，以便报告内容更加清晰、直观、可读。如使用 @allure.title() 自定义报告中显示的用例标题，使用 @allure.description() 自定义用例的描述内容，使用 @allure.step() 可在报告中显示操作步骤，使用 @allure.issue() 可在报告中显示缺陷及其链接等。

@allure.step(“步骤1 ==>> 注册用户”)
def step_1(username, password, telephone, sex, address):
logger.info(“步骤1 ==>> 注册用户 ==>> {}, {}, {}, {}, {}”.format(username, password, telephone, sex, address))

@allure.severity(allure.severity_level.NORMAL)
@allure.epic(“针对单个接口的测试”)
@allure.feature(“用户注册模块”)
class TestUserRegister():
“”“用户注册”“”
@allure.story(“用例–注册用户信息”)
@allure.description(“该用例是针对获取用户注册接口的测试”)
@allure.issue(“https://www.cnblogs.com/wintest”, name=“点击，跳转到对应BUG的链接地址”)
@allure.testcase(“https://www.cnblogs.com/wintest”, name=“点击，跳转到对应用例的链接地址”)
@allure.title(
“测试数据：【 {username}，{password}，{telephone}，{sex}，{address}，{except_result}，{except_code}，{except_msg}】”)
@pytest.mark.single
@pytest.mark.parametrize(“username, password, telephone, sex, address, except_result, except_code, except_msg”,
api_data[“test_register_user”])
@pytest.mark.usefixtures(“delete_register_user”)
def test_delete_user(self, login_fixture, username, except_result, except_code, except_msg):
省略`


### 七、项目部署


首先，下载项目源码后，在根目录下找到 requirements.txt 文件，然后通过 pip 工具安装 requirements.txt 依赖，执行命令：

pip3 install -r requirements.txt`


接着，修改 config/setting.ini 配置文件，在Windows环境下，安装相应依赖之后，在命令行窗口执行命令：

pytest


**注意**：因为我这里是针对自己的接口项目进行测试，如果想直接执行我的测试用例来查看效果，需要提前部署上面提到的接口项目。


### 八、测试报告效果展示


在命令行执行命令：pytest 运行用例后，会得到一个测试报告的原始文件，但这个时候还不能打开成HTML的报告，还需要在项目根目录下，执行命令启动 allure 服务

需要提前配置allure环境，才可以直接使用命令行

allure serve ./report`


最终，可以看到测试报告的效果图如下：


![](https://img-blog.csdnimg.cn/34d4c9960e514c64b2a11aa00cf3047f.png)




---


#### **【下面是我整理的2023年最全的软件测试工程师学习知识架构体系图】**




![在这里插入图片描述](https://img-blog.csdnimg.cn/20210511152217670.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poaWd1aWd1,size_16,color_FFFFFF,t_70)

**感谢每一个认真阅读我文章的人，看着粉丝一路的上涨和关注，礼尚往来总是要有的：**



①　2000多本Python电子书（主流和经典的书籍应该都有了）

②　Python标准库资料（最全中文版）

③　项目源码（四五十个有趣且经典的练手项目及源码）

④　Python基础入门、爬虫、web开发、大数据分析方面的视频（适合小白学习）

⑤ Python学习路线图（告别不入流的学习）




**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化学习资料的朋友，可以戳这里无偿获取](https://bbs.csdn.net/topics/618317507)**

**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**