Httprunner V3.x接口自动化测试

已于 2023-11-22 17:30:55 修改
阅读量86 收藏
点赞数
分类专栏： 自动化测试 文章标签： 测试工具 python
于 2023-11-22 17:22:38 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_45444679/article/details/134558196
版权

介绍

HttpRunner 是一款面向 HTTP(S) 协议的通用测试框架，只需编写维护一份 YAML/JSON 脚本，即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。

特点

  • 继承了Requests的全部特性，可轻松实现 HTTP(S) 的各种测试需求
  • 使用YAML或JSON格式定义测试用例，并使用Pytest以简洁优雅的方式运行用例
  • 支持使用HAR实现接口录制并生成测试用例
  • 支持variables/ extract/ validate/hooks机制，以应对非常复杂的测试场景
  • 使用debugtalk.py插件自定义函数，可以在测试用例的任何部分调用
  • 使用Jmespath，更加方便对返回的json进行校验
  • 通过Pytest的强大插件生态补充了httprunner的功能
  • 使用Allure，让测试报告更加美观，可读性更强
  • 通过与locust的结合，可以很方便利用httprunner进行接口性能测试
  • 支持CLI命令，更可与持续集成工具(CI/CD)完美结合，如Jenkins

安装

本文使用的环境为python3.7+httprunner3.1.4

pip install  httprunner==3.1.4

查看版本

httprunner -V # hrun -V 
3.1.4

可能出现的错误和解决办法

pip install  markupsafe==2.0.1 pydantic==1.8.2 click==8.0.2

# 1.ImportError: cannot import name 'soft_unicode' from 'markupsafe'
pip install markupsafe==2.0.1
# 2. parameters的参数化数据 每次只运行第一组的参数化数据
pip install pydantic==1.8.2
# 3.ImportError: cannot import name ‘_unicodefun’ from ‘click’
pip install  click==8.0.2

创建项目

httprunner startproject httprunner_demo

用pycharm打开项目,创建目录api,data,testsuites,创建文件main.py.

文件夹及作用

  • api 存放接口定义yml文件
  • data 存放测试数据
  • har 存放har文件，使用抓包工具导出
  • reports 存放测试报告
  • testcases 存放测试用例yml文件
  • testsuites 存放测试套件yml文件
  • .env 存放环境变量，如base_url
  • debugtalk.py 写python脚本，在yml文件中调用

api接口

本文使用flask定义测试接口，用flasgger生成swagger接口文档，创建api_server.py文件。

安装环境：

pip install flask Flask-JWT-Extended
pip install flasgger
# 5000端口被占用时
netstat -ano | find "5000"
taskkill /f /im port

运行api_server,访问 http://localhost:5000/apidocs/

import os

from flask import Flask, request, jsonify
from flask_jwt_extended import JWTManager, create_access_token, jwt_required, get_jwt_identity
from flasgger import Swagger, swag_from
from werkzeug.utils import secure_filename

app = Flask(__name__)
swagger = Swagger(app)

app.config['JWT_SECRET_KEY'] = '123456'  # 在实际应用中请更改为安全的密钥
jwt = JWTManager(app)

UPLOAD_FOLDER = 'uploads'
ALLOWED_EXTENSIONS = {'jpg', 'jpeg', 'png', 'gif'}
app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER

# 用户信息存储，模拟数据库
users = {
    'test@qq.com': {'password': '123456', 'name': 'test'}
}


def allowed_file(filename):
    return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS


@app.route('/login', methods=['POST'])
def login():
    """
    User Login
    ---
    parameters:
      - name: email
        in: formData
        type: string
        required: true
        description: The user's email address
      - name: password
        in: formData
        type: string
        required: true
        description: The user's password
    responses:
      200:
        description: Login successful
      401:
        description: Invalid credentials
    """
    data = request.form
    email = data.get('email')
    password = data.get('password')

    if email in users and users[email]['password'] == password:
        # Create an access token
        access_token = create_access_token(identity=email)
        return jsonify(
            {'code': 200, 'data': {'access_token': access_token, 'message': 'Login successful'}, 'message': 'success'})
    else:
        return jsonify({'code': 401, 'data': {}, 'message': 'Invalid credentials'})


