Tracera
开始试用

Pytest

pip install tracera-pytest

需要 Python ≥ 3.11 和 pytest ≥ 8（见 自动化测试适配器）。tracera-pytest on PyPI。

环境变量、运行模式与重试见 自动化测试适配器。

重试时 Env 键：PYTEST_RETRY。

绑定 testCaseId 与 autotestName

照常使用 pytest 标准 API，并从 tracera_pytest 导入 tracera 和 id。

在声明时（推荐 — 即使测试提前跳过也会绑定）：

import pytest
from tracera_pytest import id as tracera_id

@tracera_id(42, "e2e/login")
def test_login():
    assert True

在测试中（若 @tracera.id 已绑定用例则可省略）：

from tracera_pytest import tracera

def test_login():
    tracera.test_case(42, "e2e/login")
    assert True

Skip

使用 pytest 标准 skip（pytest.skip、@pytest.mark.skip 等）。Skip reason 作为 comment 添加到结果。

import os
import pytest
from tracera_pytest import id as tracera_id

@tracera_id(42, "e2e/login")
def test_login():
    if not os.environ.get("READY"):
        pytest.skip("env not ready")

步骤

使用 tracera.step(title, body)、@tracera.step("…")、with tracera.step("…"): 或 async with tracera.step("…"):（async def 也可用 @tracera.step / await tracera.step(…)）。在装饰器 @tracera.step("add {item}") 中，{item} 由该函数的 item 参数代入。function-scoped fixture 内的步骤进入结果的 准备 / 清理；测试内的步骤进入结果的 测试 区。套件级钩子不上报。

import pytest
from tracera_pytest import tracera

@pytest.fixture(autouse=True)
def open_shop():
    with tracera.step("open shop"):
        pass
    yield
    with tracera.step("cleanup"):
        pass

@tracera.step("add {item}")
def add_to_cart(item: str):
    pass

def test_checkout():
    tracera.test_case(10, "e2e/checkout")
    add_to_cart("sku-1")  # → 步骤 "add sku-1"

注释、错误与附件

注释、错误与附件见 自动化测试适配器。

from tracera_pytest import tracera

def test_login():
    tracera.test_case(42, "e2e/login")
    tracera.comment("result-level note")
    tracera.error("result-level error text")

    with tracera.step("open login"):
        tracera.comment("landed on login")
        tracera.attachment(
            file_name="suite-log.txt",
            mime_type="text/plain",
            data=b"finished login flow",
        )

参数化测试

@tracera.id 装饰器的第二个参数是 autotest 名称。其中可用 {参数名} / {param_id} 占位符；{参数名} 须与测试函数的参数同名；每一行 @pytest.mark.parametrize 用该行的值填入（若 pytest 提供参数 id，可用 {param_id}）。下面的示例会得到绑定到用例 42 的两个结果，autotest 名称分别为 login as ok 和 login as sso：

import pytest
from tracera_pytest import id as tracera_id

@tracera_id(42, "login as {login}")
@pytest.mark.parametrize("login", ["ok", "sso"])
def test_login(login):
    assert login

当用例 id 也变化时，也可在测试中绑定：

import pytest
from tracera_pytest import tracera

@pytest.mark.parametrize(
    "case_id,name",
    [
        (42, "e2e/login-ok"),
        (43, "e2e/login-sso"),
    ],
)
def test_login_row(case_id, name):
    tracera.test_case(case_id, name)
    with tracera.step("open"):
        pass