tep时隔8个月迎来重大全新升级

时间:2022-11-26 15:56:20

tep此次更新,旨在从“工具”升级为“框架”,为此做了大量的代码整洁工作,重新设计了部分功能,项目脚手架也焕然一新。

功能展示

conftest.py

脚手架生成的conftest.py只有一行代码:

tep时隔8个月迎来重大全新升级

fixture自动加载等操作都隐藏到了tep的科技与狠活里面。

环境变量模板

使用yaml维护环境变量:

tep时隔8个月迎来重大全新升级

你可以env_vars目录下维护​​env_vars_​​开头的任意命名的yaml模板,内容自定义:

domain: "http://127.0.0.1:5000"
env: "dev"
db:
mysql:
host: "localhost"
port: "3306"
user: "root"
password: "123456"
db: "sys"

取值时只需要引入env_vars fixture,像字典一样取值:

from loguru import logger


def test(env_vars):
logger.info(env_vars["domain"])
logger.info(env_vars["env"])
logger.info(env_vars["db"]["mysql"]["host"])

激活哪个模板,就在tep.yaml中配置:

env:
active: "dev"

工具包与示例代码

工具包有MySql访问、FastAPI Mock、常用函数、HTTP请求、流量录制:

tep时隔8个月迎来重大全新升级

示例代码有断言、数据库访问、环境变量、faker造数据、常用函数、HTTP请求、从登陆到下单自动化用例:

tep时隔8个月迎来重大全新升级

项目脚手架

​tep startproject demo​​生成的项目脚手架如图所示:

tep时隔8个月迎来重大全新升级

没有杂质,纯粹的pytest!

tep技术内幕

化繁为简

tep只保留了“框架”层面的模块:

tep时隔8个月迎来重大全新升级

三方库都抽出来到了脚手架的utils包里,譬如HTTP请求在utils/http_client里面。

项目路径识别

在conftest加载插件时,使用​​inspect.stack()[1]​​反推项目路径:

def tep_plugins():
caller = inspect.stack()[1]
Config.project_root_dir = os.path.dirname(caller.filename)
plugins = fixture_paths() # +[其他插件]
return plugins

fixture自动导入

conftest.py加载时,将fixture路径作为插件加载,一个是项目目录下的fixtures包,一个是tep里面的fixture模块:

def fixture_paths():
"""
fixture路径,1、项目下的fixtures;2、tep下的fixture;
:return:
"""
_fixtures_dir = os.path.join(Config.project_root_dir, "fixtures")
paths = []
# 项目下的fixtures
for root, _, files in os.walk(_fixtures_dir):
for file in files:
if file.startswith("fixture_") and file.endswith(".py"):
full_path = os.path.join(root, file)
import_path = full_path.replace(_fixtures_dir, "").replace("\\", ".")
import_path = import_path.replace("/", ".").replace(".py", "")
paths.append("fixtures" + import_path)
# tep下的fixture
paths.append("tep.fixture")
return paths

环境变量

内置env_vars fixture:

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

"""
@Author : dongfanger
@Date : 2020/12/30 9:30
@Desc : 预置fixture
"""
import os

import pytest
import yaml
from loguru import logger

from tep.config import tep_config, Config


class TepVars:
"""全局变量池"""

def __init__(self):
self.vars_ = {}

def put(self, key, value):
self.vars_[key] = value

def get(self, key):
value = ""
try:
value = self.vars_[key]
except KeyError:
logger.error(f"env_vars doesnt have this key: {key}")
return value


@pytest.fixture(scope="session")
def env_vars():
"""环境变量,读取resources/env_vars下的变量模板"""
class Clazz(TepVars):
def dict_(self):
env_active = tep_config()['env']["active"]
env_filename = f"env_vars_{env_active}.yaml"
with open(
os.path.join(Config.project_root_dir, "resources", "env_vars", env_filename)) as f:
return yaml.load(f.read(), Loader=yaml.FullLoader)

return Clazz().dict_()

TepVars是全局变量池,支持动态put和get。

env_vars根据tep.yaml配置的active,获取对应的环境变量模板,解析yaml,返回字典。

项目脚手架

脚手架代码完整的放在template下面:

tep时隔8个月迎来重大全新升级

文件后缀均加上了​​.tep​​​,这样就不会扰乱实际项目代码,在​​tep startproject​​​时会将这些文件拷贝到目标项目,同时去除​​.tep​​后缀,快速生成自动化项目。

这些模板的源码可以查阅另外一个项目:

​https://github.com/dongfanger/tep-template.git​

最新的tep预览功能也能在这个项目看到。

Try Easy Pytest

tep是Try Easy Pytest的首字母缩写,是依托于pytest的一款测试工具。本次工具架构改造是一个开端,tep还会持续迭代开发,逐步引入企业级的一系列技术实践,敬请期待,也欢迎加入我们,一起开发,共创美好未来!

tep源码:​​https://github.com/dongfanger/tep​