@app.route('/change_name', methods=['POST'])
@jwt_required()
@swag_from({
    'security': [{'JWT': []}],
    'parameters': [
        {
            'name': 'Authorization',
            'in': 'header',
            'type': 'string',
            'required': True,
            'default': 'Bearer ',
            'description': 'JWT Authorization header',
        },
        {
            'name': 'new_name',
            'in': 'formData',
            'type': 'string',
            'required': True,
            'description': 'The new name for the user',
        },
    ],
    'responses': {
        200: {'description': 'Name changed successfully'},
        401: {'description': 'Unauthorized'},
        404: {'description': 'User not found'},
    }
})
def change_name():
    current_user = get_jwt_identity()
    data = request.form
    new_name = data.get('new_name')

    if current_user in users:
        users[current_user]['name'] = new_name
        return jsonify({'code': 200, 'data': {'message': 'Name changed successfully'}, 'message': 'success'})
    else:
        return jsonify({'code': 404, 'data': {}, 'message': 'User not found'})


@app.route('/upload_file', methods=['POST'])
@jwt_required()
def upload_file():
    """
    Upload User File
    ---
    security:
      - JWT: []
    parameters:
      - name: Authorization
        in: header
        type: string
        required: true
        default: 'Bearer '
        description: JWT Authorization header
      - name: file
        in: formData
        type: file
        required: true
        description: The file to upload
    responses:
      200:
        description: File uploaded successfully
      400:
        description: No file provided or invalid file format
      401:
        description: Unauthorized
      404:
        description: User not found
    """
    current_user = get_jwt_identity()

    if 'file' not in request.files:
        return jsonify({'code': 400, 'data': {}, 'message': 'No file provided'})

    file = request.files['file']

    if file.filename == '':
        return jsonify({'code': 400, 'data': {}, 'message': 'No file provided'})

    if file and allowed_file(file.filename):
        if current_user in users:
            # Save the uploaded file
            filename = secure_filename(file.filename)
            file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename))

            # You can perform additional processing here (e.g., save file path to user profile)

            return jsonify({'code': 200, 'data': {'message': 'File uploaded successfully', 'filename': filename},
                            'message': 'success'})
        else:
            return jsonify({'code': 404, 'data': {}, 'message': 'User not found'})
    else:
        return jsonify({'code': 400, 'data': {}, 'message': 'No file provided or invalid file format'})


if __name__ == '__main__':
    app.run(debug=True, port=5000, load_dotenv=False)

接口定义yml文件

  1. 使用网页或postman发送登录请求
  2. 使用抓包工具fiddler或charles导出har文件(v1.1)存放har目录
  3. 使用命令har2case -2y har/login.har 转化成yml文件，存放api目录
  4. 修改login.yml，将teststeps的所有的变量存放config
  5. 在.env文件中添加base_url=http://127.0.0.1:5000
config:
  name: testcase description
  variables:
    email: test@qq.com
    password: '123456'
  verify: false
  base_url: ${ENV(base_url)}
