专栏首页从零开始学自动化测试httprunner 2.x学习4-测试用例分层

httprunner 2.x学习4-测试用例分层

前言

httprunner 2.x版本最大的改进就是分层机制了,1.x的版本是线性设计的,每个用例都是独立的。 一个用例里面涉及到流程性的,我们测试修改个人信息是否修改成功,在yaml文件里面需写3个步骤:登录-修改个人信息-查询个人信息。 这样3个测试步骤,每个测试步骤写的test下。但是下个测试用例,重新写个yaml文件也需要遇到登录的话,这样登录的步骤就会重复去写,所以维护起来不方便。 httprunner 2.x版本开始引入分层机制,可以定义公共的方法,在用例里面直接引入步骤,这样登录方法我们只需写一次

分层机制

在自动化测试领域,自动化测试用例的可维护性是极其重要的因素,直接关系到自动化测试能否持续有效地在项目中开展。

概括来说,测试用例分层机制的核心是将接口定义、测试步骤、测试用例、测试场景进行分离,单独进行描述和维护,从而尽可能地减少自动化测试用例的维护成本。

逻辑关系图如下所示:

同时,强调如下几点核心概念:

  • 测试用例(testcase)应该是完整且独立的,每条测试用例应该是都可以独立运行的
  • 测试用例是测试步骤(teststep)的 有序 集合,每一个测试步骤对应一个 API 的请求描述
  • 测试用例集(testsuite)是测试用例的 无序 集合,集合中的测试用例应该都是相互独立,不存在先后依赖关系的; 如果确实存在先后依赖关系,那就需要在测试用例中完成依赖的处理

如果对于上述第三点感觉难以理解,不妨看下上图中的示例:

  • testcase1 依赖于 testcase2,那么就可以在测试步骤(teststep12)中对 testcase2 进行引用,然后 testcase1 就是完整且可独立运行的;
  • 在 testsuite 中,testcase1 与 testcase2 相互独立,运行顺序就不再有先后依赖关系了。

分层描述详解

理解了测试用例分层模型,接下来我们再来看下在分层模型下,接口、测试用例、测试用例集的描述形式。

为了更好地对接口描述进行管理,推荐使用独立的文件对接口描述进行存储,即每个文件对应一个接口描述。

接口定义描述的主要内容包括:name、variables、request、base_url、validate 等,形式如下:

# api/get_header.yml
name: get headers
base_url: http://httpbin.org
variables:
    expected_status_code: 200
request:
    url: /headers
    method: GET
validate:
    - eq: ["status_code", $expected_status_code]
    - eq: [content.headers.Host, "httpbin.org"]

其中,name 和 request 部分是必须的,request 中的描述形式与 requests.request 完全相同。 另外,API 描述需要尽量保持完整,做到可以单独运行。如果在接口描述中存在变量引用的情况,可在 variables 中对参数进行定义。 通过这种方式,可以很好地实现单个接口的调试。

(venv_hrun) D:\soft\venu_hrun>hrun api/get_header.yml
INFO     HttpRunner version: 2.5.7
INFO     Start to run testcase: get headers
get headers
INFO     GET http://httpbin.org/headers
INFO     status_code: 200, response_time(ms): 594.7 ms, response_length: 225 bytes

.

----------------------------------------------------------------------
Ran 1 test in 0.597s

OK
INFO     Start to render Html report ...
INFO     Generated Html report: D:\soft\venu_hrun\reports\20200612T144524.746202.html

OK

api层

接下来把登录写到api,测试用例去引用登录api,在项目根目录新建一个api目录,写login.yml文件内容

# 上海-悠悠,httprunner QQ交流群:1121184576
name: login first
base_url: http://127.0.0.1:8000
variables:
    user: test
    password: 123456
request:
        url: /api/v1/login/
        method: POST
        headers:
            Content-Type: application/json
            User-Agent: python-requests/2.18.4
        json:
            username: $user
            password: $password
validate:
    - eq: [status_code, 200]
    - eq: [headers.Content-Type, application/json]
    - eq: [content.msg, login success!]
    - eq: [content.code, 0]

我们要保证单个接口是可以执行的

hrun api/login.yml

运行结果

(venv_hrun) D:\soft\venu_hrun>hrun api/login.yml
INFO     HttpRunner version: 2.5.7
INFO     Start to run testcase: login first
login first
INFO     POST http://127.0.0.1:8000/api/v1/login/
INFO     status_code: 200, response_time(ms): 179.66 ms, response_length: 109 bytes

.

----------------------------------------------------------------------
Ran 1 test in 0.183s

OK
INFO     Start to render Html report ...
INFO     Generated Html report: D:\soft\venu_hrun\reports\20200612T151122.418051.html

接下来把获取个人信息的接口也写到api层,get_userinfo.yml内容 token 这个参数是可变的,每次登录都会生成一个新的值,这里为了调试的通,可以先登录后,把token复制过来

# 上海-悠悠,httprunner QQ交流群:1121184576
name: get user info case1
base_url: http://127.0.0.1:8000
variables:
    token: 1c5ef1856edec117ac989eb8def4abbaae28673e
request:
    url: /api/v1/userinfo/
    method: GET
    headers:
        Content-Type: application/json
        User-Agent: python-requests/2.18.4
        Authorization: Token $token          # 引用token

运行后结果

(venv_hrun) D:\soft\venu_hrun>hrun api/get_userinfo.yml
INFO     HttpRunner version: 2.5.7
INFO     Start to run testcase: get user info case1
get user info case1
INFO     GET http://127.0.0.1:8000/api/v1/userinfo/
INFO     status_code: 200, response_time(ms): 209.11 ms, response_length: 126 bytes

