pytest插件,用于将结果上传到TestRail。
项目描述
根据pytest结果在TestRail中创建和更新测试计划/测试运行。带有TestRail案例ID标记的测试函数的结果将发送到TestRail。
此项目保留了已弃用的pytest-testrail项目的功能。
主要功能
可配置的:以适合您项目的方式处理结果。
强大的:通过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 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | a236e68d803478b38333ccf22ea829e46caaf67f581b2415391141fb99c1747f |
|
MD5 | 92c022fefdc2c579d54f521e38419a39 |
|
BLAKE2b-256 | 4bad63fc953a066a784b3fb422266416c1d0d3b6478dfbb9eee8c8262eee7ebc |