python+pytest+request+allure+yaml接口自动化测试项目实战
开发环境准备
1. jdk 下载
Java官网下载地址:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
安装: https://blog.csdn.net/VA_AV/article/details/138508891
2. Pytest
bash
# 安装
pip install pytest
#更新 pytest
pip install --upgrade pytest
# 确认 Pytest 是否已成功安装,并显示 Pytest 的版本信息
pytest --version
python + Pytest + requests 的接口自动化
1. 设计框架结构
bash
project_root/
├── conf/ # 配置文件
│ ├── config.yaml # 全局配置
│ └── env_config.yaml # 环境配置
├── data/ # 测试数据
│ ├── test_data.json # 测试数据文件
│ └── ...
├── lib/ # 自定义库
│ ├── api_client.py # API客户端
│ └── utils.py # 工具函数
├── tests/ # 测试用例
│ ├── test_case1.py
│ ├── test_case2.py
│ └── ...
├── reports/ # 测试报告
│ ├── allure_report/ # Allure报告
│ └── pytest_report/ # Pytest报告
├── requirements.txt # 依赖包
└── README.md # 项目说明
2. 编写配置文件
bash
# conf/config.yaml
base_url: http://api.example.com
timeout: 10
# conf/env_config.yaml
dev:
base_url: http://dev-api.example.com
timeout: 5
prod:
base_url: http://prod-api.example.com
timeout: 10
置文件用于管理全局配置和环境配置。例如:
3. 封装API客户端
封装一个API客户端,用于发送HTTP请求并处理响应。例如,使用Python和Requests库:
bash
# lib/api_client.py
import requests
from conf.config import config
class APIClient:
def __init__(self):
self.base_url = config['base_url']
self.timeout = config['timeout']
def get(self, endpoint, params=None, headers=None):
url = f"{self.base_url}{endpoint}"
response = requests.get(url, params=params, headers=headers, timeout=self.timeout)
return response
def post(self, endpoint, json=None, headers=None):
url = f"{self.base_url}{endpoint}"
response = requests.post(url, json=json, headers=headers, timeout=self.timeout)
return response
# 其他HTTP方法类似
4. 编写测试用例
编写具体的测试用例,使用测试框架来组织和运行这些用例。例如,使用Pytest:
bash
# tests/test_case1.py
from lib.api_client import APIClient
def test_get_user():
client = APIClient()
response = client.get('/users/1')
assert response.status_code == 200
assert response.json()['id'] == 1
def test_create_user():
client = APIClient()
data = {'name': 'John Doe', 'email': 'john.doe@example.com'}
response = client.post('/users', json=data)
assert response.status_code == 201
assert response.json()['name'] == 'John Doe'
5. 集成报告工具
集成报告工具,生成详细的测试报告。例如,使用Allure:
bash
# 安装Allure插件
pip install allure-pytest
# 运行测试并生成报告
# 要使 Allure 侦听器能够在测试执行期间收集结果,只需在命令行添加存储结果的文件夹的路径参数即可
pytest --alluredir=reports/allure_report
#要在测试完成后查看实际报告,需要使用 Allure 命令行实用程序从结果生成报告:
allure serve reports/allure_report
allure的安装和使用(windows环境)
https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/
-
选择一个版本(windows下载.zip包就可以)
下载完直接解压就好了(记住路径)
打开包,打到bin目录,找到allure.bat双击运行
-
配置allure系统环境变量
【计算机--属性--高级系统设置--环境变量--系统变量--path--编辑】
环境变量添加刚才解压时allure的地址 放bin文件的路径:E:\tools\allure-2.30.0\bin
-
检验环境变量配置成功:打开终端命令行,输入:allure
6. 集成持续集成工具
将测试框架集成到持续集成工具中,实现自动化测试。
持续集成工具:Jenkins、GitLab CI等。
7. 文档和维护
编写详细的文档,包括项目说明、使用指南和维护手册。