testit-cli 2.10.3__tar.gz → 2.11.0__tar.gz

{testit_cli-2.10.3 → testit_cli-2.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testit-cli
-Version: 2.10.3
+Version: 2.11.0
 Summary: This tool is the command line wrapper of Test IT allowing you to upload the test results in real time to Test IT
 Home-page: https://pypi.org/project/testit-cli/
 Author: Integration team
@@ -145,3 +145,31 @@ Notes:
 - Test run tags/links are independent from autotest/result tags and links.
 - On an existing run, new tags/links are **merged** (existing values are kept; duplicates by tag name / link URL are skipped).
 - Empty or omitted values mean “do not change tags/links”.
+
+## Autotest layer (test pyramid)
+
+When importing XML results, CLI can set the **autotest** pyramid layer for every upserted autotest (create/update).  
+This is a **run-level default** for file-based import; adapters still read layer from test code annotations.
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Default autotest layer | `--autotest-layer` / `-al` | `TMS_AUTOTEST_LAYER` |
+
+Supported commands: `results import`, `results upload`.
+
+Recommended values: `E2E`, `UI`, `API`, `Contract`, `Integration`, `Component`, `Unit`. Any other non-empty string is accepted.
+
+```bash
+export TMS_AUTOTEST_LAYER=API
+testit results import \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --results ./results
+```
+
+Behaviour (aligned with adapters API):
+
+- Layer set → send `layer: { name, source: Run }` on create/update.
+- Layer not set → do not send `layer`; on update always send `resetLayer: false`.

{testit_cli-2.10.3 → testit_cli-2.11.0}/README.md

@@ -111,3 +111,31 @@ Notes:
 - Test run tags/links are independent from autotest/result tags and links.
 - On an existing run, new tags/links are **merged** (existing values are kept; duplicates by tag name / link URL are skipped).
 - Empty or omitted values mean “do not change tags/links”.
+
+## Autotest layer (test pyramid)
+
+When importing XML results, CLI can set the **autotest** pyramid layer for every upserted autotest (create/update).  
+This is a **run-level default** for file-based import; adapters still read layer from test code annotations.
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Default autotest layer | `--autotest-layer` / `-al` | `TMS_AUTOTEST_LAYER` |
+
+Supported commands: `results import`, `results upload`.
+
+Recommended values: `E2E`, `UI`, `API`, `Contract`, `Integration`, `Component`, `Unit`. Any other non-empty string is accepted.
+
+```bash
+export TMS_AUTOTEST_LAYER=API
+testit results import \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --results ./results
+```
+
+Behaviour (aligned with adapters API):
+
+- Layer set → send `layer: { name, source: Run }` on create/update.
+- Layer not set → do not send `layer`; on update always send `resetLayer: false`.

{testit_cli-2.10.3 → testit_cli-2.11.0}/setup.py

@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "2.10.3"
+VERSION = "2.11.0"
 
 ADAPTERS_ROOT = "src/testit_cli/adapters_api"
 ADAPTERS_PACKAGES = ["adapters_api"] + [

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/adapters_api/model/custom_attribute_api_result.py

@@ -90,9 +90,9 @@ class CustomAttributeApiResult(ModelNormal):
             'is_enabled': (bool,),  # noqa: E501
             'is_required': (bool,),  # noqa: E501
             'is_global': (bool,),  # noqa: E501
-            'is_read_only': (bool, none_type,),  # noqa: E501
-            'is_system': (bool, none_type,),  # noqa: E501
-            'targets': ([str], none_type,),  # noqa: E501
+            'is_read_only': (bool,),  # noqa: E501
+            'is_system': (bool,),  # noqa: E501
+            'targets': ([str],),  # noqa: E501
             'code': (str, none_type,),  # noqa: E501
         }
 
@@ -123,7 +123,7 @@ class CustomAttributeApiResult(ModelNormal):
 
     @classmethod
     @convert_js_args_to_python_args
-    def _from_openapi_data(cls, id, options, type, is_deleted, name, is_enabled, is_required, is_global, *args, **kwargs):  # noqa: E501
+    def _from_openapi_data(cls, id, options, type, is_deleted, name, is_enabled, is_required, is_global, is_read_only, is_system, targets, *args, **kwargs):  # noqa: E501
         """CustomAttributeApiResult - a model defined in OpenAPI
 
         Args:
@@ -135,11 +135,11 @@ class CustomAttributeApiResult(ModelNormal):
             is_enabled (bool): Indicates if the attribute is enabled
             is_required (bool): Indicates if the attribute value is mandatory to specify
             is_global (bool): Indicates if the attribute is available across all projects
+            is_read_only (bool): Indicates if the attribute is read-only
+            is_system (bool): Indicates if the attribute is system
+            targets ([str]): Collection of the attribute targets   Defines where the attribute can be used (e.g., TestCases, AutoTestCases, TestPlans)
 
         Keyword Args:
-            is_read_only (bool): Indicates if the attribute is read-only. [optional]  # noqa: E501
-            is_system (bool): Indicates if the attribute is system. [optional]  # noqa: E501
-            targets ([str]): Collection of the attribute targets. [optional]  # noqa: E501
             _check_type (bool): if True, values for parameters in openapi_types
                                 will be type checked and a TypeError will be
                                 raised if the wrong type is input.
@@ -178,9 +178,6 @@ class CustomAttributeApiResult(ModelNormal):
         _path_to_item = kwargs.pop('_path_to_item', ())
         _configuration = kwargs.pop('_configuration', None)
         _visited_composed_classes = kwargs.pop('_visited_composed_classes', ())
-        is_read_only = kwargs.pop('is_read_only', False)
-        is_system = kwargs.pop('is_system', False)
-        targets = kwargs.pop('targets', None)
 
         self = super(OpenApiModel, cls).__new__(cls)
 
@@ -236,7 +233,7 @@ class CustomAttributeApiResult(ModelNormal):
     ])
 
     @convert_js_args_to_python_args
-    def __init__(self, id, options, type, is_deleted, name, is_enabled, is_required, is_global, *args, **kwargs):  # noqa: E501
+    def __init__(self, id, options, type, is_deleted, name, is_enabled, is_required, is_global, is_read_only, is_system, targets, *args, **kwargs):  # noqa: E501
         """CustomAttributeApiResult - a model defined in OpenAPI
 
         Args:
@@ -248,11 +245,11 @@ class CustomAttributeApiResult(ModelNormal):
             is_enabled (bool): Indicates if the attribute is enabled
             is_required (bool): Indicates if the attribute value is mandatory to specify
             is_global (bool): Indicates if the attribute is available across all projects
+            is_read_only (bool): Indicates if the attribute is read-only
+            is_system (bool): Indicates if the attribute is system
+            targets ([str]): Collection of the attribute targets   Defines where the attribute can be used (e.g., TestCases, AutoTestCases, TestPlans)
 
         Keyword Args:
-            is_read_only (bool): Indicates if the attribute is read-only. [optional]  # noqa: E501
-            is_system (bool): Indicates if the attribute is system. [optional]  # noqa: E501
-            targets ([str]): Collection of the attribute targets. [optional]  # noqa: E501
             _check_type (bool): if True, values for parameters in openapi_types
                                 will be type checked and a TypeError will be
                                 raised if the wrong type is input.
@@ -291,9 +288,6 @@ class CustomAttributeApiResult(ModelNormal):
         _path_to_item = kwargs.pop('_path_to_item', ())
         _configuration = kwargs.pop('_configuration', None)
         _visited_composed_classes = kwargs.pop('_visited_composed_classes', ())
-        is_read_only = kwargs.pop('is_read_only', False)
-        is_system = kwargs.pop('is_system', False)
-        targets = kwargs.pop('targets', None)
 
         if args:
             for arg in args:

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/adapters_api/model/layer_source.py

@@ -53,6 +53,7 @@ class LayerSource(ModelSimple):
     allowed_values = {
         ('value',): {
             'MANUAL': "Manual",
+            'REPORT': "Report",
             'RUN': "Run",
             'RULE': "Rule",
         },
@@ -106,10 +107,10 @@ class LayerSource(ModelSimple):
         Note that value can be passed either in args or in kwargs, but not in both.
 
         Args:
-            args[0] (str):, must be one of ["Manual", "Run", "Rule", ]  # noqa: E501
+            args[0] (str):, must be one of ["Manual", "Report", "Run", "Rule", ]  # noqa: E501
 
         Keyword Args:
-            value (str):, must be one of ["Manual", "Run", "Rule", ]  # noqa: E501
+            value (str):, must be one of ["Manual", "Report", "Run", "Rule", ]  # noqa: E501
             _check_type (bool): if True, values for parameters in openapi_types
                                 will be type checked and a TypeError will be
                                 raised if the wrong type is input.
@@ -200,10 +201,10 @@ class LayerSource(ModelSimple):
         Note that value can be passed either in args or in kwargs, but not in both.
 
         Args:
-            args[0] (str):, must be one of ["Manual", "Run", "Rule", ]  # noqa: E501
+            args[0] (str):, must be one of ["Manual", "Report", "Run", "Rule", ]  # noqa: E501
 
         Keyword Args:
-            value (str):, must be one of ["Manual", "Run", "Rule", ]  # noqa: E501
+            value (str):, must be one of ["Manual", "Report", "Run", "Rule", ]  # noqa: E501
             _check_type (bool): if True, values for parameters in openapi_types
                                 will be type checked and a TypeError will be
                                 raised if the wrong type is input.

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/apiclient.py

@@ -212,6 +212,7 @@ class ApiClient:
     def update_autotest(self, model: AdaptersAutoTestsPutRequest) -> None:
         """Function updates autotest"""
         try:
+            model.reset_layer = False
             escaped_model: AdaptersAutoTestsPutRequest = HtmlEscapeUtils.escape_html_in_object(model)
 
             logging.debug(f"Updating autotest {escaped_model}")

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/click_commands.py

@@ -1,3 +1,4 @@
+import typing
 from itertools import chain
 
 import click
@@ -71,6 +72,16 @@ _TESTRUN_LINKS_HELP = (
     '([{"url":"https://ci.example/jobs/1","title":"CI Job","type":"Related"}]). '
     "Types: Related, BlockedBy, Defect, Issue, Requirement, Repository"
 )
+_AUTOTEST_LAYER_HELP = (
+    "Default autotest pyramid layer for all imported tests "
+    "(E2E, UI, API, Contract, Integration, Component, Unit, or any string)"
+)
+
+
+def _parse_autotest_layer(raw: typing.Optional[str]) -> typing.Optional[str]:
+    if raw is None or not str(raw).strip():
+        return None
+    return str(raw).strip()
 
 
 @results.command("upload")
@@ -88,7 +99,8 @@ _TESTRUN_LINKS_HELP = (
 @click.option("-d", "--debug", is_flag=True, help="Set debug logs")
 @click.option("-dcv", "--disable-cert-validation", is_flag=True, help="Disables certificate validation")
 @click.option("-iff", "--ignore-flaky-failure", is_flag=True, help="Ignore status flakyFailure in results")
-def upload_results(url, token, configuration_id, testrun_id, testruntags, testrunlinks, separator, namespace, classname, results, debug, attachments, disable_cert_validation, ignore_flaky_failure):
+@click.option("-al", "--autotest-layer", type=str, envvar='TMS_AUTOTEST_LAYER', default=None, help=_AUTOTEST_LAYER_HELP)
+def upload_results(url, token, configuration_id, testrun_id, testruntags, testrunlinks, separator, namespace, classname, results, debug, attachments, disable_cert_validation, ignore_flaky_failure, autotest_layer):
     """Uploading results from different streams"""
     config = Config(
         url=url,
@@ -105,6 +117,7 @@ def upload_results(url, token, configuration_id, testrun_id, testruntags, testru
         paths_to_attachments=list(chain.from_iterable(attachments)),
         disable_cert_validation=disable_cert_validation,
         ignore_flaky_failure=ignore_flaky_failure,
+        autotest_layer=_parse_autotest_layer(autotest_layer),
     )
     service = ServiceFactory().get(config)
 
@@ -128,8 +141,9 @@ def upload_results(url, token, configuration_id, testrun_id, testruntags, testru
 @click.option("-d", "--debug", is_flag=True, help="Set debug logs")
 @click.option("-dcv", "--disable-cert-validation", is_flag=True, help="Disables certificate validation")
 @click.option("-iff", "--ignore-flaky-failure", is_flag=True, help="Ignore status flakyFailure in results")
+@click.option("-al", "--autotest-layer", type=str, envvar='TMS_AUTOTEST_LAYER', default=None, help=_AUTOTEST_LAYER_HELP)
 def import_results(url, token, project_id, configuration_id, testrun_id, testrun_name, testruntags, testrunlinks, separator, namespace, classname, results, debug,
-                   attachments, disable_cert_validation, ignore_flaky_failure):
+                   attachments, disable_cert_validation, ignore_flaky_failure, autotest_layer):
     """Uploading the first test results"""
     if testrun_id is not None and testrun_name is not None:
         click.echo("Illegal usage: `{}` are mutually exclusive arguments.".format(', '.join(["--testrun-id", "--testrun-name"])), err=True)
@@ -151,6 +165,7 @@ def import_results(url, token, project_id, configuration_id, testrun_id, testrun
         paths_to_attachments=list(chain.from_iterable(attachments)),
         disable_cert_validation=disable_cert_validation,
         ignore_flaky_failure=ignore_flaky_failure,
+        autotest_layer=_parse_autotest_layer(autotest_layer),
     )
     service = ServiceFactory().get(config)
 

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/converter.py

@@ -9,9 +9,11 @@ from adapters_api.model.assign_attachment_api_model import AssignAttachmentApiMo
 from adapters_api.model.attachment_api_result import AttachmentApiResult
 from adapters_api.model.attachment_put_model import AttachmentPutModel
 from adapters_api.model.auto_test_api_result import AutoTestApiResult
+from adapters_api.model.auto_test_create_api_model_layer import AutoTestCreateApiModelLayer
 from adapters_api.model.auto_test_results_for_test_run_model import AutoTestResultsForTestRunModel
 from adapters_api.model.auto_test_search_api_model_filter import AutoTestSearchApiModelFilter
 from adapters_api.model.auto_test_search_api_model_includes import AutoTestSearchApiModelIncludes
+from adapters_api.model.layer_source import LayerSource
 from adapters_api.model.link_api_result import LinkApiResult
 from adapters_api.model.test_result_short_response import TestResultShortResponse
 from adapters_api.model.test_run_api_result import TestRunApiResult
@@ -23,6 +25,15 @@ from .models.testrun import TestRun
 
 
 class Converter:
+    @staticmethod
+    def layer_to_api_model(layer_name: typing.Optional[str]) -> typing.Optional[AutoTestCreateApiModelLayer]:
+        if layer_name is None or not str(layer_name).strip():
+            return None
+        return AutoTestCreateApiModelLayer(
+            name=str(layer_name).strip(),
+            source=LayerSource("Run"),
+        )
+
     @staticmethod
     def project_id_and_external_id_to_autotests_search_post_request(
             project_id: str, external_id: str) -> AdaptersAutoTestsSearchPostRequest:
@@ -85,26 +96,41 @@ class Converter:
 
     @staticmethod
     def test_result_to_create_autotest_request(
-            result: TestCase, external_id: str, project_id: str) -> AdaptersAutoTestsPostRequest:
-        return AdaptersAutoTestsPostRequest(
-            external_id=external_id,
-            project_id=project_id,
-            name=result.get_name(),
-            namespace=result.get_name_space(),
-            classname=result.get_class_name(),
-        )
+            result: TestCase,
+            external_id: str,
+            project_id: str,
+            layer: typing.Optional[str] = None) -> AdaptersAutoTestsPostRequest:
+        request_kwargs = {
+            "external_id": external_id,
+            "project_id": project_id,
+            "name": result.get_name(),
+            "namespace": result.get_name_space(),
+            "classname": result.get_class_name(),
+        }
+        api_layer = Converter.layer_to_api_model(layer)
+        if api_layer is not None:
+            request_kwargs["layer"] = api_layer
+        return AdaptersAutoTestsPostRequest(**request_kwargs)
 
     @staticmethod
     def test_result_to_update_autotest_request(
-            result: TestCase, external_id: str, project_id: str) -> AdaptersAutoTestsPutRequest:
-        return AdaptersAutoTestsPutRequest(
-            external_id=external_id,
-            project_id=project_id,
-            name=result.get_name(),
-            namespace=result.get_name_space(),
-            classname=result.get_class_name(),
-            is_flaky=result.get_is_flaky()
-        )
+            result: TestCase,
+            external_id: str,
+            project_id: str,
+            layer: typing.Optional[str] = None) -> AdaptersAutoTestsPutRequest:
+        request_kwargs = {
+            "external_id": external_id,
+            "project_id": project_id,
+            "name": result.get_name(),
+            "namespace": result.get_name_space(),
+            "classname": result.get_class_name(),
+            "is_flaky": result.get_is_flaky(),
+            "reset_layer": False,
+        }
+        api_layer = Converter.layer_to_api_model(layer)
+        if api_layer is not None:
+            request_kwargs["layer"] = api_layer
+        return AdaptersAutoTestsPutRequest(**request_kwargs)
 
     @staticmethod
     def test_result_to_testrun_result_post_model(

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/importer.py

@@ -34,7 +34,7 @@ class Importer:
             if not autotests:
                 self.__api_client.create_autotest(
                     Converter.test_result_to_create_autotest_request(
-                        result, external_id, self.__config.project_id
+                        result, external_id, self.__config.project_id, self.__config.autotest_layer
                     )
                 )
             else:
@@ -42,7 +42,7 @@ class Importer:
 
                 self.__api_client.update_autotest(
                     Converter.test_result_to_update_autotest_request(
-                        result, external_id, self.__config.project_id
+                        result, external_id, self.__config.project_id, self.__config.autotest_layer
                     )
                 )
 

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli/models/config.py

@@ -37,3 +37,4 @@ class Config:
     disable_cert_validation: bool = False
     framework: str = ""
     ignore_flaky_failure: bool = False
+    autotest_layer: typing.Optional[str] = None

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testit-cli
-Version: 2.10.3
+Version: 2.11.0
 Summary: This tool is the command line wrapper of Test IT allowing you to upload the test results in real time to Test IT
 Home-page: https://pypi.org/project/testit-cli/
 Author: Integration team
@@ -145,3 +145,31 @@ Notes:
 - Test run tags/links are independent from autotest/result tags and links.
 - On an existing run, new tags/links are **merged** (existing values are kept; duplicates by tag name / link URL are skipped).
 - Empty or omitted values mean “do not change tags/links”.
+
+## Autotest layer (test pyramid)
+
+When importing XML results, CLI can set the **autotest** pyramid layer for every upserted autotest (create/update).  
+This is a **run-level default** for file-based import; adapters still read layer from test code annotations.
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Default autotest layer | `--autotest-layer` / `-al` | `TMS_AUTOTEST_LAYER` |
+
+Supported commands: `results import`, `results upload`.
+
+Recommended values: `E2E`, `UI`, `API`, `Contract`, `Integration`, `Component`, `Unit`. Any other non-empty string is accepted.
+
+```bash
+export TMS_AUTOTEST_LAYER=API
+testit results import \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --results ./results
+```
+
+Behaviour (aligned with adapters API):
+
+- Layer set → send `layer: { name, source: Run }` on create/update.
+- Layer not set → do not send `layer`; on update always send `resetLayer: false`.

{testit_cli-2.10.3 → testit_cli-2.11.0}/src/testit_cli.egg-info/SOURCES.txt

@@ -230,6 +230,7 @@ src/testit_cli/models/status_type.py
 src/testit_cli/models/testcase.py
 src/testit_cli/models/testrun.py
 src/testit_cli/models/testrun_link.py
+tests/test_autotest_layer.py
 tests/test_click.py
 tests/test_service.py
 tests/test_testrun_metadata.py

testit_cli-2.11.0/tests/test_autotest_layer.py

@@ -0,0 +1,44 @@
+import pytest
+from src.testit_cli.converter import Converter
+from src.testit_cli.models.testcase import TestCase
+
+
+@pytest.mark.parametrize("raw", [None, "", "  "])
+def test_layer_to_api_model_omits_when_empty(raw):
+    assert Converter.layer_to_api_model(raw) is None
+
+
+def test_layer_to_api_model_maps_name_and_run_source():
+    layer = Converter.layer_to_api_model("API")
+    assert layer is not None
+    assert layer.name == "API"
+    assert str(layer.source) == "Run"
+
+
+def test_create_autotest_request_includes_layer_when_set():
+    result = TestCase("test", "ns", "cls", 1)
+    request = Converter.test_result_to_create_autotest_request(
+        result, "ext-id", "proj-id", layer="E2E"
+    )
+    assert request.layer is not None
+    assert request.layer.name == "E2E"
+    assert str(request.layer.source) == "Run"
+
+
+def test_create_autotest_request_omits_layer_when_not_set():
+    result = TestCase("test", "ns", "cls", 1)
+    request = Converter.test_result_to_create_autotest_request(
+        result, "ext-id", "proj-id"
+    )
+    assert "layer" not in request.to_dict()
+
+
+def test_update_autotest_request_always_resets_layer_false_and_sets_layer_when_given():
+    result = TestCase("test", "ns", "cls", 1)
+    result.set_is_flaky(False)
+    request = Converter.test_result_to_update_autotest_request(
+        result, "ext-id", "proj-id", layer="API"
+    )
+    assert request.reset_layer is False
+    assert request.layer is not None
+    assert request.layer.name == "API"