接口自动化知识与设计

一. 接口自动化测试

1. 自动化测试的流程：

• test环境：研发在向test环境代码仓库push代码后，自动的触发jenkins任务，构建接口自动化测试，并主动发送错误的构建邮件
• beta环境：周三上beta后，手动触发beta环境的自动化测试
• 线上环境：周四上线后，手动触发线上环境的自动化测试

2. 使用流程设计

• 目前有3个环境：test/beta/release，每个环境有2个版本的代码: pro/latest，所以需要维护3套环境的测试用例，并使用特殊的请求头，区分请求到哪个版本(pro/latest)代码中
• test环境，测试用例的管理基于excel，自动化测试框架搭建好后，基本上都是在维护一份excel的测试用例，对测试用例进行新增，修改，代码改动较少，后期维护成本低

二. 接口自动化测试设计

1. 基于python的单元测试框架：unittest、pytest

unittest和pytest都是基于python的单元测试框架，基本上都是由：test fixture(前置)、test case(测试用例)、test suite(测试集合)、test runner(运行测试)这几个概念组成，能很好的支持各类断言语句。

2. python ddt：数据驱动模块

一般进行接口测试时，每个接口的传参都不止一种情况，一般会考虑正向、逆向等多种组合，所以在测试一个接口时，通常会编写多条case，而这些除了传参不同外，并没有什么区别。这个时候就可以利用ddt来管理测试数据，提高代码复用率。

3. python requests：基于python的HTTP客户端库。

能够模拟客户端向服务器发送HTTP请求。

4. python xlrd：用于读取excel的数据

能够对excel表格进行读取，针对表单、逐行、逐列等方式读取

5. allure：测试报告库

https://www.jianshu.com/p/139234261ce4?utm_campaign=maleskine&utm_content=note&utm_medium=seo_notes&utm_source=recommendation

三. unittest

简单用法

unittest是python自带的一个单元测试框架，类似于java的junit，基本结构是类似的。基本用法如下：

1.用import unittest导入unittest模块

2.定义一个继承自unittest.TestCase的测试用例类，如class xxx(unittest.TestCase):

3.定义setUp和tearDown，这两个方法与junit相同，即如果定义了则会在每个测试case执行前先执行setUp方法，执行完毕后执行tearDown方法。

4.定义测试用例，名字以test开头，unittest会自动将test开头的方法放入测试用例集中。

5.一个测试用例应该只测试一个方面，测试目的和测试内容应很明确。主要是调用assertEqual、assertRaises等断言方法判断程序执行结果和预期值是否相符。

6.调用unittest.main()启动测试

7.如果测试未通过，则会显示e，并给出具体的错误（此处为程序问题导致）。如果测试失败则显示为f，测试通过为.，如有多个testcase，则结果依次显示。

image.png

四. ddt模块

ddt 是第三方模块，需安装， pip install ddt

DDT包含类的装饰器ddt和两个方法装饰器data（直接输入测试数据）

通常情况下，data中的数据按照一个参数传递给测试用例，如果data中含有多个数据，以元组，列表，字典等数据，需要自行在脚本中对数据进行分解或者使用unpack分解数据。

@data(a,b)

那么a和b各运行一次用例

@data([a,d],[c,d])

如果没有@unpack，那么[a,b]当成一个参数传入用例运行

如果有@unpack，那么[a,b]被分解开，按照用例中的两个参数传递

image.png

六. requests模块

requests是python实现的简单易用的HTTP库，使用起来比urllib简洁很多

因为是第三方库，所以使用前需要cmd安装

pip install requests

安装完成后import一下，正常则说明可以开始使用了。

基本用法：

requests.get()用于请求目标网站，类型是一个HTTPresponse类型

import requests

response = requests.get('http://www.baidu.com')
print(response.status_code)  # 打印状态码
print(response.url)          # 打印请求url
print(response.headers)      # 打印头信息
print(response.cookies)      # 打印cookie信息
print(response.text)  #以文本形式打印网页源码
print(response.content) #以字节流形式打印

七. xlrd模块

1. xlrd是读取excel表格数据；

2. 支持 xlsx和xls格式的excel表格；

3. 三方模块安装方式：pip3 install xlrd；

4. 模块导入方式：import xlrd

基础用法

# 文件名以及路径，如果路径或者文件名有中文给前面加一个r表示原生字符。
workbook = xlrd.open_workbook(filename)

# 通过名称获取
sheet = workbook.sheet_by_name('open_live')

# 1. 返回book中所有工作表的名字
names = workbook.sheet_names()
print(f'1. 返回book中所有工作表的名字: {names}')

# 2. 获取该sheet中的有效行数
nrows = sheet.nrows
print(f'2. 获取该sheet中的有效行数: {nrows}')

# 3. 读取前10行数据
excel_data = []
for i in range(10):
    # print(sheet.row(i))
    excel_data.append(sheet.row(i))

image.png

八. 测试用例设计

controller表：

1. 控制各个表单模块的执行

2. 各个表单执行的前置条件：包括账号、url、partner_id、partner_key等

   
   
   image.png

模块表

1. 主要完成该模块下测试用例的编写，控制单条用例是否执行，控制测试用例的关联参数等

   
   
   image.png

九. 难点介绍

1. 如何在test环境push完代码后就触发jenkins任务?

• 1. 这里主要介绍非匿名token访问gitlab的方式，匿名token可以直接使用jenkins任务中的token访问gitlab的钩子
• 2. gitlab中提供了回调的钩子，自动化测试需要提供一个接口来接收gitlab 的钩子回调，拿到开发提交代码后的信息，这个信息会通过我们通过的接口，由gitlba回调给我们，当我们判断是test环境的主版本仓库时，再调用jenkins-api来执行相应的自动化job
• 3. 结果收集：如何收集jenkins执行任务后的结果，并发送邮件：需要在服务端开一个crontab定时任务，每分钟去轮询调用jenkins-api询问当前任务是否执行完毕，并查询状态，如果收集到结果，就保存当前结果发送邮件并停止任务