teststeps:
  - name: /login
    request:
      data:
        email: $email
        password: $password
      headers:
        Accept-Encoding: gzip, deflate, br
        Accept-Language: zh-CN,zh;q=0.9
        Connection: keep-alive
        Content-Length: '35'
        Content-Type: application/x-www-form-urlencoded
        Host: 127.0.0.1:5000
        Origin: http://127.0.0.1:5000
        Referer: http://127.0.0.1:5000/apidocs/
        Sec-Fetch-Dest: empty
        Sec-Fetch-Mode: cors
        Sec-Fetch-Site: same-origin
        User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
          (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36
        accept: application/json
        sec-ch-ua: '"Google Chrome";v="119", "Chromium";v="119", "Not?A_Brand";v="24"'
        sec-ch-ua-mobile: ?0
        sec-ch-ua-platform: '"Windows"'
      method: POST
      url: /login
    extract:
      - access_token: body.data.access_token
    validate:
      - eq:
          - status_code
          - 200
      - eq:
          - headers.Content-Type
          - application/json
      - eq:
          - body.code
          - 200
      - eq:
          - body.message
          - success
  1. 使用extract关键字提取access_token，用来接口关联
  2. 使用$变量名调用config下的全局变量,${ENV(变量名)}调用环境变量,${函数名()}调用debugtalk.py中定义的函数。

测试用例yml文件

login_case.yml,测试步骤里面调用api

config:
  name: testcase description
teststeps:
  - name: /login
    api: api/login.yml

在main.py文件添加，运行测试用例,生成测试报告

import os

if __name__ == '__main__':
    os.system('hrun testcases/login_case.yml --html=reports/report.html')
接口关联

通过extract关键字提取，export关键字导出

  1. 调用change_name接口，按照同样的方式生成change_name.yml
config:
  name: testcase description
  variables:
    authorization: ${get_authorization($access_token)}
    new_name: 'test123'
  verify: false
  base_url: ${ENV(base_url)}
teststeps:
  - name: /change_name
    request:
      data:
        new_name: $new_name
      headers:
        Accept-Encoding: gzip, deflate, br
        Accept-Language: zh-CN,zh;q=0.9
        Authorization: $authorization
        Connection: keep-alive
        Content-Length: '16'
        Content-Type: application/x-www-form-urlencoded
        Host: 127.0.0.1:5000
        Origin: http://127.0.0.1:5000
        Referer: http://127.0.0.1:5000/apidocs/
        Sec-Fetch-Dest: empty
        Sec-Fetch-Mode: cors
        Sec-Fetch-Site: same-origin
        User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
          (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36
        accept: application/json
        sec-ch-ua: '"Google Chrome";v="119", "Chromium";v="119", "Not?A_Brand";v="24"'
        sec-ch-ua-mobile: ?0
        sec-ch-ua-platform: '"Windows"'
      method: POST
      url: /change_name
    validate:
      - eq:
          - status_code
          - 200
      - eq:
          - headers.Content-Type
          - application/json
      - eq:
          - body.code
          - 200
      - eq:
          - body.message
          - success

在debugtalk.py中添加get_authorization

def get_authorization(access_token):
    return 'Bearer ' + access_token

测试用例chage_name_case.yml

config:
  name: testcase description
teststeps:
  - name: /login
    api: api/login.yml
    export:
      - access_token
  - name: /change_name
    api: api/change_name.yml

提取参数需要使用export导出，下一个步骤才能使用

数据驱动

使用parameters关键字，写在测试用例的config下

方式一

直接写到yaml文件，参数名用"-"连接

config:
  name: testcase description
  parameters:
    email-password-body_code:
      - [ "test@qq.com","123456",200 ]
      - [ "","123456",401 ]
      - [ "test@qq.com","",401 ]
teststeps:
  - name: /login
    api: api/login.yml

使用数据驱动需要修改对应api的断言,常用断言：eq，str_eq，contains

    validate:
      - eq:
          - status_code
          - 200
      - str_eq:
          - body.code
          - $body_code
方式二

使用csv文件

config:
  name: testcase description
  parameters:
    email-password-body_code: ${P(data/login_data.csv)}
teststeps:
  - name: /login
    api: api/login.yml

login_data.csv

email,password,body_code
"test@qq.com","123456",200
"","123456",401
"test@qq.com","",401
方式三

使用debugtalk.py文件，需要返回列表字典格式数据：

config:
  name: testcase description
  parameters:
    email-password-body_code: ${login_data()}
teststeps:
  - name: /login
    api: api/login.yml

login_data

def login_data():
    data = [
        {"email": "test@qq.com", "password": "123456", "body_code": 200},
        {"email": "", "password": "123456", "body_code": 401},
        {"email": "test@qq.com", "password": "", "body_code": 401}
    ]
    return data
文件上传

文件上传需要安装插件

pip install requests_toolbelt filetype
pip install "httprunner[upload]"

api，使用upload关键字上传，key名称为file,变量名尽量不要和key名一样，没有特殊符号等

config:
  name: testcase description
  variables:
    file_path: data/test.jpg
    authorization: ${get_authorization($access_token)}
  verify: false
teststeps:
  - name: /upload_file
    request:
      upload:
        file: $file_path
      headers:
        Authorization: $authorization
      method: POST
      url: http://127.0.0.1:5000/upload_file
    validate:
      - eq:
          - status_code
          - 200

case

config:
  name: testcase description
teststeps:
  - name: /login
    api: api/login.yml
    export:
      - access_token
  - name: /upload_file
    api: api/upload_file.yml
测试套件

运行指定测试用例集合，注意testcases

test_suite.yml

config:
  name: 测试套件
testcases:
  - name: /login
    testcase: testcases/login_case.yml
  - name: /change_name
    testcase: testcases/change_name_case.yml
  - name: /upload_file
    testcase: testcases/upload_file_case.yml

执行测试套件

os.system('hrun testsuites/test_suite.yml --html=reports/report.html')

Allure测试报告

  1. 下载allure压缩包，解压后将bin目录添加到系统环境变量path

    官网下载：https://github.com/allure-framework/allure2/releases

    验证 allure --version，装完需重启pycharm

  2. pip install allure-pytest

  3. 执行测试，生成allue报告

     os.system('hrun testsuites/test_suite.yml --alluredir=reports/temp --clean-alluredir')
 os.system('allure generate reports/temp -o reports/allure --clean')
funcdefmain
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
httprunner3.x 测试报告
一名小测试
03-29 1155
httprunner3.x版本的接入了pytest框架，所以可以使用pytest所又的插件；对比httprunner2.x的报告展示各有优缺点，个人觉得2.x的报告还是挺不错的，看起来也很舒服的。 测试报告生成： 首先就是html报告：这个插件貌似你在安装httprunner3.x版本时就已经默认安装了，可以直接理解成内置html报告，如果显示没有安装，使用命令安装即可： (venv) F:\VSCODETESTING\demo> pip install pytest-html ...
HttpRunner 3.x接口自动化: 全面讲解如何落地实战
seanyang_的博客
02-18 693
以后会搞个小小的专题，专门分析一下市面上的用例录制，转换，回放等工具的用法及对比，敬请期待。本次依旧使用pity作为我们的测试网站，建议优先本地部署，方便调试以及后续的各种练习。下面对上面的参数化方式进行举例，验证（为了讲解方便，未使用环境变量的参数化方式）。【注】step-步骤，parameter-参数，valuables-全局定义的。成功的将用例中的项目由aaa修改为bbb，说明我们的hook调用成功了。关于用例套件也涉及到变量的问题，此处只给出结论，以后再讲吧，写不动了。
httprunner3.x hook机制
一名小测试
03-26 981
接口自动化测试中，难免会出现前置条件和后置条件的处理问题，unittest框架中使用最多的是setUp() 、tearDown() ；pytest中使用最多的是在夹层 conftest.py 文件中定义函数加@pytest.fixture()装饰器来处理；而httprunner中使用的是hook机制来处理前置后置。 在 .py文件的测试步骤的 teststeps中新增关键字 setup_hook 和 teardown_hook： import pytest from httprunn...
httprunner3.x安装及运行
一名小测试
03-23 1528
– httprunner是一个开源框架，只需编写维护一份 YAML/JSON 脚本，从1.x到现在的3.x也在不断地优化更新，3.x版本继续继承优秀的request库并增加了pytest框架、allure报告、locust性能等，集接口、性能、自动化测试为一体的多种需求测试，当然也肯定是支持持续集成的。 安装httprunner： pip3 install httprunner 更新httprunner： pip3 install -U httprunner 检查安装版本命令： httprunne
2022软件测试技能 httprunner 接口自动化测试实战
xmfboss.科技
07-16 565
2022软件测试技能 httprunner 接口自动化测试实战
MeterSphere-v3.x.zip
05-27
遵循 GPL v3 开源许可协议，涵盖测试跟踪、接口测试、UI 测试和性能测试等功能，全面兼容 JMeter、Selenium 等主流开源标准，有效助力开发和测试团队充分利用云弹性进行高度可扩展的自动化测试，加速高质量的软件...
基于VUE3 vue test utils的前端自动化测试项目
03-23
在本文中，我们将深入探讨如何基于Vue3和Vue Test Utils构建一个前端自动化测试项目，以及相关的知识点。Vue3是Vue.js框架的最新版本，它带来了许多优化和改进，包括更简洁的API、Composition API和更好的性能。Vue ...
milvus接口测试V3-20231206.json
12-29
milvus接口测试V3-20231206.json
ArcGIS API for JavaScript v3.x与v4.x最新版本api与sdk开发包资源下载
06-08
提供ArcGIS API for JavaScript v3.x与v4.x最新的api与sdk开发包资源下载，2021.06.08最新版本为v3.36及v4.19，分享文件包含以往旧的资源包，因CSDN上传限制，现将资源包整合至天翼云（下载不会限速），以后将在天翼...
vitest 单元测试应用与配置
qq_43474235的博客
07-12 1010
jsdom 是一个在 Node.js 环境中使用的纯 JavaScript 实现的 DOM（文档对象模型），它模拟了足够多的浏览器环境，使得你能够在服务器端（如 Node.js 应用程序）中运行那些原本只能在浏览器中运行的脚本。Vitest的配置可以通过多种方式实现，包括在package.json中直接配置，或者创建一个专门的配置文件（如vitest.config.ts或vitest.config.js）。在你的Vue项目中，你可以为组件、函数、工具等编写测试。你可以根据项目的具体需求来配置这些选项。
MVC之 IHttpModule管道模型
u013400314的博客
07-12 201
【代码】MVC之 IHttpModule管道模型。
大白话之SpringMVC中的ModelAndView
qq_36634055的博客
07-12 251
就像是你吃东西的地方，它决定了数据（Model）将以什么样的形式展现给用户。这可能是一个HTML页面，一个JSON响应，或者甚至是一张图片。是一个非常关键的类，它用于封装控制器(Controller)方法执行后的两个重要输出：模型数据(Model)和视图(View)。就像是服务员把厨房做好的食物送到指定的位置，这样顾客就可以享用美食了。在Web开发中，这就是如何将数据展示给用户的整个过程。就像是你要的食物，是你希望展示给用户的数据。比如，你可能想要在网页上显示一个用户的名字和他们的订单详情，这些都是。
【python+appium】自动化测试
2301_78843735的博客
07-11 1048
python+appium自动化测试系列就要告一段落了，本篇博客咱们做个小结。首先想要说明一下，APP自动化测试可能很多公司不用，但也是大部分自动化测试工程师、高级测试工程师岗位招聘信息上要求的，所以为了更好的待遇，我们还是需要花时间去掌握的，毕竟谁也不会跟钱过不去。接下来，一起总结一下APP UI自动化测试的思路吧。一，开发语言选择通常用于自动化测试的编程语言有：Python、Java、Javascript、Ruby、C#、PHP等。
【C++】使用gtest做单元测试框架写单元测试
Badme
07-12 121
【C++】使用gtest做单元测试框架写单元测试
单元测试有什么好处呢？
weixin_54503231的博客
07-12 291
在重构过程中，如果重构后的代码仍然能够通过单元测试，那么可以认为重构没有破坏软件的功能。通过运行测试套件，开发者可以快速确定哪些部分正常工作，哪些部分可能存在问题，从而缩小问题范围，减少调试时间。促进快速反馈：单元测试可以自动化执行，这意味着开发者可以在编写代码的同时或之后立即运行测试，快速获得反馈。通过查看单元测试，其他开发者可以了解代码的预期行为、边界条件和可能的异常情况。测试工作就是模拟真实环境，在代码正式上线前进行验证的工作，即使没有任何工具和方法，这项工作也能够通过人工操作来手动完成。
【整洁单元测试】测试气味Test Smells
最新发布
m0_68405758的博客
07-16 407
硬编码测试数据、剪切和粘贴、使用 "test "+方法名称（或 "test1"、"test2"、"test3"）作为测试名称，这些做法在短期内稍显简单，但却使测试库更难维护。这里还有一件事值得思考：自动化测试很好，因为你可以用很少的成本重复测试，但这也意味着随着时间的推移，它们的有效性会下降，因为你只是在重复测试完全相同的东西。你可以推断出一些，但想象一下，这只是测试运行中失败的几十个测试中的一个（在几千个测试的测试套件中完全有可能）。也就是说，当您阅读测试时，数据之间的关系应该是显而易见的。
单元测试实施最佳方案（背景、实施、覆盖率统计）
点滴汇聚，智在积累。——Danny
07-13 1146
单元测试是白盒测试的一种形式，它的目标是测试软件的最小单元——函数、方法或类。单元测试的主要目的是验证代码的正确性，以确保每个单元按照预期执行。单元测试通常由开发人员来写，通过单元测试，开发人员可以在代码开发阶段及早发现和修复错误，提高代码的质量和可维护性。 单元测试覆盖率只能代表你测试过哪些代码，不能代表你是否测试好这些代码！不能盲目追求代码覆盖率，而应该想办法设计更有效的案单测用例！
Spring Web MVC入门
2303_79064370的博客
07-11 1061
从标题我们就能看见一个很陌生的名词“”，这个名词听着很高大上，但它到底是啥呢？Spring Web MVC 是基于 Servlet API 构建的原始 Web 框架，从⼀开始就包含在 Spring 框架中。它的正式名称“Spring Web MVC”来⾃其源模块的名称(Spring-webmvc)，但它通常被称为 SpringMVCSpring Web MVC 是⼀个 Web 框架。
Spring MVC 中的文件上传 和 文件下载
weixin_61635597的博客
07-13 742
文件上传：form表单采用post请求，enctype是multipart/form-data，并且上传组件是：type=“file”上传文件时，文件起名采用UUID。以防文件覆盖。“在这个最后的篇章中，我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉，我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底，继续在其他的领域奋斗。
jmeter接口自动化测试
07-28
jmeter接口自动化测试是一种通过使用jmeter工具来执行接口测试的方法。通过jmeter，我们可以设计和执行接口测试用例，并将其集成到自动化测试流程中，从而实现自动化执行接口测试的目的。\[1\] 在进行jmeter接口...

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值