前言：

采用当今主流的语言加框架加测试报告进行接口测试，其中不足，请大家多多指出并协助更改。 这里非常感谢一位老哥：https://gitee.com/zy7y QQ:396667207 感谢老哥耐心指教

语雀版：https://www.yuque.com/docs/share/dff93b31-cce0-4a7a-8d06-1540e659c32f?# 《Python-接口自动化(Request+pytest+allure)》

功能：

1. get/post请求(上传文件)，支持restful接口规范
2. 压缩测试报告
3. 生成allure漂亮的测试报告
4. 发送邮件(后续会集成jenkins)
5. 数据依赖

运行机制

1. 通过读取配置文件，获取到host地址、提取token的jsonpath表达式，提取实际响应结果用来与预期结果对比的jsonpath表达式
2. 读取excel用例文件数据，组成一个符合pytest参数化的用例数据，根据每列数据进行数据处理(token操作、数据依赖)
3. token的写需要使用一个正常的登陆接口，并且接口中要返回token数据，才能提取；token的读需要请求携带有token的header，token无数据将不携带token
4. 数据依赖处理，从excel中读取出来的格式**{"用例编号":["jsonpath表达式1":"jsonpath表达式2"]}** ，通过用例编号来获取对应的case的实际响应结果，通过jsonpath表达式提取对应的依赖参数字段，以及对应的值，最终会返回一个存储接口需要依赖数据的字典**{"userid":500,"username":"ranyong"}** ,在发送请求时与请求数据进行合并，组成一个新的data放在请求中
5. 每次请求完之后将回写实际的响应结果到excel中
6. 根据配置文件中配置的jsonpath表达式提取实际响应内容与excel中预期结果的数据对比
7. 生成测试报告
8. 压缩测试报告文件夹
9. 发送邮件

环境依赖

目录结构

├─api
│  ├─__init__.py # 初始化	
│  └─base_requests.py	# 请求封装
├─config
│  └─config.yaml	# 配置文件
├─data
│  └─test_data.xls	# Excel用例文件
├─test
│  ├─conftest.py	# 依赖对象初始化
│  └─test_api.py	# 测试文件
├─log
│  └─run...x.log	# 日志文件
├─report
│  ├─data
│  └─html			# allure报告
├─tools		# 工具包
│  ├─__init__.py		# 常用方法封装
│  ├─data_process.py	# 依赖数据处理
│  ├─db.py				# 数据库连接对象
│  ├─hooks.py			# 自定义扩展方法(可配合用例)文件 
│  ├─read_file.py		# 用例、配置项读取
│  └─send_email.py		# 邮件发送、报告压缩
├─requirements.txt		 # 项目依赖库文件
└─run.py	# 主启动文件(一键运行)

执行顺序

代码实现

首先了解下yaml文件的基础知识 Yaml文件初识： 以下为yaml文件的一个示例：

student:
    name: chen
    age: 18
    sex: 男
    class: 11

转换为json格式时：

{
  "student": {
    "name": "chen",
    "age": 18,
    "sex": "男",
    "class": 11
  }
}

以上可以看出，yaml的基本写法是比较简单的，注意的是，**同一级的字段要对齐，冒号后面要带上空格。**切记！切记！ yaml基础语法：

• 大小写敏感
• 使用缩进表示层级关系
• 缩进不能使用tab，只允许空格
• 缩进的空格数不重要，只要相同层级的元素左对齐即可
• '#'表示注释

详细了解请移步：https://www.runoob.com/w3cnote/yaml-intro.html

初始化安装

1. 安装最新的 Pycharm 社区版

2. 安装Python ，版本3.7+

3. 安装allure2 ，点击链接内的Links---Download，解压到任意目录，并配置好环境变量

4. 安装git ，完成后鼠标右键打开git bash，输入：

5. 找一个目录，打开git bash，输入： git clone [https://gitee.com/ran_yong/api-auto.git](https://gitee.com/ran_yong/auto_uiautomator2.git)

6. 打开Pycharm，打开上一步拉取下来的apiAutoTest文件夹，导入工程，点击settings---Project---Project Interpretor---add...---New environment---Location中在当前工程名后确认是否有/venv，没有的话手动输入，基本编译器选择python3的安装路径，确认即可

7. Pycharm需要先配置pip的repositories，推荐https://pypi.tuna.tsinghua.edu.cn/simple/ ，Pycharm的Terminal中，输入： pip3 install -r requirements.txt （若下载超时：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt） 等待安装完成后，环境就配置完成了，后续执行测试只要执行下面的第8步即可

8. 直接运行对应应用目录下的run.py即可

Excel用例展示

查看测试报告

运行run.py完成测试后会自动处理报告并使用默认浏览器打开报告，若关闭后想再次打开，请在pycharm中找到对应报告的目录下的index.html，右击--Open in Browser

其他

base64编码和解码

题外话：将数据加密成密文然后在传出去 此加密不能用字典类型的 需要将类型转换为字节

# 编码数据
import base64
import json

json_data = {
    "tag": "movie",
    "type": "华语"
}

str_json = json.dumps(json_data)

print(type(str_json), str_json)

b_str_json = str_json.encode()
print(type(b_str_json))
# 数据加密
print(base64.b64encode(b_str_json))

# 解码数据
import base64
import json

json_data = {
    "tag": "movie",
    "type": "华语"
}

encode_data = b'eyJ0YWciOiAibW92aWUiLCAidHlwZSI6ICJcdTUzNGVcdThiZWQifQ=='

print(base64.b64decode(encode_data))
b_str_json = base64.b64decode(encode_data)  # b'{"tag": "movie", "type": "\\u534e\\u8bed"}'
# 字节类型转换为字符串
str_json = b_str_json.decode()
print(type(str_json), str_json)  # <class 'str'> {"tag": "movie", "type": "\u534e\u8bed"}
print(json.loads(str_json))  # {'tag': 'movie', 'type': '华语'}