Test IT TMS adapter for Nose
Getting Started
Installation
pip install testit-adapter-nose
Usage
Configuration
| Description | File property | Environment variable |
|---|---|---|
| Location of the TMS instance | url | TMS_URL |
| API secret key How to getting API secret key? | privateToken | TMS_PRIVATE_TOKEN |
| ID of project in TMS instance How to getting project ID? | projectId | TMS_PROJECT_ID |
| ID of configuration in TMS instance How to getting configuration ID? | configurationId | TMS_CONFIGURATION_ID |
| ID of the created test run in TMS instance. It's necessary for adapterMode 1 |
testRunId | TMS_TEST_RUN_ID |
| Parameter for specifying the name of test run in TMS instance (It's optional). If it is not provided, it is created automatically | testRunName | TMS_TEST_RUN_NAME |
Test run tags (It's optional). Comma-separated list or JSON array, e.g. smoke,nightly or ["smoke","nightly"] |
testRunTags | TMS_TEST_RUN_TAGS |
Test run links (It's optional). JSON array of objects with required url and optional title, description, type. Applied at create/start. Link types: Related, BlockedBy, Defect, Issue, Requirement, Repository |
testRunLinks | TMS_TEST_RUN_LINKS |
| Adapter mode. Default value - 1. The adapter supports following modes: 1 - in this mode, the adapter sends all results to the test run without filtering or with filtering CLI 2 - in this mode, the adapter creates a new test run and sends results to the new test run |
adapterMode | TMS_ADAPTER_MODE |
| It enables/disables certificate validation (It's optional). Default value - true | certValidation | TMS_CERT_VALIDATION |
| Mode of automatic creation test cases (It's optional). Default value - false. The adapter supports following modes: true - in this mode, the adapter will create a test case linked to the created autotest (not to the updated autotest) false - in this mode, the adapter will not create a test case |
automaticCreationTestCases | TMS_AUTOMATIC_CREATION_TEST_CASES |
| Mode of automatic updation links to test cases (It's optional). Default value - false. The adapter supports following modes: true - in this mode, the adapter will update links to test cases false - in this mode, the adapter will not update link to test cases |
automaticUpdationLinksToTestCases | TMS_AUTOMATIC_UPDATION_LINKS_TO_TEST_CASES |
| Mode of import type selection when launching autotests (It's optional). Default value - true. The adapter supports following modes: true - in this mode, the adapter will create/update each autotest in real time false - in this mode, the adapter will create/update multiple autotests |
importRealtime | TMS_IMPORT_REALTIME |
| Url of proxy server (It's optional) | tmsProxy | TMS_PROXY |
| Name (including extension) of the configuration file If it is not provided, it is used default file name (It's optional) | - | TMS_CONFIG_FILE |
| Sync storage port (It's optional, 49152 by default) | syncStoragePort | TMS_SYNC_STORAGE_PORT |
File
Add [testit] block to your pyproject.toml or create connection_config.ini file in the root directory of the project:
[testit]
URL = URL
privateToken = USER_PRIVATE_TOKEN
projectId = PROJECT_ID
configurationId = CONFIGURATION_ID
testRunId = TEST_RUN_ID
testRunName = TEST_RUN_NAME
testRunTags = smoke,nightly
testRunLinks = [{"url":"https://gitlab.example.com/group/project/-/jobs/12345","title":"CI Job","type":"Related"}]
adapterMode = ADAPTER_MODE
certValidation = CERT_VALIDATION
automaticCreationTestCases = AUTOMATIC_CREATION_TEST_CASES
automaticUpdationLinksToTestCases = AUTOMATIC_UPDATION_LINKS_TO_TEST_CASES
importRealtime = IMPORT_REALTIME
# This section are optional. It enables debug mode.
[debug]
tmsProxy = TMS_PROXY
Examples
Launch with a pyproject.toml or connection_config.ini file in the root directory of the project:
$ nose2 --testit
If you want to enable debug mode then see How to enable debug logging?
Run with filter
To create filter by autotests you can use the Test IT CLI (use adapterMode 1 for run with filter):
$ export TMS_TOKEN=<YOUR_TOKEN>
$ testit autotests_filter
--url https://tms.testit.software \
--configuration-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--testrun-id 6d4ac4b7-dd67-4805-b879-18da0b89d4a8 \
--framework nose \
--output tmp/filter.txt
$ nose2 $(cat tmp/filter.txt) --testit
Decorators
Decorators can be used to specify information about autotest.
Description of decorators:
testit.workItemIds- a method that links autotests with manual tests. Receives the array of manual tests' IDstestit.displayName- internal autotest name (used in Test IT)testit.externalId- unique internal autotest ID (used in Test IT)testit.title- autotest name specified in the autotest card. If not specified, the name from the displayName method is usedtestit.description- autotest description specified in the autotest cardtestit.labels- labels listed in the autotest cardtestit.tags- tags listed in the autotest cardtestit.links- links listed in the autotest cardtestit.step- the designation of the step called in the body of the test or other steptestit.nameSpace- directory in the TMS system (default - file's name of test)testit.className- subdirectory in the TMS system (default - class's name of test)
All decorators support the use of parameterization attributes
Description of methods:
testit.addWorkItemIds- a dynamic method that links autotests with manual tests. Receives the array of manual tests' IDstestit.addDisplayName- a dynamic method for adding internal autotest name (used in Test IT)testit.addExternalId- a dynamic method for adding unique internal autotest ID (used in Test IT)testit.addTitle- a dynamic method for adding autotest name specified in the autotest card. If not specified, the name from the displayName method is usedtestit.addDescription- a dynamic method for adding autotest description specified in the autotest cardtestit.addLabels- a dynamic method for adding labels listed in the autotest cardtestit.addTags- a dynamic method for adding tags listed in the autotest cardtestit.addLinks- links in the autotest resulttestit.addAttachments- uploading files in the autotest resulttestit.addMessage- information about autotest in the autotest resulttestit.addNameSpace- a dynamic method for adding directory in the TMS system (default - file's name of test)testit.addClassName- a dynamic method for adding subdirectory in the TMS system (default - class's name of test)testit.addParameter- a dynamic method for adding parameter in the autotest resulttestit.step- usage in the "with" construct to designation a step in the body of the test
Examples
Simple test
import pytest
import testit
# Test with a minimal set of decorators
@testit.externalId('Simple_autotest2')
def test_2():
"""Simple autotest 2"""
assert oneStep()
assert twoStep()
@testit.step
def oneStep():
assert oneOneStep()
assert oneTwoStep()
return True
@testit.step
def twoStep():
return True
@testit.step('step 1.1', 'description')
def oneOneStep():
return True
@testit.step('step 2')
def oneTwoStep():
return True
Parameterized test
# Parameterized test with a full set of decorators
from os.path import join, dirname
import testit
from nose2.tools import params
@params(1, 2, 3)
@testit.workItemIds(627)
@testit.externalId('param {num}')
@testit.displayName('param {num}')
@testit.title('Test with params')
@testit.description('E2E_autotest')
@testit.tags('parameters', 'test')
@testit.links(url='https://dumps.example.com/module/JCP-777')
@testit.links(url='https://dumps.example.com/module/JCP-777',
title='JCP-777',
type=testit.LinkType.RELATED,
description='Description of JCP-777')
def test_nums(num):
assert num < 4
Contributing
You can help to develop the project. Any contributions are greatly appreciated.
- If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
- Please make sure you check your spelling and grammar.
- Create individual PR for each suggestion.
- Please also read through the Code Of Conduct before posting your first idea as well.
License
Distributed under the Apache-2.0 License. See LICENSE for more information.
1 maintainer
Metadata
1 maintainer
Release files for testit-adapter-nose 5.1.6.post580
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| testit_adapter_nose-5.1.6.post580.tar.gz | 13.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| testit_adapter_nose-5.1.6.post580-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.3 kB
Release files / testit_adapter_nose-5.1.6.post580.tar.gz
| Download URL | testit_adapter_nose-5.1.6.post580.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ecc8d01918cf94706979ed8d8196412e9908c7c8dd9710292dcac3332d00710e
|
|
BLAKE2b-256 checksum How to use checksums |
465d052775787a0bb55d30b88a9c3c3524d81df68d0a9d6dca54af8d0811044b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / testit_adapter_nose-5.1.6.post580-py3-none-any.whl
| Download URL | testit_adapter_nose-5.1.6.post580-py3-none-any.whl |
|---|---|
| Size | 10.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
14605456b9e808622bf1995f9245b0bf7a0e82e520a7efebf020d67d6f58c322
|
|
BLAKE2b-256 checksum How to use checksums |
848a97f6c446ac7992df1eef7619c7cfe284a2daee4e0ede41e3fea74b629123
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
