Pytest接口自动化框架

预研背景

目前系统研发多为前后端分离，当后端接口研发完成后，可以不依赖前端界面通过接口测试提前发现问题并解决。同时由于软件迭代周期不断缩短，开发新功能后又担心影响原有功能，可以通过接口自动化进行原有功能快速回归测试，将更多精力专注于迭代功能测试，这样才能放心地发布产品。由此看来，接口自动化测试可以减轻工作量，提高测试效率和产品质量。市面上的主流接口自动化测试工具或框架很多，需要调研对比各自的特点，挑选出适合项目的工具快速完成自动化测试。

预研目标

体验工具主要特性功能使用及便利性，体验内容包含如下：

l 单接口测试

l 多接口组合测试

l 测试报告

l 测试用例管理

l 日志查看

l 脚本调试

l 持续集成

工具/框架介绍

Pytest是一个软件测试框架。它是一款命令行工具，可以直接测试各类程序自动找到测试用例执行，并且汇报测试结果。

l 主要特性:

1) 易于上手，入门简单

2) 能支持简单的单元测试和复杂的功能测试

3) 测试用例编写简单可读性强，支持参数化

4) 灵活指定用例执行方式、顺序等

5) 丰富的基础库，可以大幅提高用户编写测试用例效率

6) 详细的日志输出

7) 灵活、扩展性好，可以很容易地融入已有的开发测试流程如可运行由unittest和node编写的测试用例

8) 很容易与其他工具集成到一起使用，比如和jenkins持续集成、allure测试报告展示等

官网：https://docs.pytest.org/en/latest/index.html

工具/框架环境搭建

使用Python3+Pytest+Request+Jenkins+Allure框架来进行接口自动化测试，并实现持续集成，自动生成html测试报告。

1、Python安装

它不依赖与Python版本，Python2(2.6及更高版本)和Python3(3.3及更高版本)都可以安装最新版本的pytest。

l 检查本地是否已有python环境：

python --version

l python3安装（若已经安装，此步忽略）

安装可参考：https://blog.csdn.net/weixin_40844416/article/details/80889165

1、requests安装

l 通过命令行安装requests

pip install request

3、Pytest安装

l 通过命令行安装Pytest

pip install pytest

l 命令行检查安装版本

pytest --version

4、Pycharm配置pytest运行程序

Pycharm File->Settings->Tools->Python Integrated Tools，选择需运行pytest项目，Default test runner下拉选择pytest，设置完成后，编写pytest用例即可直接使用pytest运行

编写第一个自动化脚本

脚本实现的用户场景：获取Token-》发起一个HTTP请求-》对响应结果进行断言

详细步骤：

1、每个接口都需要用到token，通过conftest.py共享fixture，@pytest.fixture标记返回封装获取token值函数

conftest.py:

import pytest  
import requests  
  
authentication_url_path = "/v1/tokens"  
  
json_login = {  
    "authType": "password",  
    "params": {  
        "username": "zhuxuefei",  
        "password": "jixlb2tIrjF5t/bYQTXz4Q=="  
    }  
}  
  
def pytest_addoption(parser):  
    parser.addoption("--ip", action="store", default="XX.XX.XX.XX", help="please input target VM ip.")  
    parser.addoption("--port", action="store", default="api", help="please input target service port.")  
 
 
@pytest.fixture(scope="session")  
def ip(request):  
    return request.config.getoption("--ip")  
 
 
@pytest.fixture(scope="session")  
def port(request):  
    return request.config.getoption("--port")  
 
 
@pytest.fixture(scope="session")  
def uri(ip,port):  
    uri = "http://%s/%s" % (ip, port)  
    return uri  
 
 
@pytest.fixture(scope="session")  
def auth_token(uri):  
    headers = {"User-Agent": "automation",  
               "content-type": "application/json;charset=UTF-8"  
               }  
  
    post_response = requests.post(url=uri + authentication_url_path,  
                                  json=json_login,  
                                  headers=headers)  
  
    assert post_response.status_code == requests.status_codes.codes.OK  
    resp_payload = post_response.json()  
    assert resp_payload['status'] == 200  # to be defined.  
    auth_token = resp_payload['data']['key']  
  
    return auth_token  

@pytest.fixture(scope="session")  
def headers(uri):  
    headers = {"User-Agent": "automation",  
               "content-type": "application/json;charset=UTF-8"  
               }  
  
    post_response = requests.post(url=uri + authentication_url_path,  
                                  json=json_login,  
                                  headers=headers)  
  
    assert post_response.status_code == requests.status_codes.codes.OK  
    resp_payload = post_response.json()  
    assert resp_payload['status'] == 200  # to be defined.  
    auth_token = resp_payload['data']['key']  
  
    headers = {"User-Agent": "automation",  
               "content-type": "application/json;charset=UTF-8",  
               "T-AUTH-TOKEN": auth_token}  
    return headers  

2、将获取token值fixture函数传递给http请求接口

3、用例数据写在excel文件中，实现读取测试用例逻辑，将测试用例数据通过@pytest.mark.parametrize()传入测试函数，循环执行测试数据

param_create_vlanpool = read_excel_tuple(excelFile, '创建VLAN池')  

4、每次执行assert断言用例结果

用例名称以test开头，如test_create_vlanpool.py:

@pytest.mark.parametrize('name,tag,ResourcePoolName,vlanTagStart,vlanTagEnd', param_create_vlanpool)  
def test_create_vlanpool(uri, headers, name, tag, ResourcePoolName, vlanTagStart, vlanTagEnd):  
    resourcepoolid = get_resourcepoolid(uri, headers, ResourcePoolName)  
    param = {  
        'name': name,  # VLAN池名称  
        'tag': tag,  
        'vlanPoolResourcePoolList': [{'resourcePoolId': resourcepoolid}],  #作用域调用资源池ID  
        'vlanTagEnd': vlanTagStart,  # 结束VLAN ID  
        'vlanTagStart': vlanTagEnd  # 起始VLAN ID  
    }  
    create_vlanpool_response = requests.post(  
        url=uri + create_vlanpool_url_path,  
        headers=headers,  
        json=param  
    ).json()  
    print(create_vlanpool_response)  
    code = create_vlanpool_response['status']  
    allure.attach("请求响应code", str(create_vlanpool_response['status']))  
    allure.attach("请求响应结果", str(create_vlanpool_response))  
    my_log().info(create_vlanpool_response)  