floraachy/apiautotest
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4943adf36bf6180d2d92ac9ca413c7ff900dc512
apiautotest/README.md

14 KiB
Raw Blame History

前言

公司突然要求你做自动化，但是没有代码基础不知道怎么做？或者有自动化基础，但是不知道如何系统性的做自动化， 放在yaml文件中维护，不知道如何处理多业务依赖的逻辑？

那么本自动化框架，将为你解决这些问题。

  • 框架主要使用 python 语言编写，结合 pytest 进行二次开发，用户仅需要在 yaml 或者 excel 文件中编写测试用例， 编写成功之后，会自动生成测试用例代码，零基础代码小白，也可以操作。
  • 如果是具备代码基础的，也可以直接通过 py 文件编写测试用例。
  • 使用 Allure 生成报告，并针对测试报告样式进行了调整，使得报告更加美观；
  • 测试完成后，支持发送 企业微信通知/ 钉钉通知/ 邮箱通知，灵活配置。

一、框架介绍

本框架主要是基于 Python + Pytest + Allure + Loguru + 邮件通知/企业微信通知/钉钉通知 实现的接口自动化框架。

对于框架任何问题，欢迎联系我！

二、实现功能

  • 通过session会话方式，解决了登录之后cookie关联处理`
  • 数据库断言: 直接在测试用例中写入查询的sql即可断言，无需编写代码
  • 动态多断言: 如接口需要同时校验响应数据和sql校验，支持多场景断言
  • 框架天然支持接口动态传参、关联灵活处理
  • 支持测试数据分析，测试数据不符合规范有预警机制
  • 支持通过用例数据动态配置pytest.mark， 包括自定义标记，pytest.mark.skip以及pytest,mark.usefixtues
  • 支持利用allure设置用例优先级，运行指定优先级的用例
  • 测试数据隔离, 实现数据驱动
  • 自动生成用例代码: 测试人员在yaml/excel文件中填写好测试用例, 程序可以直接生成用例代码，纯小白也能使用
  • 使用Allure生成测试报告，并对测试报告进行了定制化修改，使得测试报告更加美观
  • 日志模块: 采用loguru管理日志，可以输出更为优雅，简洁的日志
  • 钉钉、企业微信通知: 支持多种通知场景，执行成功之后，可选择发送钉钉、或者企业微信、邮箱通知
  • 执行环境一键切换，解决多环境相互影响问题
  • 使用pipenv管理虚拟环境和依赖文件，提供了一系列命令和选项来帮助你实现各种依赖和环境管理相关的操作
  • 支持将swagger.json接口文档转为YAML用例

三、依赖库

pymysql = "*"
loguru = "*"
requests-toolbelt = "*"
requests = "*"
openpyxl = "*"
sshtunnel = "*"
yagmail = "*"
pyyaml = "*"
click = "*"
faker = "*"
jsonpath = "*"
pytest = "==6.2.5"
pytest-rerunfailures = "*"
allure-pytest = "==2.9.45"
pydantic = "*"
xpinyin = "*"
"ruamel.yaml" = "*"

四、安装教程

  1. 通过Git工具clone代码到本地 或者 直接下载压缩包ZIP
https://gitlink.org.cn/floraachy/apiautotest.git

  1. 本地电脑搭建好 python环境，我使用的python版本是3.9。包括allure测试报告所需的java环境（安装jdk）。

  2. 安装pipenv

# 建议在项目根目录下执行命令安装
pip install pipenv
  1. 使用pipenv管理安装环境依赖包：pipenv install （必须在项目根目录下执行）
   注意：使用pipenv install会自动安装Pipfile里面的依赖包，该依赖包仅安装在虚拟环境里，不安装在测试机。

如上环境都已经搭建好了，包括框架依赖包也都安装好了。


注意：

  • 很多同学不太熟悉pipenv，会存在问题：比如我按照上述操作安装了依赖包，怎么运行报错呢？一定要记住，使用pipenv安装依赖包，依赖包只安装在虚拟环境，不安装在你的测试机器。所以你安装完成后，直接运行肯定会报错。我们需要进入我们创建的虚拟环境，再运行测试代码。具体步骤参考：章节"运行自动化测试"。
  • 如果存在Python版本与我的不一致的问题，请移步最后的章节"初始化项目可能遇到的问题"， 查找解决办法。
  • 另外，我们如果是使用pycharm直接右键run的情况，我们需要pycharm解释器选择我们创建的虚拟环境，才不会报少包的错误。

五、如何创建用例

注意：如果想用我框架中的用例执行运行测试，可以暂时跳过这一章节，直接看章节 "运行自动化测试"。

1. 修改配置文件 config.settings.py

1）确认用例是通过YAML还是Excel编写，由CASE_FILE_TYPE控制 2）确认测试完成后是否发送测试结果，由SEND_RESULT_TYPE控制，并填充对应邮件/钉钉/企业微信配置信息 3）确认测试是否需要进行数据库断言，如有需求，填充数据库配置信息 4）指定日志收集级别，由LOG_LEVEL控制

2. 修改全局变量，增加测试数据 config.settings.py

  1. 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_markers: 给测试方法添加标记，支持自定义标记，skip, usefixtures。 格式是列表嵌套字符串或者字典。例如： # ['glcc', {'skip': '跳过执行该用例'}]
case_info: 具体的用例数据，是以列表的形式进行管理
-
  id：用例id
  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: 需要上传的文件，参考如下传参：{接口中文件参数的名称:'文件路径地址'}
  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 -m demo 在test环境仅运行打了标记demo用例，生成allure测试报告
  > python run.py -env live 在live环境运行测试用例
  > python run.py -env=test 在test环境运行测试用例
  > python run.py -report=no 在test环境下允许测试用例，不生成allure测试报告

注意：

  • 如果pycharm.interpreter拥有了框架所需的所有依赖包，可以通过pycharm直接在run.py中右键运行

七、查看测试报告

Allure测试报告

  1. Allure生成的测试报告，支持通过pycharm，点击outputs/report/allure_html/index.html打开查看测试报告
  2. 如果不通过pycharm打开，直接通过文件夹打开，windows系统环境下，可以点击outputs/report/allure_html/双击打开Allure报告.bat打开查看测试报告

注意：

  • 通过点击outputs/report/allure_html/双击打开Allure报告.bat打开测试报告的方法，暂时不支持mac系统
  • 如果通过点击outputs/report/allure_html/双击打开Allure报告.bat打开测试报告，命令窗口显示乱码，或者打不开，可以把.bat的文件名称修改为英文的名称，里面的所有中文注释全部移除，再次尝试

八 、详细功能说明

九、初始化项目可能遇到的问题

Reference in New Issue View Git Blame Copy Permalink