前言
公司突然要求你做自动化，但是没有代码基础不知道怎么做？或者有自动化基础，但是不知道如何系统性的做自动化， 放在yaml文件中维护，不知道如何处理多业务依赖的逻辑？
那么本自动化框架，将为你解决这些问题。
- 框架主要使用 python 语言编写，结合 pytest 进行二次开发，用户仅需要在 yaml 或者 excel 文件中编写测试用例， 编写成功之后，会自动生成测试用例代码，零基础代码小白，也可以操作。
- 如果是具备代码基础的，也可以直接通过 py 文件编写测试用例。
- 使用 pytest-html / Allure 生成报告，并针对测试报告样式进行了调整，使得报告更加美观；
- 测试完成后，支持发送 企业微信通知/ 钉钉通知/ 邮箱通知，灵活配置。
一、框架介绍
本框架主要是基于 Python + pytest + pytest-html/Allure + loguru + 邮件通知/企业微信通知/钉钉通知 实现的接口自动化框架。
- git地址: https://www.gitlink.org.cn/floraachy/apiautotest
- 项目参与者: floraachy
- 技术支持邮箱: 1622042529@qq.com
- 个人博客地址: https://blog.csdn.net/FloraCHY
对于框架任何问题，欢迎联系我！
二、实现功能
- 通过session会话方式，解决了登录之后cookie关联处理
- 数据库断言: 直接在测试用例中写入查询的sql即可断言，无需编写代码
- 动态多断言: 如接口需要同时校验响应数据和sql校验，支持多场景断言
- 框架天然支持接口动态传参、关联灵活处理
- 支持测试数据分析，测试数据不符合规范有预警机制
- 测试数据隔离, 实现数据驱动
- 自动生成用例代码: 测试人员在yaml/excel文件中填写好测试用例, 程序可以直接生成用例代码，纯小白也能使用
- 多种报告随心选择：框架支持pytest-html以及Allure测试报告，可以动态配置所需报告
- 日志模块: 采用loguru管理日志，可以输出更为优雅，简洁的日志
- 钉钉、企业微信通知: 支持多种通知场景，执行成功之后，可选择发送钉钉、或者企业微信、邮箱通知
- 执行环境一键切换，解决多环境相互影响问题
- 使用pipenv管理虚拟环境和依赖文件，提供了一系列命令和选项来帮助你实现各种依赖和环境管理相关的操作
三、目录结构
├────case_utils/ 测试框架相关工具类
│ ├────__init__.py
│ ├────allure_handle.py 操作allure的相关方法
│ ├────assert_handle.py 断言处理， 包括响应断言和数据库断言
│ ├────case_data_analysis 分析用例数据是否符合规范
│ ├────case_fun_handle.py 根据配置文件，从指定类型文件中读取用例数据，并调用生成用例文件方法，生成用例文件
│ ├────data_handle.py 数据处理
│ ├────extract_data_handle.py 提取数据的一些方法
│ ├────get_results_handle.py 从pytest-html/allure测试报告中获取测试结果
│ ├────platform_handle.py 跨平台的支持allure，用于生成allure测试报告
│ ├────request_data_handle.py 针对用例数据进行请求前后的处理
│ └────send_result_handle.py 根据配置文件，从html测试报告中获取测试结果，发送指定类型的通知
├────common_utils/ 公共的工具类
│ ├────__init__.py
│ ├────base_request.py 封装的requests请求
│ ├────bs4_handle.py bs4（BeautifulSoup4）是Python中的第三方库。可以从HTML或XML文件中提取数据的Python库。
│ ├────dingding_handle.py 封装的钉钉机器人
│ ├────excel_handle.py 处理excel
│ ├────files_handle.py 处理文件相关操作
│ ├────func_handle.py 函数装饰器
│ ├────http_server.py 封装的HTTP服务
│ ├────mysql_handle.py 使用pymysql模块连接mysql数据库的公共方法
│ ├────time_handle.py 封装处理时间操作的一些方法
│ ├────wechat_handle.py 封装企业微信机器人
│ ├────yagmail_handle.py 封装通过yagmail发送邮件的方法
│ └────yaml_handle.py 处理yaml文件
├────config/
│ ├────__init__.py
│ ├────allure_config/
│ │ ├────gitlinklogo.jpg 保存用来替换allure报告的logo的，在代码中无用处
│ │ ├────http_server.exe http服务，用来放置在allure压缩包中，方便在不安装allure环境下打开allure报告
│ │ ├────logo.svg 保存用来替换allure报告的logo的，在代码中无用处
│ │ ├────双击打开Allure报告.bat .bat文件，用来放置在allure压缩包中，方便在不安装allure环境下打开allure报告
│ ├────pytest_html_config/
│ │ ├────pytest_html_report.css 改变pytest-html测试报告的样式文件
│ ├────case_template.txt 自动生成的测试用例文件模板
│ ├────global_vars.py 保存的一些全局变量
│ ├────path_config.py 项目路径管理
│ └────settings.py 配置文件
├────conftest.py
├────data/ 测试用例数据
│ ├────test_login_demo.yaml
│ ├────test_login_excel_demo.xlsx
│ └────test_new_project_demo.yaml
├────outputs/
│ └────report/ 保存测试报告的目录
│ └────log/ 保存日志文件的目录
├────files 存放测试过程中需要上传的文件
├────Pipfile
├────pytest.ini
├────README.md
├────run.py 运行入口
└────test_case/ 测试用例
│ ├────conftest.py
│ ├────test_auto_case/ 自动生成的测试用例目录
│ │ ├────test_login_demo.py
│ │ ├────test_login_excel_demo.py
│ │ └────test_new_project_demo.py
│ └────test_manual_case/ 手动编写的测试用例目录
│ │ ├────__init__.py
│ │ ├────test_demo.py
│ │ └────test_login_demo.py
四、依赖库
pymysql = "*"
loguru = "*"
requests-toolbelt = "*"
beautifulsoup4 = "*"
requests = "*"
openpyxl = "*"
sshtunnel = "*"
yagmail = "*"
pyyaml = "*"
click = "*"
faker = "*"
jsonpath = "*"
pytest = "==6.2.5"
pytest-html = "==2.1.1"
pytest-rerunfailures = "*"
allure-pytest = "==2.9.45"
pydantic = "*"
xpinyin = "*"
五、安装教程
- 通过Git工具clone代码到本地 或者 直接下载压缩包ZIP
git clone https://gitlink.org.cn/floraachy/uiautotest.git
-
本地电脑搭建好 python环境，我使用的python版本是3.9
-
安装pipenv
# 建议在项目根目录下执行命令安装
pip install pipenv
- 使用pipenv管理安装环境依赖包：pipenv install （必须在项目根目录下执行）
注意：使用pipenv install会自动安装Pipfile里面的依赖包，该依赖包仅安装在虚拟环境里，不安装在测试机。
如上环境都已经搭建好了，包括框架依赖包也都安装好了。
六、如何创建用例
1. 修改配置文件 config.settings.py
1）确认用例是通过YAML还是Excel编写，由CASE_FILE_TYPE控制 2）确认测试完成后是否发送测试结果，由SEND_RESULT_TYPE控制，并填充对应邮件/钉钉/企业微信配置信息 3）确认测试是否需要进行数据库断言，如有需求，填充数据库配置信息 4）指定日志收集级别，由LOG_LEVEL控制
2. 修改全局变量，增加测试数据 config.global_vars.py
- ENV_VARS["common"]是一些公共参数，如报告标题，报告名称，测试者，测试部门。后续会显示在测试报告上。如果还有其他，可自行添加 2）ENV_VARS["test"]是保存test环境的一些测试数据。ENV_VARS["live"]是保存live环境的一些测试数据。如果还有其他环境可以继续增加，例如增加ENV_VARS["dev"] = {"host": "", ......}
3. 删除框架中的示例用例数据
1）删除 data目录下所有的YAML和EXCEL文件
2）删除 test_case/test_manual_case目录下所有手动编写的用例
4. 编写测试用例（两种方式任选其一或者都选）
1 自动生成测试用例 data test_case.test_auto_case
- 在目录
data下新建一个YAML/Excel文件。按照如下字段要求进行测试用例数据添加 - 注意：如果需要自动创建测试用例文件，YAML/Excel文件的文件名需要以"test"开头。
2. 手动编写测试用例 data test_case.test_manual_case
- 原则上，如果是手动编写测试用例（python代码）， 测试用例数据文件不要以"test"开头。 如果以“test”开头，可能导致用例运行多次。
1）在目录
data下新建一个YAML/Excel文件，按照要求编写测试用例数据 2）在test_case.test_manual_case下新建一个以"test"开头的测试方法，进行测试用例方法编写。
5. 用例中相关字段的介绍
case_common ：公共参数
allure_epic：用作于@allure.epic()装饰器中的内容。
allure_feature：用作于@allure.feature()装饰器中的内容。
allure_story：用作于@allure.story()装饰器中的内容。
case_001：用例ID
feature：用例所属模块， 类似于@allure.feature()。
title：用例标题
run：是否执行用例，为空或者True都会执行，为False则不执行。
url：请求路径（可填写全路径 或者 资源路径）。通常我们填写资源路径。在用例执行前，会针对路径进行处理。具体可见case_utils.request_data_handle.py.RequestPreDataHandle.url_handle。注：请求路径=基准路径（host/base_url）+资源路径(url)。
method：请求方式，例如：GET, POST, DELETE, PUT, PATCH等
headers：请求头，注意如果在headers里面防止cookies，其值类型需要是字符串
cookies：请求cookies，格式是：DICT， CookieJar对象
request_type：请求数据类型：params, json, file, data
payload：请求参数
files: 需要上传的文件，参考如下传参：{接口中文件参数的名称:”文件路径地址”/[“文件地址1”, “文件地址2”]}
extract：后置提取参数
assert_response：响应断言
assert_sql：数据库断言
6. Excel用例单独说明
框架支持excel多表单自动生成测试用例，每一个表单作为一个测试用例模块。 例如： excel表格名称是：test_demo.xlsx excel表单1名称是：GitLink-登录模块 excel表单2名称是：示例模块
生成规则：
- 如果excel表单中存在"-"，我们将取"-"后面的部分的首字母拼接excel文件名称作为测试用例模块/测试用例类/测试用例方法名称
- 如果excel表单中不存在"-"，我们将直接获取表单名称首字母拼接excel文件名称作为测试用例模块/测试用例类/测试用例方法名称
- 测试用例模块/测试用例类/测试用例方法名称同时也将遵循python语法规则进行适当调整
基于上述规则：
-
excel第一个表单生成的测试用例 测试用例模块：test_demo_dlmk.py 测试用例类：TestDemoDlmkAuto 测试用例方法：test_demo_dlmk_auto
-
excel第二个表单生成的测试用例 测试用例模块：test_demo_slmk.py 测试用例类：TestDemoSlmkAuto 测试用例方法：test_demo_slmk_auto
七、运行自动化测试
1. 激活已存在的虚拟环境
- （如果不存在会创建一个）：pipenv shell （必须在项目根目录下执行）
2. 运行
在pycharm>terminal或者电脑命令窗口，进入项目根路径，执行如下命令（如果依赖包是安装在虚拟环境中，需要先启动虚拟环境）。
> python run.py (默认在test环境运行测试用例, 报告采用allure)
> python run.py -env live 在live环境运行测试用例
> python run.py -env=test 在test环境运行测试用例
> python run.py -report=pytest-html (默认在test环境运行测试用例, 报告采用pytest-html)
注意：
- 如果pycharm.interpreter拥有了框架所需的所有依赖包，可以通过pycharm直接在
run.py中右键运行
八、查看测试报告
pytest-html测试报告
如果是pytest-html生成的测试报告，直接打开outputs目录下的.html报告即可。支持通过任意浏览器打开查看
Allure测试报告
- 如果是Allure生成的测试报告，支持通过pycharm，点击
outputs/report/allure_html/index.html打开查看测试报告 - 如果不通过pycharm打开，直接通过文件夹打开，windows系统环境下，可以点击
outputs/report/allure_html/双击打开Allure报告.bat打开查看测试报告
注意：
- 通过点击
outputs/report/allure_html/双击打开Allure报告.bat打开测试报告的方法，暂时不支持mac系统 - 如果通过点击
outputs/report/allure_html/双击打开Allure报告.bat打开测试报告，命令窗口显示乱码，或者打不开，可以把.bat的文件名称修改为英文的名称，里面的所有中文注释全部移除，再次尝试