跳至主要内容

pytest插件,用于将结果上传到TestRail。

项目描述

根据pytest结果在TestRail中创建和更新测试计划/测试运行。带有TestRail案例ID标记的测试函数的结果将发送到TestRail。

此项目保留了已弃用的pytest-testrail项目的功能。

PyPI PyPI - Python Version GitHub Build status

主要功能

  • 可配置的:以适合您项目的方式处理结果。

  • 强大的:通过TestRail API的简单界面处理复杂用例。

  • 灵活的:完全兼容pytest.parametrize()、pytest-xdist和pytest-rerunfailures。

示例

import pytest

@pytest.mark.case_id('C1950')
def test_all_the_things():
  doit = True
  assert doit

入门

安装

通过pip

pip install pytest-testrail2

插件配置

以下值是必需的

  • 有效的TestRail实例URL。

  • 实例上用户的有效电子邮件地址。

  • 用户的有效API密钥。

它们可以通过以下标志在命令行上设置

--tr-url=<your_url>
--tr-email=<your_email>
--tr-password=<your_password>

或者,它们可以通过pytest配置文件设置

[pytest]
  tr_url=<your_url>
  tr_email=<your_email>
  tr_password=<your_password>

标记测试

case_id

case_id标记符接受一个字符串,该字符串必须与现有的TestRail测试用例匹配。只有带有此标记的测试将被添加到TestRail测试运行中。

import pytest

# This test's results will be uploaded.
@pytest.mark.case_id('C1950')
def test_all_the_things():
  ...


# This test's results will not be uploaded.
def test_all_the_other_things():
  ...

defect_ids

‘defect_ids’标记符接受一个字符串列表。这些将在TestRail中的《defect》字段中使用。这对于已知失败的测试很有用。

通常这些是您缺陷跟踪软件的ID。

import pytest

@pytest.mark.case_id('C1950')
@pytest.mark.defect_ids(['JS-7001', 'JS-9001'])
def test_all_the_things():
  ...

运行pytest

必须存在< cite>–testrail命令行标志才能上传结果

pytest --testrail

选项

设置

  • --testrail 激活TestRail插件。

  • --tr-url 用于访问 TestRail 实例的 Web 地址。

  • --tr-email TestRail 实例上的账户电子邮件地址。

  • --tr-password TestRail 实例上的账户密码。

  • --tr-timeout 连接到 TestRail 服务器的超时时间。

  • --tr-no-ssl-cert-check 在 TestRail 主机上不检查有效的 SSL 证书。

测试运行

  • --tr-run-id TestRail 中现有测试运行的 ID。如果指定,将使用与 ID 匹配的测试运行,而不是创建新的测试运行。如果给出,将忽略 --tr-testrun-name

  • --tr-testrun-name 在 TestRail 中用于新测试运行的名字。

  • --tr-testrun-description 在 TestRail 中用于新测试运行的描述。

  • --tr-testrun-assignedto-id 被分配给测试运行的用户的 ID。

  • --tr-testrun-project-id 测试运行将创建在其上的项目的 ID。

  • --tr-testrun-suite-id 测试运行将创建在其上的套件的 ID。

  • --tr-testrun-suite-include-all 对于新测试运行,包含指定测试套件中的所有测试用例。

  • --tr-milestone-id 在创建测试运行时使用的里程碑的 ID。

  • --tr-skip-missing 跳过在指定测试运行中不存在的标记的 pytest 测试函数。

测试计划

  • --tr-plan-id 要使用的现有测试计划的 ID。如果给出,将忽略 --tr-testrun-name

发布

  • --tr-version 在测试用例结果中指定版本。

  • --tr-close-on-complete 在 pytest 完成时关闭测试运行。

  • --tr-dont-publish-blocked 不要发布“已阻止”测试用例(在 TestRail 中)的结果。

  • --tr-custom-comment 添加到所有测试用例结果的评论中的自定义文本。

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分布

pytest-testrail2-1.1.0.tar.gz (21.6 kB 查看哈希值)

上传时间

构建分布

pytest_testrail2-1.1.0-py3-none-any.whl (17.0 kB 查看哈希值)

上传时间 Python 3

由以下支持