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

前言:

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

一、简单介绍

环境:Mac、Python 3,Pytest,Allure,Request

1

2

3

4

5

6

7

8

9

10

11

12

13

14

pytest==3.6.0

pytest-allure-adaptor==1.7.10(弃用)

pytest-rerunfailures==5.0

configparser==3.5.0

PyYAML==3.12

requests==2.18.4

simplejson==3.16.0

----------------------------------------

2020-4-30更新

pytest==5.3.1

allure-pytest==2.8.6

allure-python-commons==2.8.6

⚠️注:pytest-allure-adaptor已弃用,改为allure-pytest;

安装allure-pytest时,需将pytest-allure-adaptor卸载

流程:读取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测试数据格式如下:

1

2

3

4

5

6

7

8

9

10

11

12

---

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、代码结构见下图:

代码结构.jpg

2、框架流程见下图:

框架流程.jpg

三、详细功能和使用说明

1、定义配置文件config.ini

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

# 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中。

1

2

3

4

5

6

7

8

9

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、编写用例

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

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

5、err.log实例

[ERROR 2018-08-24 09:55:37]Response body != expected_msg, expected_msg is {"error":"继续操作前请注册或者登录9."}, body is {"error":"继续操作前请注册或者登录."}
[ERROR 2018-08-24 10:00:11]Response time > expected_time, expected_time is 400, time is 482.745
[ERROR 2018-08-25 21:49:41]statusCode error, expected_code is 208, statusCode is 200

6、Assert部分代码

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

def assert_body(self, body, body_msg, expected_msg):

    """

    验证response body中任意属性的值

    :param body:

    :param body_msg:

    :param expected_msg:

    :return:

    """

    try:

        msg = body[body_msg]

        assert msg == expected_msg

        return True

    except:

        self.log.error("Response body msg != expected_msg, expected_msg is %s, body_msg is %s" % (expected_msg, body_msg))

        Consts.RESULT_LIST.append('fail')

        raise

def assert_in_text(self, body, expected_msg):

    """

    验证response body中是否包含预期字符串

    :param body:

    :param expected_msg:

    :return:

    """

    try:

        text = json.dumps(body, ensure_ascii=False)

        # print(text)

        assert expected_msg in text

        return True

    except:

        self.log.error("Response body Does not contain expected_msg, expected_msg is %s" % expected_msg)

        Consts.RESULT_LIST.append('fail')

        raise

7、Request部分代码

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

def post_request(self, url, data, header):

    """

    Post请求

    :param url:

    :param data:

    :param header:

    :return:

    """

    if not url.startswith('http://'):

        url = '%s%s' % ('http://', url)

        print(url)

    try:

        if data is None:

            response = self.get_session.post(url=url, headers=header)

        else:

            response = self.get_session.post(url=url, params=data, headers=header)

    except requests.RequestException as e:

        print('%s%s' % ('RequestException url: ', url))

        print(e)

        return ()

    except Exception as e:

        print('%s%s' % ('Exception url: ', url))

        print(e)

        return ()

    # time_consuming为响应时间,单位为毫秒

    time_consuming = response.elapsed.microseconds/1000

    # time_total为响应时间,单位为秒

    time_total = response.elapsed.total_seconds()

    Common.Consts.STRESS_LIST.append(time_consuming)

    response_dicts = dict()

    response_dicts['code'] = response.status_code

    try:

        response_dicts['body'] = response.json()

    except Exception as e:

        print(e)

        response_dicts['body'] = ''

    response_dicts['text'] = response.text

    response_dicts['time_consuming'] = time_consuming

    response_dicts['time_total'] = time_total

    return response_dicts

四、Allure报告及Email

1、Allure报告总览,见下图:

Allure报告.jpg

2、Email见下图:

Email.jpg

五、后续优化

1、集成Jenkins,使用Jenkins插件生成Allure报告
2、多线程并发接口自动化测试
3、接口加密,参数加密

最后感谢每一个认真阅读我文章的人,看着粉丝一路的上涨和关注,礼尚往来总是要有的,虽然不是什么很值钱的东西,如果你用得到的话可以直接拿走! 希望能帮助到你!【100%无套路免费领取】

  • 27
    点赞
  • 30
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
好的,这里为您提供一个简单的pytest+allure+requests接口自动化框架搭建步骤: 1. 安装pytestallure ``` pip install pytest pip install allure-pytest ``` 2. 安装requests库 ``` pip install requests ``` 3. 创建测试用例文件和测试数据文件 在项目中创建一个tests文件夹,用于存放测试用例文件。在tests文件夹中创建一个test_api.py文件,用于编写测试用例。 同时,也需要在项目中创建一个data文件夹,用于存放测试数据文件。在data文件夹中创建一个api_data.json文件,用于存放接口测试数据。 4. 编写测试用例 在test_api.py文件中,使用pytest编写测试用例。可以使用requests库发送接口请求,并对返回结果进行断言。 示例代码: ```python import pytest import requests class TestAPI: @pytest.fixture(scope='session', autouse=True) def setup_class(self): self.base_url = 'https://api.github.com' def test_get_user(self): url = self.base_url + '/users/github' response = requests.get(url) assert response.status_code == 200 assert response.json()['login'] == 'github' def test_create_gist(self): url = self.base_url + '/gists' data = { "description": "test gist", "public": True, "files": { "test.txt": { "content": "Test gist content" } } } headers = { "Authorization": "token <your access token>" } response = requests.post(url, json=data, headers=headers) assert response.status_code == 201 ``` 5. 编写测试数据 在api_data.json文件中,编写接口测试用到的数据。可以对不同接口的测试数据进行分类,方便维护。 示例代码: ```json { "get_user": { "url": "/users/github", "method": "get", "headers": {}, "params": {}, "data": {}, "json": {}, "expected_status_code": 200, "expected_data": { "login": "github" } }, "create_gist": { "url": "/gists", "method": "post", "headers": { "Authorization": "token <your access token>" }, "params": {}, "data": { "description": "test gist", "public": true, "files": { "test.txt": { "content": "Test gist content" } } }, "json": {}, "expected_status_code": 201, "expected_data": {} } } ``` 6. 使用pytest执行测试用例 在项目根目录下打开终端,执行如下命令: ``` pytest --alluredir=./report ``` 该命令将会执行tests文件夹下的所有测试用例,并将测试结果保存在report文件夹中。 7. 生成测试报告 执行完测试用例后,使用如下命令生成测试报告: ``` allure generate ./report -o ./report/html --clean ``` 该命令将会在report文件夹下生成一个html文件夹,里面包含测试结果的详细信息和图表。 至此,一个简单的pytest+allure+requests接口自动化框架就搭建完成了。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值