专栏首页dongfangertep0.6.0更新聊聊pytest变量接口用例3个级别复用

tep0.6.0更新聊聊pytest变量接口用例3个级别复用

tep是一款测试工具,在pytest测试框架基础上集成了第三方包,提供项目脚手架,帮助以写Python代码方式,快速实现自动化项目落地。fixture是pytest核心技术,本文聊聊如何使用fixture完成变量、接口、用例3个级别复用。

技术原理

fixture是一种特殊函数,实现了依赖注入,pytest规定,只要在conftest.py模块中定义了fixture,作为参数传给测试函数test(fixture_name)就可以使用,无需import。tep在conftest.py上封装了一层fixtures,类似于Django初始化数据加载的fixtures,定义了env_vars环境变量,预置了登录接口等。整体思路如下图所示:

  • 实线:表示fixture流转,从tep.fixture预置fixture,到fixtures,到conftest.py,到tests
  • 虚线:表示动态变量流转,参考JMeter vars.put()vars.get(),实现用例级别复用。
  • 蓝色线:表示静态变量流转,参考JMeter自定义用户变量,实现变量级别复用。

tep.fixture

tep.fixture第一块内容是预置fixture的实现代码,如urlfaker_ch等,对使用者隐藏。第二块内容是类TepVar,预置了1个Python字典vars_和2个存取方法put()get(),划分了一块key-value形式存储区域。

fixtures

fixtures是一个包,里面包括多个fixture_*.py格式的Python模块,定义的全部都是fixture,只对外提供fixture,不提供function

自动注册

conftest.py是pytest的特殊文件,文件名固定,tep在其中实现了自动注册功能,它会自动查找fixtures目录下,所有以fixture_开头,以.py结尾的Python模块进行导入,无需手动添加。注册后,tests才能够找到fixtures中定义的fixture,否则报错fixture not found

tests

tests存放所有测试用例,tep建议每个Python模块中只定义1个test()函数,用例分离,独立运行。

参考了HttpRunner每个yaml文件1条用例的做法。复杂场景可以定义多个测试test()函数或Test类,pytest都支持。

使用示例

变量级别复用

函数局部变量

import jmespath
from loguru import logger

from tep.client import request


def test_post(faker_ch, url, login):
    # description
    logger.info("test post")
    # data
    fake = faker_ch
    # request
    response = request(
        "post",
        url=url("/api/users"),
        headers=login.jwt_headers,
        json={
            "name": fake.name()
        }
    )
    # assert
    assert response.status_code < 400
    # extract
    user_id = jmespath.search("id", response.json())

函数内部变量,作用域是整条测试用例,可以在多个接口之间进行复用,比如参数化和关联:

全局环境变量

#!/usr/bin/python
# encoding=utf-8

""" Can only be modified by the administrator. Only fixtures are provided.
"""

from tep.dao import mysql_engine
from tep.fixture import *


@pytest.fixture(scope="session")
def env_vars(config):
    class Clazz(TepVars):
        env = config["env"]

        """Variables define start"""
        # Environment and variables
        mapping = {
            "qa": {
                "domain": "https://qa.com",
                "mysql_engine": mysql_engine("127.0.0.1",  # host
                                             "2306",  # port
                                             "root",  # username
                                             "123456",  # password
                                             "qa"),  # db_name
            },
            "release": {
                "domain": "https://release.com",
                "mysql_engine": mysql_engine("127.0.0.1",
                                             "2306",
                                             "root",
                                             "123456",
                                             "release"),
            }
            # Add your environment and variables
        }
        # Define properties for auto display
        domain = mapping[env]["domain"]
        mysql_engine = mapping[env]["mysql_engine"]
        """Variables define end"""

    return Clazz()


@pytest.fixture
def project_level():
    pass

使用:

def test(env_vars, env_vars_your_name):
    print(env_vars.common_var)
    print(env_vars_your_name.my_var)

全局环境变量由fixtures提供:

核心数据是env_vars.Clazz类里面的mappingdomainmysql_engine等属性:

这么做的目的是为了在PyCharm中敲代码,输入.后能自动带出来,提高编码效率。

fixture_admin.py建议由管理员维护项目级别的公共变量,fixture_your_name.py由团队成员定义自己的环境变量,避免冲突。它们还有一个区别是fixture_admin.pyenv_vars继承了tep.fixture.TepVar,支持env_vars.put()env_vars.get()

变量都由fixture提供。

接口级别复用

tep预置登录接口fixture_login.py已经实现了接口级别复用,其他接口可以参照实现:

from tep.client import request
from tep.fixture import *


def _jwt_headers(token):
    return {"Content-Type": "application/json", "authorization": f"Bearer {token}"}


