lamber 0.1.0

An easy-to-use testing framework based on pytest

Lamber

Lamber 收集 pytest 执行数据（models），提供消费接口（hooks），并允许用户集成自定义数据。

安装

pip install lamber

依赖

• python >= 3.10
• pytest >= 8.3.5

基于 Sqlite3 的测试报告

测试报告是一种典型的媒介，可以更加直观的展示 Lamber 的功能。Lamber 支持将测试执行数据保存到 Sqlite3 数据库文件中，通过 --lamber-sqlite-dir 命令行选项指定数据库文件的目录，数据库文件名为 lamber.db。

lamber-report 是基于 Lamber 开发的测试报告，后续讨论将基于此展开。

对原生 pytest 脚本的支持

一个典型的 pytest 脚本如下：

import pytest


@pytest.fixture(scope="module")
def module_fixture():
    print("Setup module env")
    yield
    print("Clean module env")


@pytest.fixture(scope="function", autouse=True)
def function_fixture(module_fixture):
    print("Setup function env")
    yield
    print("Clean function env")


def inc(x):
    return x + 1


def test_answer():
    assert inc(3) == 5

• 包含 module 和 function 级别的 fixture。

生成的测试报告主体如下：

• 包含 Step Tree、Traceback、Sourcecode、Logs 等信息。
• 其中 pytest fixture 的调用关系会在 Step Tree 中展示。可以通过 --lamber-ignore-fixture-step 选项关闭此功能。

对原生 pytest 脚本的改造

Lamber 引入 Step 的概念，将测试执行的过程进一步细分，支持装饰器和上下文管理器两种方式声明 Step。

对上述脚本改造后，如下：

import pytest

import lamber


@pytest.fixture(scope="module")
def module_fixture():
   with lamber.Step("Setup module env"):
       print("Setup module env")

   yield

   with lamber.Step("Clean module env"):
       print("Clean module env")


@pytest.fixture(scope="function", autouse=True)
def function_fixture(module_fixture):
   with lamber.Step("Setup function env"):
       print("Setup function env")

   yield

   with lamber.Step("Clean function env"):
       print("Clean function env")


# Step decorator
@lamber.step("Plus one")
def inc(x):
   return x + 1


def test_answer():
   assert inc(3) == 5

生成的测试报告主体如下：

• Step Tree 上会有进一步细化。

LICENSE

MIT LICENSE