自动生成测试脚本方案浅析

原创玉婷沪江技术

文：玉婷

本文原创，转载请注明作者及出处

构想篇

作为一名接口自动化测试工程师，日常面临最多的工作就是编写接口自动化测试脚本，那么，在 coding 的过程中最让你觉得枯燥和乏味事情有哪些？

痛点

每次拿到新接口，我们要手动参照文档在脚本中生成一份接口类，参数越多花费时间越多
需求不同，但健壮性和部分业务用例重复性高
想重构脚本，接口数据和用例这块纯编写的工作量就会让人望而怯步

每天都要花上30%的时间去写那些不太需要思考的脚本，这真不够自动化！

解决方案

解析文档
梳理适合自动生成的脚本
通过工具生成这部分脚本

预期目标

解放双手，降低纯手力劳动占比，进而给自己提供更多的时间去思考、理解产品和设计更多“聪明”的用例

实践篇

自动化获取接口信息

分析接口自动化脚本结构和内容

自动化测试脚本结构图

筛选工作量大又有规律可循的脚本

此处规律不宜太过于复杂，可先选逻辑简单的部分，我们主要选取以下两部分

接口类，工作时间占比30%~50%，特点：结构特定、数据来源于其它平台

接口类结构图

用例部分，工作时间占比30%~50%,特点：重复度高于80%左右、生成逻辑可描述

用例结构图

解析接口文档

接口信息来源于接口文档，目前市场上比较主流的几个接口文档管理工具有Swagger、RAP、WIKI 或者其他普通文档工具。

下面以解析接口文件为目的分析比较下几款工具的区别：
.

分类	Swagger	RAP	WIKI
描述	用于生成、描述、调用和可视化RESTful风格的Web服务的框架	可视化接口管理工具	可供多人协同创作的超文本系统
格式	json	json	html
规范	各个参数、返回值的具体结构、类型有统一规范	同swagger	需要自己约定规范
成本	直接嵌入项目中，通过开发时编写注释，自动生成接口文档，成本较低	需要开发按照平台规则手动输入，成本较高	需要按照约定规范，手动输入，成本较高

如果有条件，大家可以根据开发成本和解析接口文件的难易程度来综合考虑，确定使用哪个平台管理接口

我们项目是 Swagger 和 WIKI 混合使用，由于日常测试看 WIKI 居多，因此早期采用 Python 爬虫利器 BeautifulSoup 来解析WIKI html页面

from bs4 import BeautifulSoup
soup = BeautifulSoup(html_doc)
title_string = soup.title.string
# 后面继续解析其他需要用到的接口内容

使用下来发现通过wiki来获取接口信息的一些弊端

完全靠人工来约束书写规则不靠谱
对于复杂的嵌套参数，稍有不按照规范来的，就会导致脚本解析错误，很大程度上造成了解析的难度
在html上准确的定位信息远比在json上难度大，兼容性差

于是，尝试解析Swagger返回的json来获得接口信息为后面生成脚本做准备

{
    "swagger": "2.0",
    "host": "xxx",
    "basePath": "/",
    "tags":[
        {"name":"xxx-controller","description":"xxx"},
        ...
    ],
    "paths": {
        "<接口地址1>": { ... },
        "<接口地址2>": { ... },
        ...
    },
    "definitions": {
        "<实体类1>": { ... },
        "<实体类2>": { ... },
        ...
    }
}

使用以下方式拿到json结果后，就可以直接按照处理字典的方式来获取需要的内容。

graph LR
json-->ApiObj

对于swagger.json的解析和代码生成官方也提供了一些可供使用的库swagger-codegen (java),由于编程语言的限制，我们使用了python自己解析

现在，我们已拿到生成代码所需要的信息

自动生成代码

代码生成工具

class CodeGeneratorBackend():
    def begin(self, tab="\t"):
        self.code = []
        self.tab = tab
        self.level = 0
    def end(self):
        # return string.join(self.code, "")
        return "".join(self.code)
    def write(self, string):
        self.code.append(self.tab * self.level + string)
    def indent(self):
        self.level = self.level + 1
    def dedent(self):
        if self.level == 0:
            raise SyntaxError("internal error in code generator")
        self.level = self.level - 1
"""调用方法,开始生成代码"""    
c = CodeGeneratorBackend()
c.begin(tab="    ")  # 定义缩进方式
c.write("def function(self):\n")
c.indent()  # 缩进
# 方法体
c.dedent()  # 回退上一次缩进