.

----------------------------------------------------------------------
Ran 1 test in 0.211s

OK
INFO     Start to render Html report ...
INFO     Generated Html report: D:\soft\venu_hrun\reports\20200612T151456.300635.html

用例层

用例层在项目根目录下新建一个case目录,专注测试用例的流程,如测试用例流程:登录-获取个人信息 整体设计思路:

  • step1 先引用api api/login.yml 用变量get_token提取登录的token
  • step2 在 variables 中定义 token 的值,这里会覆盖全面 api/get_userinfo.yml 中的 token 值
# 上海-悠悠,httprunner QQ交流群:1121184576
- config:
    name: "test userinfo"

- test:
    name: login-setup
    api: api/login.yml
    extract:
        - get_token: content.token
    validate:
        - eq: ["status_code", 200]
        - len_eq: ["content.token", 40]

- test:
   name: get user info case1
   api: api/get_userinfo.yml
   variables:
      token: $get_token
   validate:
        - eq: [status_code, 200]
        - eq: [headers.Content-Type, application/json]
        - eq: [content.data.0.age, 24]
        - eq: [content.data.0.name, test]
        - eq: [content.data.0.mail, xxx@qq.com]

运行结果

(venv_hrun) D:\soft\venu_hrun>hrun case
INFO     HttpRunner version: 2.5.7
INFO     Start to run testcase: test userinfo
login-setup
INFO     POST http://127.0.0.1:8000/api/v1/login/
INFO     status_code: 200, response_time(ms): 165.57 ms, response_length: 109 bytes

.
get user info case1
INFO     GET http://127.0.0.1:8000/api/v1/userinfo/
INFO     status_code: 200, response_time(ms): 187.49 ms, response_length: 126 bytes

.

----------------------------------------------------------------------
Ran 2 tests in 0.360s

OK
INFO     Start to render Html report ...
INFO     Generated Html report: D:\soft\venu_hrun\reports\20200612T151840.103147.html

层级结构

推荐的方式汇总如下:

  • debugtalk.py 放置在项目根目录下,假设为 PRJ_ROOT_DIR
  • .env 放置在项目根目录下,路径为 PRJ_ROOT_DIR/.env
  • 接口定义(API)放置在 PRJ_ROOT_DIR/api/ 目录下
  • 测试用例(testcase)放置在 PRJ_ROOT_DIR/testcases/ 目录下
  • 测试用例集(testsuite)文件必须放置在 PRJ_ROOT_DIR/testsuites/ 目录下
  • data 文件夹: 存储参数化文件,或者项目依赖的文件,路径为 PRJ_ROOT_DIR/data/
  • reports 文件夹: 存储HTML 测试报告,生成路径为 PRJ_ROOT_DIR/reports/

目录结构如下所示:

tests
├── .env
├── data
│   ├── app_version.csv
│   └── account.csv
├── api
│   ├── create_user.yml
│   ├── get_headers.yml
│   ├── get_userinfo.yml
│   └── login.yml
├── debugtalk.py
├── testcases
│   ├── test_userinfo.yml
│   ├── deps
│   │   └── check_and_create.yml
│   └── setup.yml
└── testsuites
    ├── create_users.yml
    └── create_users_with_parameters.yml

本文分享自微信公众号 - 从零开始学自动化测试(yoyoketang),作者:上海悠悠

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-06-13

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • httprunner学习14-完整的项目结构设计

    一个完整的接口自动化测试项目到底该如何设计?httprunner框架的知识点其实并不多,前面基本上把一些重要的概念都介绍完了。 本篇就是一个总结性的,可以用于实...

    上海-悠悠
  • httprunner学习4-variables变量声明与引用

    在 HttpRunner 中,支持变量声明(variables)和引用($var)的机制。在 config 和 test 中均可以通过 variables 关键...

    上海-悠悠
  • Selenium+python自动化82-只截某个元素的图

    前言 selenium截取全图小伙伴们都知道,曾经去面试的时候,面试官问:如何截图某个元素的图?不要全部的,只要某个元素。。。小编一下子傻眼了, 苦心人,天不负...

    上海-悠悠
  • ubuntu16 CUDA 编译opencl caffe版本并通过mnist训练测试

    一般来说,大家谈到caffe,都是基于CUDA在的NVIDIA显卡上运行的版本,其实有一个支持opencl的分支版本OpenCL Caffe。理论上这个版本的c...

    用户1148648
  • [Java 进阶]Java中的国际化

    背景知识 现代软件开发,往往做出的应用程序不止给一个国家的人去使用。不同国家的人往往存在语言文字不通的问题。由此产生了国际化(internationalizat...

    静默虚空
  • 用于.NET的可移植HTTP客户端

    直到最近,关于在.NET、Silverlight、Windows Phone和Windows Store之间分享代码的问题之一,依旧是缺少发起HTTP请求的能力...

    张善友
  • 读取txt正则匹配行写入txt

    跟着阿笨一起玩NET
  • Dubbo里面线程池的拒绝策略

    luozhiyun
  • GitHub 上有什么好玩的项目?

    上个月有水友私信问我,GitHub 上有没有比较好玩的项目可以推荐?我跟他说:"有,过两天我整理一下"。

    AI算法与图像处理
  • GitHub 上有什么好玩的项目?

    上个月有水友私信问我,GitHub 上有没有比较好玩的项目可以推荐?我跟他说:"有,过两天我整理一下"。

    灵魂画师牧码

扫码关注云+社区

领取腾讯云代金券