@pytest.fixture(scope="session")
def login(url):
    # Code your login
    logger.info("Administrator login")
    response = request(
        "post",
        url=url("/api/users/login"),
        headers={"Content-Type": "application/json"},
        json={
            "username": "admin",
            "password": "123456",
        }
    )
    assert response.status_code < 400
    response_token = jmespath.search("token", response.json())

    class Clazz:
        token = response_token
        jwt_headers = _jwt_headers(response_token)

    return Clazz

使用:

from loguru import logger


def test_login(login):
    logger.info(login.token)

用例级别复用

a_test.py,定义1条测试用例test_a(),使用faker_ch生成随机name,通过env_vars.put()方法写入TepVar.vars_中:

def test_a(faker_ch, env_vars):
    name = faker_ch.name()
    env_vars.put("name", name)

reuse_a_test.py,定义另外1条测试用例test()import test_a后手动调用执行,从TepVar.vars_中读取name

from tests.sample.case_reuse.a_test import test_a


def test(faker_ch, env_vars):
    test_a(faker_ch, env_vars)
    print(env_vars.get("name"))

注意test_a()函数参数引用的所有fixture,需要在test()函数参数中重新申明一遍,比如示例中的(faker_ch, env_vars)

tep是借助conftest.pyfixture,用类变量来做的,参考了JMeter BeanShell的vars

也可以外接redis

tep0.6.0更新

tep用户手册是根据0.5.3版本写的,现在更新了0.6.0版本,一是支持本文提到的3个级别复用,微调了fixtures,二是把项目脚手架代码尽量封装到tep中,减少后续升级成本。涉及到4个文件:conftest.pyfixture_admin.pyfixture_login.pyfixture_your_name.py

更新tep

pip install tep==0.6.0
  • 如果还没有用过tep,使用这条命令安装后,执行tep startproject project_name就可以创建0.6.0版本的项目脚手架,包含了预置代码结构和sample测试用例。
  • 如果已经安装了tep,也需要执行这条命令升级0.6.0版本。

老项目升级(可选)

老项目升级也很简单,先在项目根目录执行命令:

tep -U

它会自动替换conftest.py,考虑到老项目fixtures已经有真实数据了,这里给出了version0.6.0文件包,命令执行后在项目根目录生成:

把老项目的真实数据提取出来,手动替换一下就可以了:

小结

本文介绍了如何使用pytest测试框架实现变量、接口、用例3个级别复用,给出了在tep中的使用示例,然后提供了安装升级tep0.6.0的方法。这套思路借鉴了JMeterHttpRunner的部分设计思想,以及我使用过的接口测试平台经验,在pytest上实践了一下。tep只是测试工具,本质上还是写pytest,感兴趣可以试一下哦。

参考资料: 源码 https://github.com/dongfanger/tep

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

我来说两句

0 条评论
登录 后参与评论

相关文章

  • tep环境变量、fixtures、用例三者之间的关系

    tep是一款测试工具,在pytest测试框架基础上集成了第三方包,提供项目脚手架,帮助以写Python代码方式,快速实现自动化项目落地。

    dongfanger
  • pytest内核测试平台落地初体验

    测试平台,有人说它鸡肋,有人说它有用,有人说它轮子,众说纷纭,不如从自身出发,考虑是否要做测试平台:

    dongfanger
  • pytest封神之路第三步 精通fixture

    conftest.py中的fixture可以用在当前目录及其子目录,不需要import,pytest会自动找。

    dongfanger
  • 深度学习实战 mnist数据集预处理技术分析

    mnist数据集可以从https://s3.amazonaws.com/img-datasets/mnist.npz 这个网址进行下载,下载的文件是一种称为np...

    算法与编程之美
  • Cypress web自动化17-fixture加载json文件数据

    面试时间经常被问到:你的测试数据放哪?有没有做到测试数据和代码的分离? Cypress 使用cypress/fixture 目录存放 json 文件数据, cy...

    上海-悠悠
  • 《Kotlin极简教程》第六章 Kotlin函数式编程(FP)函数指针复合函数

    看了下面的复合函数的例子,你会发现Kotlin的FP的实现相当简洁。(跟纯数学的表达式,相当接近了)

    一个会写诗的程序员
  • 2019年不容错过的VR游戏!《渔夫的故事》、《王国之心》……可有你中意的那一款?

    内容开发者正在不同的平台上开发出越来越多的优秀内容,真的很令人兴奋。这两日,国家新闻出版广电总局,发布了针对2018年12月份的国产网游审批信息,也是游戏版号审...

    VRPinea
  • PT100热电阻校准模块设计

    之前为为各位朋友分享了关于PT100的热电阻温度阻值对应表和如何使用Excel表格精准分析PT100温度阻值关系。

    不脱发的程序猿
  • 臭名昭著的《沙漠巴士》发布VR重置版,你会花8小时去玩吗?

    VRPinea
  • 3,变量与标点符号

    与C等许多编程语言相比,作为动态语言的Python,其变量是一个标签,而不是一个容器。

    lyhue1991

扫码关注云+社区

领取腾讯云代金券