iis服务器助手广告广告
返回顶部
首页 > 资讯 > 后端开发 > Python >pytest接口自动化测试框架搭建的全过程
  • 849
分享到

pytest接口自动化测试框架搭建的全过程

2024-04-02 19:04:59 849人浏览 薄情痞子

Python 官方文档:入门教程 => 点击学习

摘要

目录一. 背景二. 基础环境三. 项目结构四、框架解析4.1 接口数据文件处理4.2 封装测试工具类4.3 测试用例代码编写4.4 测试用例运行生成报告 ​​​​​​​总结一. 背景

一. 背景

Pytest目前已经成为python自动化测试必学必备的一个框架,网上也有很多的文章讲述相关的知识。最近自己也抽时间梳理了一份pytest接口自动化测试框架,因此准备写文章记录一下,做到尽量简单通俗易懂,当然前提是基本的Python基础已经掌握了。如果能够对新学习这个框架的同学起到一些帮助,那就更好了~

二. 基础环境

语言:Python 3.8

编译器:PyCharm

基础:具备python编程基础

框架:pytest+requests+allure

三. 项目结构

项目结构图如下:

每一层具体的含义如下图:

测试报告如下图:

四、框架解析

4.1 接口数据文件处理

框架中使用草料二维码的get和post接口用于demo测试,比如:

get接口:https://cli.im/qrcode/getDefaultComponentMsg

返回值:{“code”:1,“msg”:"",“data”:{xxxxx}}

数据文件这里选择使用JSON格式,文件内容格式如下,test_Http_get_data.json:

{
  "dataitem": [
    {
      "id": "testget-1",
      "name": "草料二维码get接口1",
      "headers":{
        "Accept-Encoding":"gzip, deflate, br"
      },
      "url":"/qrcode/getDefaultComponentMsg",
      "method":"get",
      "expectdata": {
        "code": "1"
      }
    },


    {
      "id": "testget-2",
      "name": "草料二维码get接口2",
      "headers":{},
      "url":"/qrcode/getDefaultComponentMsg",
      "method":"get",
      "expectdata": {
        "code": "1"
      }
    }
  ]
}

表示dataitem下有两条case,每条case里面声明了id, name, header, url, method, expectdata。如果是post请求的话,case中会多一个parameters表示入参,如下:

{
    "id":"testpost-1",
    "name":"草料二维码post接口1",
    "url":"/apis/QrCode/saveStatic",
    "headers":{
        "Content-Type":"application/x-www-fORM-urlencoded",
        "Accept-Encoding":"gzip, deflate, br"
    },
    "parameters":{
        "info":11111,
        "content":11111,
        "level":"H",
        "size":500,
        "fGColor":"#000000",
        "bggcolor":"#FFFFFF",
        "transparent":"false",
        "type":"text",
        "codeimg":1
    },
    "expectdata":{
        "status":"1",
        "qrtype":"static"
    }
}

为了方便一套脚本用于不同的环境运行,不用换了环境后挨个儿去改数据文件,比如

测试环境URL为:https://testcli.im/qrcode/getDefaultComponentMsg

生产环境URL为:https://cli.im/qrcode/getDefaultComponentMsg

因此数据文件中url只填写后半段,不填域名。然后config》global_config.py下设置全局变量来定义域名:

# 配置HTTP接口的域名,方便一套脚本用于多套环境运行时,只需要改这里的全局配置就OK
CAOLIAO_HTTP_POST_HOST = "https://cli.im"
CAOLIAO_HTTP_GET_HOST = "https://nc.cli.im"

utils文件夹下,创建工具类文件:read_jsonfile_utils.py, 用于读取json文件内容:

import json
import os

class ReadJsonFileUtils:
    def __init__(self, file_name):
        self.file_name = file_name
        self.data = self.get_data()

    def get_data(self):
        fp = open(self.file_name,encoding='utf-8')
        data = json.load(fp)
        fp.close()
        return data

    def get_value(self, id):
        return self.data[id]

    @staticmethod
    def get_data_path(folder, fileName):
        BASE_PATH = os.path.dirname(os.path.dirname(os.path.realpath(__file__)))
        data_file_path = os.path.join(BASE_PATH, folder, fileName)
        return data_file_path

if __name__ == '__main__':
    opers = ReadJsonFileUtils("..\\resources\\test_http_post_data.json")
    #读取文件中的dataItem,是一个list列表,list列表中包含多个字典
    dataitem=opers.get_value('dataItem')
    print(dataitem)

