This is a pytest plugin for creating/editing testplans or testruns based on pytest markers. The results of the collected tests will be updated against the testplan/testrun in TestRail.
Installation
pip install pytest-testrail-e2e
Configuration
Config for Pytest tests
Add a marker to the tests that will be picked up to be added to the run.
from pytest_testrail.plugin import testrail
@testrail('C1234', 'C5678')
def test_foo():
# test code goes here
# OR
from pytest_testrail.plugin import pytestrail
@pytestrail.case("C1234", "C5678")
def test_bar():
# test code goes hereOr if you want to add defects to testcase result:
from pytest_testrail.plugin import pytestrail
@pytestrail.defect("PF-524", "BR-543")
def test_bar():
# test code goes hereSkip a testcase [You need create ‘Skipped’ status in TestRail’]:
from pytest_testrail.plugin import pytestrail
@pytestrail.case("C1234")
@pytest.mark.skip("Mark as skipped description")
# or @pytest.mark.skip(reason="Mark as skipped description")
def test_bar():
# test code goes hereBlock a testcase:
import pytest
from pytest_testrail.plugin import pytestrail
@pytestrail.case("C1234")
@pytestrail.block("Mark as blocked description")
# @pytestrail.block(reason="Mark as blocked description")
def test_bar():
# test code goes here
# OR
@pytestrail.case("C1234")
@pytest.mark.skip(reason="Mark as blocked description", block=True)
def test_bar():
# test code goes hereConfig for TestRail
Settings file template config:
[API]
url = https://yoururl.testrail.net/
email = user@email.com
password = <api_key>
[TESTRUN]
assignedto_id = 1
project_id = 2
suite_id = 3
plan_id = 4
description = 'This is an example description'
[TESTCASE]
custom_comment = 'This is a custom comment'Or
Set command line options (see below)
Usage
Basically, the following command will create a testrun in TestRail, add all marked tests to run. Once the all tests are finished they will be updated in TestRail:
py.test --testrail --tr-config=<settings file>.cfgAll available options
option |
description |
|---|---|
–testrail |
Create and update testruns with TestRail |
–tr-config |
Path to the config file containing information about the TestRail server (defaults to testrail.cfg) |
–tr-url |
TestRail address you use to access TestRail with your web browser (config file: url in API section) |
–tr-email |
Email for the account on the TestRail server (config file: email in API section) |
–tr-password |
Password for the account on the TestRail server (config file: password in API section) |
–tr-testrun-as signedto-id |
ID of the user assigned to the test run (config file:assignedto_id in TESTRUN section) |
–tr-testrun-pr oject-id |
ID of the project the test run is in (config file: project_id in TESTRUN section) |
–tr-testrun-su ite-id |
ID of the test suite containing the test cases (config file: suite_id in TESTRUN section) |
–tr-testrun-su ite-include-all |
Include all test cases in specified test suite when creating test run (config file: include_all in TESTRUN section) |
–tr-testrun-na me |
Name given to testrun, that appears in TestRail (config file: name in TESTRUN section) |
–tr-testrun-de scription |
Description given to testrun, that appears in TestRail (config file: description in TESTRUN section) |
–tr-run-id |
Identifier of testrun, that appears in TestRail. If provided, option “–tr-testrun-name” will be ignored |
–tr-plan-id |
Identifier of testplan, that appears in TestRail. If provided, option “–tr-testrun-name” will be ignored |
–tr-version |
Indicate a version in Test Case result. |
–tr-no-ssl-cer t-check |
Do not check for valid SSL certificate on TestRail host |
–tr-close-on-c omplete |
Close a test plan or test run on completion. |
–tr-dont-publi sh-blocked |
Do not publish results of “blocked” testcases in TestRail |
–tr-skip-missi ng |
Skip test cases that are not present in testrun |
–tr-milestone- id |
Identifier of milestone to be assigned to run |
–tc-custom-com ment |
Custom comment, to be appended to default comment for test case (config file: custom_comment in TESTCASE section) |
–tr-report-sin gle-test |
Report result immediately for each test case when it finished |
TestRail Settings
To increase security, the TestRail team suggests using an API key instead of a password. You can see how to generate an API key here.
If you maintain your own TestRail instance on your own server, it is recommended to enable HTTPS for your TestRail installation.
For TestRail hosted accounts maintained by Gurock, all accounts will automatically use HTTPS.
You can read the whole TestRail documentation here.
License
This project is licensed under the MIT license.
Acknowledgments
allankp, author of the pytest-testrail repository that was cloned.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pytest-testrail-e2e-2.1.2.tar.gz.
File metadata
- Download URL: pytest-testrail-e2e-2.1.2.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.6.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce2f2ef3df4e6b7f14fd98f292025ef6f1e80b4460f7b0a28f2b298ca9bedb51
|
|
| MD5 |
c9eddb6a88696f68138068b6a211b3f2
|
|
| BLAKE2b-256 |
c119ff9d9433a74ce9e14af77d6e5a9c38fbd1c5e0147fa59105d34927c73234
|
File details
Details for the file pytest_testrail_e2e-2.1.2-py3-none-any.whl.
File metadata
- Download URL: pytest_testrail_e2e-2.1.2-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.6.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
53e463a1ddc57bc62537e8e05548820c1ae6c71f4e18806c1e8237be921e4762
|
|
| MD5 |
8d13c3142036e8aa05c8032ed5e482bf
|
|
| BLAKE2b-256 |
1739b3bec16693df2456a241ba3385d707feff8ec22e852e22c7861715215992
|
