AutoUAPI

介绍

auto-api 将用户端API接口HAR流量包转化成pytest脚本用例，进行流量回放。

项目背景

当我们需要对一个前端项目进行接口自动化回归测试时，无论是写接口脚本还是使用postman，jmeter或者是使用一些自动化平台，都需要做大量的接口配置工作。

为了减少测试人员代码编写或接口配置工作，基于pytest脚本模板，编写了本项目，目的的实现：

直接通过抓包文件HAR生成可执行的pytest用例文件。
可充分利用pytest的特性，可灵活编写代码，类似插件一样插入到pytest用例代码中。

安装教程

git clone https://gitee.com/guanfuchang/auto-uapi.git
pip install -r requirements.txt
python run_all.py

使用说明

项目目录结构

C:.                                                                               
│  conftest.py                                                                     
│  requirements.txt                                 
│  run_all.py                           # 运行主程序                      
│  settings.py                                      
│                                                   
├─case_datas                                                                     
│  │                                                
│  ├─case_har                           # 将Fiddler中导出的xx.har文件放到这里                      
│  │      fht.har                                   
│  │                                                
│  └─case_py                            # 运行generate_case_confLists.py 脚本将xx.har解析成用例配置列表xx.py                                       
│                                                                                                                                                                              
├─test_suits                            # 运行 generate_case_pytest.py 脚本将xx.py 解析生成pytest用例文件test_xx.py                                                               
└─utils                                             
    │  case_handler.py                  # 请求，断言处理          
    │  generate_case_confLists.py       # 将HAR文件解析成用例配置列表          
    │  generate_case_pytest.py          # 将用例配置列表解析成pytest运行文件

自动化过程分解

step1：通过Fiddler等工具，导出接口HAR文件xxx.har；

备注：建议使用Fiddler，可设置过滤器，方便过滤和删除不必要的接口

step2：通过脚本解析HAR文件，生成测试用例配置列表 ；

备注：举例如将index.har文件存到项目case_datas/case_har/目录下，然后修改generate_case_confLists.py中的har文件路径. 运行后会生成用例配置文件case_datas/case_py/xxx.py,内容类似如下：

case_list = [
    {
        "name": "mch_web_v1_login",
        "method": "POST",
        "api": "/mch_web/v1/login",
        "playload": {
            "uname": "fht20210621",
            "passwd": "fht20210621"
        },
        "assert_list": [
            [
                "resp.status_code==200",
                "接口响应状态码不等于200"
            ]
        ]
    },
    ...
]

备注：通过修改配置，可实现python代码参数化，变量自定义等功能

step3：通过脚本解析步骤2中生成的测试用例列表，生成可执行的pytest用例脚本；

备注：修改generate_case_pytest.py中的case_list和py_test_file，运行后会生成pytest用例文件如test_suits/test_xxx.py 内容类似如下：

from utils.case_handler import *


class TestIndex(object):

    def test_mch_web_v1_login(self, login_session):
        api = "/mch_web/v1/login"
        playload = {'uname': 'fht20210621', 'passwd': 'fht20210621'}
        method = "POST"
        resp = req(api=api, session=login_session, data=playload, method=method)
        validate(resp, [['resp.status_code==200', '接口响应状态码不等于200']])

    ...

step4：运行pytest用例脚本，生成测试报告。

DEMO 实例过程

参与贡献

Fork 本仓库
新建 Feat_xxx 分支
提交代码
新建 Pull Request

zhangchi / AutoUAPI

AutoUAPI

介绍

项目背景

安装教程

使用说明

项目目录结构

自动化过程分解

DEMO 实例过程

参与贡献

简介

发行版

贡献者

近期动态

zhangchi / AutoUAPI .gitee-modal { width: 500px !important; }

AutoUAPI

介绍

项目背景

安装教程

使用说明

项目目录结构

自动化过程分解

DEMO 实例过程

参与贡献

简介

发行版

贡献者

近期动态

搜索帮助

zhangchi / AutoUAPI