运行结果如下:

4.2 封装测试工具类

utils文件夹下,除了上面提到的读取Json文件工具类:read_jsonfile_utils.py,还有封装request 请求的工具类:http_utils.py

excel文件中读取数据的工具类:get_excel_data_utils.py(虽然本次框架中暂时未采用存放接口数据到Excel中,但也写了个工具类,需要的时候可以用)

http_utils.py内容:

import requests
import json

class HttpUtils:
    @staticmethod
    def http_post(headers, url, parameters):
        print("接口请求url:" + url)
        print("接口请求headers:" + json.dumps(headers))
        print("接口请求parameters:" + json.dumps(parameters))
        res = requests.post(url, data=parameters, headers=headers)
        print("接口返回结果:"+res.text)
        if res.status_code != 200:
            raise Exception(u"请求异常")
        result = json.loads(res.text)
        return result

    @staticmethod
    def http_get(headers, url):
        req_headers = json.dumps(headers)
        print("接口请求url:" + url)
        print("接口请求headers:" + req_headers)
        res = requests.get(url, headers=headers)
        print("接口返回结果:" + res.text)
        if res.status_code != 200:
            raise Exception(u"请求异常")
        result = json.loads(res.text)
        return result

get_excel_data_utils.py内容:

import xlrd
from xlrd import xldate_as_tuple
import datetime

class ExcelData(object):
    '''
    xlrd中单元格的数据类型
    数字一律按浮点型输出,日期输出成一串小数,布尔型输出0或1,所以我们必须在程序中做判断处理转换
    成我们想要的数据类型
    0 empty,1 string, 2 number, 3 date, 4 boolean, 5 error
    '''
    def __init__(self, data_path, sheetname="Sheet1"):
        #定义一个属性接收文件路径
        self.data_path = data_path
        # 定义一个属性接收工作表名称
        self.sheetname = sheetname
        # 使用xlrd模块打开excel表读取数据
        self.data = xlrd.open_workbook(self.data_path)
        # 根据工作表的名称获取工作表中的内容
        self.table = self.data.sheet_by_name(self.sheetname)
        # 根据工作表的索引获取工作表的内容
        # self.table = self.data.sheet_by_name(0)
        # 获取第一行所有内容,如果括号中1就是第二行,这点跟列表索引类似
        self.keys = self.table.row_values(0)
        # 获取工作表的有效行数
        self.rowNum = self.table.nrows
        # 获取工作表的有效列数
        self.colNum = self.table.ncols

    # 定义一个读取excel表的方法
    def readExcel(self):
        # 定义一个空列表
        datas = []
        for i in range(1, self.rowNum):
            # 定义一个空字典
            sheet_data = {}
            for j in range(self.colNum):
                # 获取单元格数据类型
                c_type = self.table.cell(i,j).ctype
                # 获取单元格数据
                c_cell = self.table.cell_value(i, j)
                if c_type == 2 and c_cell % 1 == 0:  # 如果是整形
                    c_cell = int(c_cell)
                elif c_type == 3:
                    # 转成datetime对象
                    date = datetime.datetime(*xldate_as_tuple(c_cell, 0))
                    c_cell = date.strftime('%Y/%d/%m %H:%M:%S')
                elif c_type == 4:
                    c_cell = True if c_cell == 1 else False
                sheet_data[self.keys[j]] = c_cell
                # 循环每一个有效的单元格,将字段与值对应存储到字典中
                # 字典的key就是excel表中每列第一行的字段
                # sheet_data[self.keys[j]] = self.table.row_values(i)[j]
            # 再将字典追加到列表中
            datas.append(sheet_data)
        # 返回从excel中获取到的数据:以列表存字典的形式返回
        return datas

if __name__ == "__main__":
    data_path = "..\\resources\\test_http_data.xls"
    sheetname = "Sheet1"
    get_data = ExcelData(data_path, sheetname)
    datas = get_data.readExcel()
    print(datas)

4.3 测试用例代码编写

testcases文件夹下编写测试用例:

test_caoliao_http_get_interface.py内容:

import logging
import allure

import pytest
from utils.http_utils import HttpUtils
from utils.read_jsonfile_utils import ReadJsonFileUtils
from config.global_config import CAOLIAO_HTTP_GET_HOST

