Pytest+request+Allure实现接口自动化框架

接口自动化是指模拟程序接口层面的自动化，由于接口不易变更，维护成本更小，所以深受各大公司的喜爱。
接口自动化包含2个部分，功能性的接口自动化测试和并发接口自动化测试。
本次文章着重介绍第一种，功能性的接口自动化框架。

一、环境介绍

环境：mac、python 3，pytest，allure，request

流程：读取yaml测试数据-生成测试用例-执行测试用例-生成allure报告

request.py 封装request方法，可以支持多协议扩展（get\post\put）
config.py读取配置文件，包括：不同环境的配置，email相关配置
log.py 封装记录log方法，分为：debug、info、warning、error、critical
email.py 封装smtplib方法，运行结果发送邮件通知
assert.py 封装assert方法
run.py 核心代码。定义并执行用例集，生成报告

yaml测试数据格式如下：

---
basic:
  dec: "基础设置"
  parameters:
    -
      url: /settings/basic.json
      data: slug=da1677475c27
      header: {
                 "user-agent": "mozilla/5.0 (macintosh; intel mac os x 10_13_6) applewebkit/537.36 (khtml, like gecko)\
                  chrome/67.0.3396.99 safari/537.36",
                 "content-type": "keep-alive"
              }

二、代码结构与框架流程

1、代码结构见下图：

2、框架流程见下图：

三、详细功能和使用说明

1、定义配置文件config.ini

该文件中区分测试环境[private_debug]和正式环境[online_release]分别定义相关配置项，[mail]部分为邮件相关配置项

# http接口测试框架配置信息
 
[private_debug]
# debug测试服务
tester = your name
environment = debug
versioncode = your version
host = www.jianshu.com
loginhost = /login
logininfo = email=wang@user.com&password=123456
 
[online_release]
# release正式服务
tester = your name
environment = release
versioncode = v1.0
host = www.jianshu.com
loginhost = /login
logininfo = email=wang@user.com&password=123456
 
[mail]
#发送邮件信息
smtpserver = smtp.163.com
sender = test1@163.com
receiver = wang@user.com
username = wang@user.com
password = 123456

2、读取yaml测试数据后封装

yaml测试数据例子见第一节，一条接口可定义多条case数据，get_parameter为已封装好的读取yaml数据方法，循环读取后将多条case数据存在list中。

class basic:
    params = get_parameter('basic')
    url = []
    data = []
    header = []
    for i in range(0, len(params)):
        url.append(params[i]['url'])
        data.append(params[i]['data'])
        header.append(params[i]['header'])

3、编写用例

class testbasic:
    @allure.feature('home')
    @allure.severity('blocker')
    @allure.story('basic')
    def test_basic_01(self, action):
        """
            用例描述：未登陆状态下查看基础设置
        """
        conf = config()
        data = basic()
        test = assert.assertions()
        request = request.request(action)
 
        host = conf.host_debug
        req_url = 'http://' + host
        urls = data.url
        params = data.data
        headers = data.header
 
        api_url = req_url + urls[0]
        response = request.get_request(api_url, params[0], headers[0])
 
        assert test.assert_code(response['code'], 401)
        assert test.assert_body(response['body'], 'error', u'继续操作前请注册或者登录.')
        assert test.assert_time(response['time_consuming'], 400)
        consts.result_list.append('true')

4、运行整个框架run.py

if __name__ == '__main__':
    # 定义测试集
    args = ['-s', '-q', '--alluredir', xml_report_path]
    self_args = sys.argv[1:]
    pytest.main(args)
    cmd = 'allure generate %s -o %s' % (xml_report_path, html_report_path)
 
    try:
        shell.invoke(cmd)
    except:
        log.error('执行用例失败，请检查环境配置')
        raise
 
    try:
        mail = email.sendmail()
        mail.sendmail()
    except:
        log.error('发送邮件失败，请检查邮件配置')
        raise