@pytest.mark.httptest
@allure.feature("草料二维码get请求测试")
class TestHttpInterface:
    # 获取文件相对路径
    data_file_path = ReadJsonFileUtils.get_data_path("resources", "test_http_get_data.json")
    # 读取测试数据文件
    param_data = ReadJsonFileUtils(data_file_path)
    data_item = param_data.get_value('dataItem')  # 是一个list列表,list列表中包含多个字典

    """
    @pytest.mark.parametrize是数据驱动;
    data_item列表中有几个字典,就运行几次case
    ids是用于自定义用例的名称
    """
    
    @pytest.mark.parametrize("args", data_item, ids=['测试草料二维码get接口1', '测试草料二维码get接口2'])
    def test_caoliao_get_demo(self, args, login_test):
        # 打印用例ID和名称到报告中显示
        print("用例ID:{}".format(args['id']))
        print("用例名称:{}".format(args['name']))
        print("测试conftest传值:{}".format(login_test))
        logging.info("测试开始啦~~~~~~~")
        res = HttpUtils.http_get(args['headers'], CAOLIAO_HTTP_GET_HOST+args['url'])
        # assert断言,判断接口是否返回期望的结果数据
        assert str(res.get('code')) == str(args['expectdata']['code']), "接口返回status值不等于预期"

test_caoliao_http_post_interface.py内容:

import pytest
import logging
import allure
from utils.http_utils import HttpUtils
from utils.read_jsonfile_utils import ReadJsonFileUtils
from config.global_config import CAOLIAO_HTTP_POST_HOST

# pytest.ini文件中要添加markers = httptest,不然会有warning,说这个Mark有问题
@pytest.mark.httptest
@allure.feature("草料二维码post请求测试")
class TestHttpInterface:
    # 获取文件相对路径
    data_file_path = ReadJsonFileUtils.get_data_path("resources", "test_http_post_data.json")
    # 读取测试数据文件
    param_data = ReadJsonFileUtils(data_file_path)
    data_item = param_data.get_value('dataItem') #是一个list列表,list列表中包含多个字典

    """
    @pytest.mark.parametrize是数据驱动;
    data_item列表中有几个字典,就运行几次case
    ids是用于自定义用例的名称
    
    """
    @pytest.mark.parametrize("args", data_item, ids=['测试草料二维码post接口1','测试草料二维码post接口2'])
    def test_caoliao_post_demo(self, args):
        # 打印用例ID和名称到报告中显示
        print("用例ID:{}".format(args['id']))
        print("用例名称:{}".format(args['name']))
        logging.info("测试开始啦~~~~~~~")
        res = HttpUtils.http_post(args['headers'], CAOLIAO_HTTP_POST_HOST+args['url'], args['parameters'])
        # assert断言,判断接口是否返回期望的结果数据
        assert str(res.get('status')) == str(args['expectdata']['status']), "接口返回status值不等于预期"
        assert str(res.get('data').get('qrtype')) == str(args['expectdata']['qrtype']), "接口返回qrtype值不等于预期"

企业中的系统接口,通常都有认证,需要先登录获取token,后续接口调用时都需要认证token。因此框架需要能处理在运行用例前置和后置做一些动作,所以这里用到了conftest.py文件,内容如下:

import logging
import traceback

import pytest
import requests

"""
如果用例执行前需要先登录获取token值,就要用到conftest.py文件了
作用:conftest.py 配置里可以实现数据共享,不需要import导入 conftest.py,pytest用例会自动查找
scope参数为session,那么所有的测试文件执行前执行一次
scope参数为module,那么每一个测试文件执行前都会执行一次conftest文件中的fixture
scope参数为class,那么每一个测试文件中的测试类执行前都会执行一次conftest文件中的fixture
scope参数为function,那么所有文件的测试用例执行前都会执行一次conftest文件中的fixture
"""

# 获取到登录请求返回的ticket值,@pytest.fixture装饰后,testcase文件中直接使用函数名"login_ticket"即可得到ticket值
@pytest.fixture(scope="session")
def login_ticket():
    header = {
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
    }
    params = {
        "loginId": "username",
        "pwd": "passWord",
    }
    url = 'http://testxxxxx.xx.com/doLogin'
    logging.info('开始调用登录接口:{}'.format(url))
    res = requests.post(url, data=params, headers=header, verify=False)  # verify:忽略https的认证
    try:
        ticket = res.headers['Set-Cookie']
    except Exception as ex:
        logging.error('登录失败!接口返回:{}'.format(res.text))
        traceback.print_tb(ex)
    logging.info('登录成功,ticket值为:{}'.format(ticket))
    return ticket


#测试一下conftest.py文件和fixture的作用
@pytest.fixture(scope="session")
def login_test():
    print("运行用例前先登录!")


    # 使用yield关键字实现后置操作,如果上面的前置操作要返回值,在yield后面加上要返回的值
    # 也就是yield既可以实现后置,又可以起到return返回值的作用
    yield "runBeforeTestCase"
    print("运行用例后退出登录!")

由于用例中用到了@pytest.mark.httptest给用例打标,因此需要创建pytest.ini文件,并在里面添加markers = httptest,不然会有warning,说这个Mark有问题。并且用例中用到的日志打印logging模板也需要在pytest.ini文件中增加日志配置。pytest.ini文件内容如下:

[pytest]
markers =
  httptest: run http interface test
  dubbotest: run dubbo interface test

log_cli = true
log_cli_level = INFO
log_cli_format = %(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s
log_cli_date_format=%Y-%m-%d %H:%M:%S
log_format = %(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)4s: %(message)s
log_date_format=%Y-%m-%d %H:%M:%S

4.4 测试用例运行生成报告 ​​​​​​​

运行方式:
Terminal窗口,进入到testcases目录下,执行命令:


运行某一条case:pytest test_caoliao_http_post_interface.py
运行所有case: pytest
运行指定标签的case:pytest -m httptest


运行并打印过程中的详细信息:pytest -s test_caoliao_http_post_interface.py
运行并生成pytest-html报告:pytest test_caoliao_http_post_interface.py --html=../testoutput/report.html
运行并生成allure测试报告:
1. 先清除掉testoutput/result文件夹下的所有文件
2. 运行case,生成allure文件:pytest --alluredir ../testoutput/result
3. 根据文件生成allure报告:allure generate ../testoutput/result/ -o ../testoutput/report/ --clean
4. 如果不是在pycharm中打开,而是直接到report目录下打开index.html文件打开的报告无法展示数据,需要双击generateAllureReport.bat生成allure报告;

pytest-html报告:

generateAllureReport.bat文件位置:

文件内容:

allure open report/

Allure报告:

框架中用到的一些细节知识点和问题,如:

conftest.py和@pytest.fixture()结合使用
pytest中使用logging打印日志
python中获取文件相对路径的方式
python虚拟环境
pytest框架下Allure的使用

我会在后续写文章再介绍。另外框架同样适用于dubbo接口的自动化测试,只需要添加python调用dubbo的工具类即可,后续也会写文章专门介绍。

总结

到此这篇关于pytest接口自动化测试框架搭建的文章就介绍到这了,更多相关pytest接口自动化测试内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: pytest接口自动化测试框架搭建的全过程

本文链接: https://www.lsjlt.com/news/119545.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
  • pytest接口自动化测试框架搭建的全过程
    目录一. 背景二. 基础环境三. 项目结构四、框架解析4.1 接口数据文件处理4.2 封装测试工具类4.3 测试用例代码编写4.4 测试用例运行生成报告 ​​​​​​​总结一. 背景...
    99+
    2024-04-02
  • Pytest接口自动化测试框架搭建模板
    auto_api_test 开发环境: Pycharm 开发语言&版本: python3.7.8 测试框架: Pytest、测试报告: Allure 项目源码Git地址 项...
    99+
    2024-04-02
  • Pytest接口自动化测试框架搭建模板的示例分析
    小编给大家分享一下Pytest接口自动化测试框架搭建模板的示例分析,相信大部分人都还不怎么了解,因此分享这篇文章给大家参考一下,希望大家阅读完这篇文章后大有收获,下面让我们一起去了解一下吧!auto_api_test开发环境: Pychar...
    99+
    2023-06-14
  • Pytest+Yaml+Excel 接口自动化测试框架的实现示例
    目录一、框架架构二、项目目录结构三、框架功能说明四、核心逻辑说明配置文件输出目录请求工具类代码编写case程序主入口执行记录一、框架架构 二、项目目录结构 三、框架功能说明 解决...
    99+
    2024-04-02
  • Pytest自动化测试框架的使用
    目录Pytest和Unittest测试框架的区别?Pytest 安装Pytest 示例标记固件(Fixture)预处理和后处理作用域自动执行参数化总结Pytest和Unittest测...
    99+
    2023-03-19
    Pytest 自动化测试框架 Pytest 自动化
  • 移动端自动化测试框架搭建
    搭建框架的几点思考: 需要框架实现什么功能 前期需要做数据与业务分离,方便维护 测试用例集管理要方便,便于异常时重新Run单条用例 用例设计需要尽可能简单,多提供公共方法     目前设计框架如下图:    CommonLibr...
    99+
    2023-01-30
    框架 测试
  • Appium+Python+pytest自动化测试框架的实战
    菜鸟一枚,写的不好勿喷,大家一起学习 先简单介绍一下目录,再贴一些代码,代码里有注释 Basic目录下写的是一些公共的方法,Data目录下写的是测试数据,image存的是测试失败...
    99+
    2024-04-02
  • Pytest自动化测试框架如何使用
    这篇文章主要讲解了“Pytest自动化测试框架如何使用”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“Pytest自动化测试框架如何使用”吧!Pytest和Unittest测试框架的区别?如何...
    99+
    2023-07-05
  • PHP接口自动化测试框架实现
    我们来看一个简单的PHP实现的超简单的接口。 ...//报名验证private function apply_verify() { $raid = $this->input->get_post('raid'); $mid = $...
    99+
    2023-09-21
    php android oracle 软件测试 程序人生
  • 自动化测试Pytest单元测试框架的基本介绍
    目录一、Pytest概念二、Pytest特点三、Pytest安装安装pytest命令:查看pytest版本:安装生成测试结果的HTML报告pytest-html四、Pycharm配置...
    99+
    2024-04-02
  • Pytest+request+Allure实现接口自动化框架
    目录前言:一、简单介绍二、代码结构与框架流程三、详细功能和使用说明四、Allure报告及Email五、后续优化前言: 接口自动化是指模拟程序接口层面的自动化,由于接口不易变更,维护成...
    99+
    2024-04-02
  • 从零搭建完整 Python 接口自动化测试框架—持续更新
    本接口自动化框架采用 python + unittest + request + openpyxl + myddt + pymysql 来实现接口自动化。  1、总体框架 2、单元测试框架 unittest unittest 是 Pyth...
    99+
    2023-09-01
    python 自动化
  • python接口自动化框架怎么搭建
    要搭建Python接口自动化框架,可以按照以下步骤进行: 确定需要使用的Python库:一般情况下,需要使用requests库来...
    99+
    2023-10-23
    python
  • python使用pytest接口自动化测试的使用
    简单的设计思路 利用pytest对一个接口进行各种场景测试并且断言验证 配置文件独立开来(conf文件),实现不同环境下只需要改环境配置即可 测试的场景读...
    99+
    2024-04-02
  • Python+Requests+PyTest+Excel+Allure 接口自动化测试实战
    Unittest是Python标准库中自带的单元测试框架,Unittest有时候也被称为PyUnit,就像JUnit是Java语言的标准单元测试框架一样,Unittest则是Pyth...
    99+
    2023-02-23
    Python Requests PyTest Excel Allure 接口自动化
  • 自动化测试框架pytest的Fixture固件怎么调用
    本篇内容介绍了“自动化测试框架pytest的Fixture固件怎么调用”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!什么是固件Fixture...
    99+
    2023-07-05
  • python+requests接口自动化测试框架实例详解教程
    摘要: python + requests实现的接口自动化框架详细教程 前段时间由于公司测试方向的转型,由原来的web页面功能测试转变成接口测试,之前大多都是手工进行,利用postman和jmeter进行的接口测试,后来,组内有人讲原先we...
    99+
    2023-09-29
    测试工具 pytest python 软件测试 经验分享
  • 使用Django+Pytest搭建在线自动化测试平台
    目录一、测试平台:二、搭建过程2.1 使用django搭建一个web系统2.2 搭建测试框架三、平台如何管理总结一、测试平台: 解决分散用例执行方式,提供统一测试用例执行过程、用例管...
    99+
    2024-04-02
  • python自动化测试框架pytest和unittest的区别是什么
    这篇文章给大家介绍python自动化测试框架pytest和unittest的区别是什么,内容非常详细,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。一、用例设计规则unittest(1)测试类必须继承unittest.TestCase...
    99+
    2023-06-02
  • 浅谈基于Pytest框架的自动化测试开发实践
    目录01 — Pytest核心功能02 — 创建测试项目03 — 编写测试用例04 — 执行测试用例05 — 数据与脚本分离06 — 参数化07 — 测试配置管理08 — 测试的准备...
    99+
    2024-04-02
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作