testit-cli 2.10.1.post580__tar.gz → 2.10.2.post580__tar.gz

{testit_cli-2.10.1.post580/src/testit_cli.egg-info → testit_cli-2.10.2.post580}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testit-cli
-Version: 2.10.1.post580
+Version: 2.10.2.post580
 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
@@ -63,3 +63,84 @@ You can see more information in [official documentation](https://docs.testit.sof
 1. For current versions, see the releases tab.
 2. Starting with 5.2, we have added a TMS postscript, which means that the utility is compatible with a specific enterprise version.
 3. If you are in doubt about which version to use, check with the support staff. support@yoonion.ru
+
+## Test run tags and links
+
+You can attach **test run** tags and links (for example a CI job URL) via CLI flags or environment variables.  
+They are applied when the test run is **created**, or merged into an **existing** run as early as possible (not only after results upload finishes).
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Tags | `--testruntags` / `-trt` | `TMS_TEST_RUN_TAGS` |
+| Links | `--testrunlinks` / `-trl` | `TMS_TEST_RUN_LINKS` |
+
+Supported commands: `testrun create`, `results import`, `results upload`.
+
+### Tags format
+
+Comma-separated list or JSON array:
+
+```bash
+--testruntags "smoke,nightly"
+--testruntags '["smoke","nightly"]'
+```
+
+### Links format
+
+JSON array of objects. `url` is required; `title`, `description`, and `type` are optional.
+
+**Link types for a test run:**
+
+- `Related`
+- `BlockedBy`
+- `Defect`
+- `Issue`
+- `Requirement`
+- `Repository`
+
+If `type` is omitted, `Related` is used.
+
+```bash
+--testrunlinks '[{"url":"https://gitlab.example.com/group/project/-/jobs/12345","title":"CI Job","type":"Related"}]'
+```
+
+### Examples
+
+Create a test run with tags and a CI job link (visible while the run is still In progress):
+
+```bash
+testit testrun create \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --testruntags "smoke,ci" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --output ./testrun.id
+```
+
+Same via env vars:
+
+```bash
+export TMS_TEST_RUN_TAGS='smoke,ci'
+export TMS_TEST_RUN_LINKS="[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]"
+testit testrun create -u "$TMS_URL" -t "$TMS_TOKEN" -pi "$TMS_PROJECT_ID" -o ./testrun.id
+```
+
+Merge tags/links into an existing run when uploading results:
+
+```bash
+testit results upload \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --testrun-id "$TMS_TEST_RUN_ID" \
+  --testruntags "nightly" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --results ./results
+```
+
+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”.

testit_cli-2.10.2.post580/README.md

@@ -0,0 +1,113 @@
+# Test IT CLI
+
+[![Release
+Status](https://img.shields.io/pypi/v/testit-cli?style=plastic)](https://pypi.python.org/pypi/testit-cli)
+[![Downloads](https://img.shields.io/pypi/dm/testit-cli?style=plastic)](https://pypi.python.org/pypi/testit-cli)
+
+This tool is the command line wrapper of Test IT allowing you to upload the test results in real time to Test IT.
+You can see more information in [official documentation](https://docs.testit.software/user-guide/integrations/cli.html)
+
+## Compatibility
+
+| Test IT | Test IT CLI    |
+|---------|----------------|
+| 3.5+    | 0.1            |
+| 4.4     | 1.0            |
+| 4.5     | 1.2            |
+| 4.6     | 1.5            |
+| 5.0     | 2.0            |
+| 5.2     | 2.1            |
+| 5.2.2   | 2.2.1.post522  |
+| 5.2.3   | 2.3.0.post523  |
+| 5.3     | 2.4.5.post530  |
+| 5.4     | 2.4.11.post540 |
+| 5.5     | 2.7.2.post550  |
+| 5.6     | 2.8.1.post560  |
+| 5.7     | 2.9.1.post570  |
+| 5.8     | 2.10.0.post580 |
+| Cloud   | 2.8.0 +        |
+
+1. For current versions, see the releases tab.
+2. Starting with 5.2, we have added a TMS postscript, which means that the utility is compatible with a specific enterprise version.
+3. If you are in doubt about which version to use, check with the support staff. support@yoonion.ru
+
+## Test run tags and links
+
+You can attach **test run** tags and links (for example a CI job URL) via CLI flags or environment variables.  
+They are applied when the test run is **created**, or merged into an **existing** run as early as possible (not only after results upload finishes).
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Tags | `--testruntags` / `-trt` | `TMS_TEST_RUN_TAGS` |
+| Links | `--testrunlinks` / `-trl` | `TMS_TEST_RUN_LINKS` |
+
+Supported commands: `testrun create`, `results import`, `results upload`.
+
+### Tags format
+
+Comma-separated list or JSON array:
+
+```bash
+--testruntags "smoke,nightly"
+--testruntags '["smoke","nightly"]'
+```
+
+### Links format
+
+JSON array of objects. `url` is required; `title`, `description`, and `type` are optional.
+
+**Link types for a test run:**
+
+- `Related`
+- `BlockedBy`
+- `Defect`
+- `Issue`
+- `Requirement`
+- `Repository`
+
+If `type` is omitted, `Related` is used.
+
+```bash
+--testrunlinks '[{"url":"https://gitlab.example.com/group/project/-/jobs/12345","title":"CI Job","type":"Related"}]'
+```
+
+### Examples
+
+Create a test run with tags and a CI job link (visible while the run is still In progress):
+
+```bash
+testit testrun create \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --testruntags "smoke,ci" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --output ./testrun.id
+```
+
+Same via env vars:
+
+```bash
+export TMS_TEST_RUN_TAGS='smoke,ci'
+export TMS_TEST_RUN_LINKS="[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]"
+testit testrun create -u "$TMS_URL" -t "$TMS_TOKEN" -pi "$TMS_PROJECT_ID" -o ./testrun.id
+```
+
+Merge tags/links into an existing run when uploading results:
+
+```bash
+testit results upload \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --testrun-id "$TMS_TEST_RUN_ID" \
+  --testruntags "nightly" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --results ./results
+```
+
+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”.

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/setup.py

@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "2.10.1.post580"
+VERSION = "2.10.2.post580"
 
 setup(
     name='testit-cli',

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/apiclient.py

@@ -55,9 +55,20 @@ class ApiClient:
         self.__projects_api = ProjectsApi(api_client=client)
         self.__workflows_api = WorkflowsApi(api_client=client)
 
-    def create_test_run(self, project_id: str, name: str) -> TestRun:
+    def create_test_run(
+        self,
+        project_id: str,
+        name: str,
+        tags: typing.Optional[typing.List[str]] = None,
+        links: typing.Optional[typing.List] = None,
+    ) -> TestRun:
         """Function creates test run and returns test run id."""
-        model = CreateEmptyRequest(project_id=project_id, name=name)
+        create_kwargs = {"project_id": project_id, "name": name}
+        if tags:
+            create_kwargs["tags"] = tags
+        if links:
+            create_kwargs["links"] = links
+        model = CreateEmptyRequest(**create_kwargs)
         model = HtmlEscapeUtils.escape_html_in_object(model)
         logging.debug(f"Creating test run with model: {model}")
 
@@ -67,6 +78,13 @@ class ApiClient:
         )
 
         logging.info(f'Created new testrun (ID: {test_run.id})')
+        if tags or links:
+            logging.info(
+                "Applied tags/links on create for testrun (ID: %s): tags=%s links=%s",
+                test_run.id,
+                tags,
+                links,
+            )
         logging.debug(f"Test run created: {test_run}")
 
         return Converter.test_run_v2_get_model_to_test_run(test_run)

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/click_commands.py

@@ -4,6 +4,7 @@ from itertools import chain
 
 from .models.config import Config
 from .service_factory import ServiceFactory
+from .testrun_metadata import parse_testrun_links, parse_testrun_tags
 from .validation import validate_uuid, validate_url
 
 
@@ -61,11 +62,24 @@ class ExtraArgsForOption(click.Option):
         return retval
 
 
+_TESTRUN_TAGS_HELP = (
+    "Test run tags: comma-separated or JSON array "
+    "(smoke,nightly or [\"smoke\",\"nightly\"])"
+)
+_TESTRUN_LINKS_HELP = (
+    "Test run links as JSON array "
+    '([{"url":"https://ci.example/jobs/1","title":"CI Job","type":"Related"}]). '
+    "Types: Related, BlockedBy, Defect, Issue, Requirement, Repository"
+)
+
+
 @results.command("upload")
 @click.option("-u", "--url", type=str, envvar='TMS_URL', required=True, help="Set url address of the Test IT instance (https://demo.testit.software)", callback=validate_url)
 @click.option("-t", "--token", type=str, envvar='TMS_TOKEN', required=True, help="Set API token (T2lKd2pLZGI4WHRhaVZUejNl)")
 @click.option("-ci", "--configuration-id", type=str, envvar='TMS_CONFIGURATION_ID', required=True, help="Set configuration id (15dbb164-c1aa-4cbf-830c-8c01ae14f4fb)", callback=validate_uuid)
 @click.option("-ti", "--testrun-id", type=str, envvar='TMS_TEST_RUN_ID', required=True, help="Set test run id (3802f329-190c-4617-8bb0-2c3696abeb8f)", callback=validate_uuid)
+@click.option("-trt", "--testruntags", type=str, envvar='TMS_TEST_RUN_TAGS', default=None, help=_TESTRUN_TAGS_HELP)
+@click.option("-trl", "--testrunlinks", type=str, envvar='TMS_TEST_RUN_LINKS', default=None, help=_TESTRUN_LINKS_HELP)
 @click.option("-s", "--separator", type=str, help="Separate the classname value in the results into namespace and classname (.)", default=None)
 @click.option("-ns", "--namespace", type=str, help="Set namespace (NameSpace01)", default=None)
 @click.option("-cn", "--classname", type=str, help="Set classname (ClassName01)", default=None)
@@ -74,13 +88,15 @@ class ExtraArgsForOption(click.Option):
 @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, separator, namespace, classname, results, debug, attachments, disable_cert_validation, ignore_flaky_failure):
+def upload_results(url, token, configuration_id, testrun_id, testruntags, testrunlinks, separator, namespace, classname, results, debug, attachments, disable_cert_validation, ignore_flaky_failure):
     """Uploading results from different streams"""
     config = Config(
         url=url,
         token=token,
         configuration_id=configuration_id,
         testrun_id=testrun_id,
+        testrun_tags=parse_testrun_tags(testruntags),
+        testrun_links=parse_testrun_links(testrunlinks),
         separator=separator,
         namespace=namespace,
         classname=classname,
@@ -102,6 +118,8 @@ def upload_results(url, token, configuration_id, testrun_id, separator, namespac
 @click.option("-ci", "--configuration-id", type=str, envvar='TMS_CONFIGURATION_ID', required=True, help="Set configuration id (15dbb164-c1aa-4cbf-830c-8c01ae14f4fb)", callback=validate_uuid)
 @click.option("-ti", "--testrun-id", type=str, envvar='TMS_TEST_RUN_ID', help="Set test run id (3802f329-190c-4617-8bb0-2c3696abeb8f)", default=None, callback=validate_uuid)
 @click.option("-tn", "--testrun-name", type=str, envvar='TMS_TEST_RUN_NAME', help="Set test run name (TestRun01)", default=None)
+@click.option("-trt", "--testruntags", type=str, envvar='TMS_TEST_RUN_TAGS', default=None, help=_TESTRUN_TAGS_HELP)
+@click.option("-trl", "--testrunlinks", type=str, envvar='TMS_TEST_RUN_LINKS', default=None, help=_TESTRUN_LINKS_HELP)
 @click.option("-s", "--separator", type=str, help="Separate the classname value in the results into namespace and classname (.)", default=None)
 @click.option("-ns", "--namespace", type=str, help="Set namespace (NameSpace01)", default=None)
 @click.option("-cn", "--classname", type=str, help="Set classname (ClassName01)", default=None)
@@ -110,7 +128,7 @@ def upload_results(url, token, configuration_id, testrun_id, separator, namespac
 @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 import_results(url, token, project_id, configuration_id, testrun_id, testrun_name, separator, namespace, classname, results, debug,
+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):
     """Uploading the first test results"""
     if testrun_id is not None and testrun_name is not None:
@@ -123,6 +141,8 @@ def import_results(url, token, project_id, configuration_id, testrun_id, testrun
         configuration_id=configuration_id,
         testrun_id=testrun_id,
         testrun_name=testrun_name,
+        testrun_tags=parse_testrun_tags(testruntags),
+        testrun_links=parse_testrun_links(testrunlinks),
         separator=separator,
         namespace=namespace,
         classname=classname,
@@ -148,17 +168,21 @@ def testrun():
 @click.option("-t", "--token", type=str, envvar='TMS_TOKEN', required=True, help="Set API token (T2lKd2pLZGI4WHRhaVZUejNl)")
 @click.option("-pi", "--project-id", type=str, envvar='TMS_PROJECT_ID', required=True, help="Set project id (5236eb3f-7c05-46f9-a609-dc0278896464)", callback=validate_uuid)
 @click.option("-tn", "--testrun-name", type=str, envvar='TMS_TEST_RUN_NAME', help="Set test run name (TestRun01)", default=None)
+@click.option("-trt", "--testruntags", type=str, envvar='TMS_TEST_RUN_TAGS', default=None, help=_TESTRUN_TAGS_HELP)
+@click.option("-trl", "--testrunlinks", type=str, envvar='TMS_TEST_RUN_LINKS', default=None, help=_TESTRUN_LINKS_HELP)
 @click.option("-o", "--output", type=str, required=True, help="Set file path for output (FILE)")
 @click.option("-a", "--attachments", multiple=True, type=list, help="Path to attachments for test run (multiple)", default=[], cls=ExtraArgsForOption)
 @click.option("-d", "--debug", is_flag=True, help="Set debug logs")
 @click.option("-dcv", "--disable-cert-validation", is_flag=True, help="Disables certificate validation")
-def create_test_run(url, token, project_id, testrun_name, output, debug, attachments, disable_cert_validation):
+def create_test_run(url, token, project_id, testrun_name, testruntags, testrunlinks, output, debug, attachments, disable_cert_validation):
     """Creating a new test run"""
     config = Config(
         url=url,
         token=token,
         project_id=project_id,
         testrun_name=testrun_name,
+        testrun_tags=parse_testrun_tags(testruntags),
+        testrun_links=parse_testrun_links(testrunlinks),
         is_debug=debug,
         output=output,
         paths_to_attachments=list(chain.from_iterable(attachments)),

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/converter.py

@@ -137,7 +137,8 @@ class Converter:
             description=test_run_model.description,
             launch_source=test_run_model.launch_source,
             attachments=cls.attachment_models_to_attachment_put_models(test_run_model.attachments),
-            links=cls.link_models_to_link_put_models(test_run_model.links)
+            links=cls.link_models_to_link_put_models(test_run_model.links),
+            tags=list(test_run_model.tags) if test_run_model.tags else [],
         )
 
     @classmethod
@@ -199,5 +200,6 @@ class Converter:
             description=test_run.description,
             launch_source=test_run.launch_source,
             attachments=test_run.attachments,
-            links=test_run.links
+            links=test_run.links,
+            tags=test_run.tags,
         )

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/models/config.py

@@ -1,6 +1,8 @@
 from dataclasses import dataclass, field
 import typing
 
+from .testrun_link import TestRunLink
+
 
 @dataclass
 class Config:
@@ -15,6 +17,8 @@ class Config:
     configuration_ids: typing.Optional[list[str]] = None
     testrun_id: typing.Optional[str] = None
     testrun_name: typing.Optional[str] = None
+    testrun_tags: typing.Optional[list[str]] = None
+    testrun_links: typing.Optional[list[TestRunLink]] = None
     separator: typing.Optional[str] = None
     namespace: typing.Optional[str] = None
     classname: typing.Optional[str] = None

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/models/testrun.py

@@ -1,4 +1,4 @@
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import List
 from testit_api_client.model.assign_attachment_api_model import AssignAttachmentApiModel
 from testit_api_client.model.link_put_model import LinkPutModel
@@ -14,3 +14,4 @@ class TestRun:
     launch_source: str
     attachments: List[AssignAttachmentApiModel]
     links: List[LinkPutModel]
+    tags: List[str] = field(default_factory=list)

testit_cli-2.10.2.post580/src/testit_cli/models/testrun_link.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class TestRunLink:
+    url: str
+    title: Optional[str] = None
+    description: Optional[str] = None
+    link_type: Optional[str] = None

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli/service.py

@@ -13,6 +13,7 @@ from .apiclient import ApiClient
 from .dir_worker import DirWorker
 from .file_worker import FileWorker
 from .importer import Importer
+from .testrun_metadata import merge_links, merge_tags, to_create_link_models, to_link_put_models
 
 
 class Service:
@@ -72,9 +73,32 @@ class Service:
     def __create_test_run(self) -> TestRun:
         return self.__api_client.create_test_run(
             self.__config.project_id,
-            self.__config.testrun_name
+            self.__config.testrun_name,
+            tags=self.__config.testrun_tags,
+            links=to_create_link_models(self.__config.testrun_links),
         )
 
+    def __merge_configured_metadata(self, test_run: TestRun) -> None:
+        test_run.tags = merge_tags(test_run.tags, self.__config.testrun_tags)
+        test_run.links = merge_links(
+            test_run.links,
+            to_link_put_models(self.__config.testrun_links),
+        )
+
+    def __apply_testrun_tags_and_links(self, test_run: TestRun) -> TestRun:
+        if not self.__config.testrun_tags and not self.__config.testrun_links:
+            return test_run
+
+        self.__merge_configured_metadata(test_run)
+        self.__api_client.update_test_run(test_run)
+        logging.info(
+            "Merged tags/links into testrun (ID: %s): tags=%s links=%s",
+            test_run.id,
+            self.__config.testrun_tags,
+            self.__config.testrun_links,
+        )
+        return test_run
+
     def __upload_attachments(self) -> list[AttachmentPutModel]:
         files = []
 
@@ -94,6 +118,7 @@ class Service:
         else:
             test_run = self.__api_client.get_test_run(self.__config.testrun_id)
             self.__config.project_id = test_run.project_id
+            test_run = self.__apply_testrun_tags_and_links(test_run)
 
         logging.info("Sending test results to Test IT ...")
 
@@ -104,6 +129,7 @@ class Service:
         logging.info("Successfully sent test results")
 
     def __update_test_run_with_attachments(self, test_run: TestRun) -> None:
+        self.__merge_configured_metadata(test_run)
         attachments: typing.List[AssignAttachmentApiModel] = Converter.attachment_put_models_to_assign_attachments(
             self.__upload_attachments())
         test_run.attachments.extend(attachments)

testit_cli-2.10.2.post580/src/testit_cli/testrun_metadata.py

@@ -0,0 +1,131 @@
+"""Parse and merge test run tags/links (config → API)."""
+import json
+import logging
+from typing import List, Optional
+
+from testit_api_client.model.create_link_api_model import CreateLinkApiModel
+from testit_api_client.model.link_put_model import LinkPutModel
+from testit_api_client.model.link_type import LinkType
+
+from .models.testrun_link import TestRunLink
+
+LINK_TYPES = ("Related", "BlockedBy", "Defect", "Issue", "Requirement", "Repository")
+
+
+def parse_testrun_tags(raw: Optional[str]) -> Optional[List[str]]:
+    if raw is None or not str(raw).strip():
+        return None
+    text = str(raw).strip()
+    if text.startswith("["):
+        try:
+            data = json.loads(text)
+        except json.JSONDecodeError as exc:
+            logging.warning("Invalid test run tags JSON: %s", exc)
+            return None
+        if not isinstance(data, list):
+            logging.warning("Test run tags JSON must be an array of strings")
+            return None
+        tags = [str(item).strip() for item in data if str(item).strip()]
+        return tags or None
+    tags = [part.strip() for part in text.split(",") if part.strip()]
+    return tags or None
+
+
+def parse_testrun_links(raw: Optional[str]) -> Optional[List[TestRunLink]]:
+    if raw is None or not str(raw).strip():
+        return None
+    try:
+        data = json.loads(str(raw).strip())
+    except json.JSONDecodeError as exc:
+        logging.warning("Invalid test run links JSON: %s", exc)
+        return None
+    if not isinstance(data, list):
+        logging.warning("Test run links JSON must be an array of objects")
+        return None
+    links = []
+    for item in data:
+        if not isinstance(item, dict):
+            logging.warning("Skipping invalid test run link entry: %s", item)
+            continue
+        url = item.get("url")
+        if not url or not str(url).strip():
+            logging.warning("Skipping test run link without url: %s", item)
+            continue
+        link_type = item.get("type")
+        if link_type is not None and str(link_type) not in LINK_TYPES:
+            logging.warning(
+                "Unknown link type %r; allowed: %s. Using Related.",
+                link_type,
+                ", ".join(LINK_TYPES),
+            )
+            link_type = "Related"
+        links.append(
+            TestRunLink(
+                url=str(url).strip(),
+                title=item.get("title"),
+                description=item.get("description"),
+                link_type=str(link_type) if link_type is not None else None,
+            )
+        )
+    return links or None
+
+
+def _to_link_type(value: Optional[str]) -> LinkType:
+    name = value or "Related"
+    try:
+        return LinkType(name)
+    except Exception:
+        return LinkType("Related")
+
+
+def to_create_link_models(links: Optional[List[TestRunLink]]) -> Optional[List[CreateLinkApiModel]]:
+    if not links:
+        return None
+    return [
+        CreateLinkApiModel(
+            url=link.url,
+            title=link.title,
+            description=link.description,
+            type=_to_link_type(link.link_type),
+            has_info=False,
+        )
+        for link in links
+    ]
+
+
+def to_link_put_models(links: Optional[List[TestRunLink]]) -> List[LinkPutModel]:
+    if not links:
+        return []
+    return [
+        LinkPutModel(
+            url=link.url,
+            title=link.title,
+            description=link.description,
+            type=_to_link_type(link.link_type),
+            has_info=False,
+        )
+        for link in links
+    ]
+
+
+def merge_tags(existing: Optional[List[str]], incoming: Optional[List[str]]) -> List[str]:
+    result = list(existing or [])
+    seen = set(result)
+    for tag in incoming or []:
+        if tag not in seen:
+            result.append(tag)
+            seen.add(tag)
+    return result
+
+
+def merge_links(
+    existing: Optional[List[LinkPutModel]],
+    incoming: Optional[List[LinkPutModel]],
+) -> List[LinkPutModel]:
+    result = list(existing or [])
+    seen = {link.url for link in result}
+    for link in incoming or []:
+        if link.url not in seen:
+            result.append(link)
+            seen.add(link.url)
+    return result

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580/src/testit_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testit-cli
-Version: 2.10.1.post580
+Version: 2.10.2.post580
 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
@@ -63,3 +63,84 @@ You can see more information in [official documentation](https://docs.testit.sof
 1. For current versions, see the releases tab.
 2. Starting with 5.2, we have added a TMS postscript, which means that the utility is compatible with a specific enterprise version.
 3. If you are in doubt about which version to use, check with the support staff. support@yoonion.ru
+
+## Test run tags and links
+
+You can attach **test run** tags and links (for example a CI job URL) via CLI flags or environment variables.  
+They are applied when the test run is **created**, or merged into an **existing** run as early as possible (not only after results upload finishes).
+
+| Intent | CLI | Env |
+|--------|-----|-----|
+| Tags | `--testruntags` / `-trt` | `TMS_TEST_RUN_TAGS` |
+| Links | `--testrunlinks` / `-trl` | `TMS_TEST_RUN_LINKS` |
+
+Supported commands: `testrun create`, `results import`, `results upload`.
+
+### Tags format
+
+Comma-separated list or JSON array:
+
+```bash
+--testruntags "smoke,nightly"
+--testruntags '["smoke","nightly"]'
+```
+
+### Links format
+
+JSON array of objects. `url` is required; `title`, `description`, and `type` are optional.
+
+**Link types for a test run:**
+
+- `Related`
+- `BlockedBy`
+- `Defect`
+- `Issue`
+- `Requirement`
+- `Repository`
+
+If `type` is omitted, `Related` is used.
+
+```bash
+--testrunlinks '[{"url":"https://gitlab.example.com/group/project/-/jobs/12345","title":"CI Job","type":"Related"}]'
+```
+
+### Examples
+
+Create a test run with tags and a CI job link (visible while the run is still In progress):
+
+```bash
+testit testrun create \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --testruntags "smoke,ci" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --output ./testrun.id
+```
+
+Same via env vars:
+
+```bash
+export TMS_TEST_RUN_TAGS='smoke,ci'
+export TMS_TEST_RUN_LINKS="[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]"
+testit testrun create -u "$TMS_URL" -t "$TMS_TOKEN" -pi "$TMS_PROJECT_ID" -o ./testrun.id
+```
+
+Merge tags/links into an existing run when uploading results:
+
+```bash
+testit results upload \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --testrun-id "$TMS_TEST_RUN_ID" \
+  --testruntags "nightly" \
+  --testrunlinks "[{\"url\":\"$CI_JOB_URL\",\"title\":\"CI Job\",\"type\":\"Related\"}]" \
+  --results ./results
+```
+
+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”.

{testit_cli-2.10.1.post580 → testit_cli-2.10.2.post580}/src/testit_cli.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ src/testit_cli/logger.py
 src/testit_cli/parser.py
 src/testit_cli/service.py
 src/testit_cli/service_factory.py
+src/testit_cli/testrun_metadata.py
 src/testit_cli/validation.py
 src/testit_cli.egg-info/PKG-INFO
 src/testit_cli.egg-info/SOURCES.txt
@@ -30,5 +31,7 @@ src/testit_cli/models/mode.py
 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_click.py
-tests/test_service.py
+tests/test_service.py
+tests/test_testrun_metadata.py

testit_cli-2.10.2.post580/tests/test_testrun_metadata.py

@@ -0,0 +1,151 @@
+from unittest.mock import Mock
+
+import pytest
+from testit_api_client.model.link_put_model import LinkPutModel
+from testit_api_client.model.link_type import LinkType
+
+from src.testit_cli.models.testrun import TestRun
+from src.testit_cli.models.testrun_link import TestRunLink
+from src.testit_cli.service import Service
+from src.testit_cli.testrun_metadata import (
+    merge_links,
+    merge_tags,
+    parse_testrun_links,
+    parse_testrun_tags,
+    to_create_link_models,
+)
+
+
+@pytest.mark.parametrize(
+    "raw, expected",
+    [
+        (None, None),
+        ("", None),
+        ("  ", None),
+        ("smoke, nightly", ["smoke", "nightly"]),
+        ('["smoke", "nightly"]', ["smoke", "nightly"]),
+        ("smoke", ["smoke"]),
+    ],
+)
+def test_parse_testrun_tags(raw, expected):
+    assert parse_testrun_tags(raw) == expected
+
+
+def test_parse_testrun_tags_invalid_json_array():
+    assert parse_testrun_tags("[") is None
+
+
+def test_parse_testrun_links_ok():
+    raw = (
+        '[{"url":"https://ci.example/jobs/1","title":"CI Job","type":"Related"},'
+        '{"url":"https://ci.example/jobs/2"}]'
+    )
+    links = parse_testrun_links(raw)
+    assert links == [
+        TestRunLink(
+            url="https://ci.example/jobs/1",
+            title="CI Job",
+            description=None,
+            link_type="Related",
+        ),
+        TestRunLink(
+            url="https://ci.example/jobs/2",
+            title=None,
+            description=None,
+            link_type=None,
+        ),
+    ]
+
+
+@pytest.mark.parametrize("raw", [None, "", "not-json", "{}", '[{"title":"x"}]'])
+def test_parse_testrun_links_invalid(raw):
+    assert parse_testrun_links(raw) is None
+
+
+def test_merge_tags_and_links_dedupe():
+    assert merge_tags(["a"], ["a", "b"]) == ["a", "b"]
+    related = LinkType("Related")
+    existing = [LinkPutModel(url="https://a", type=related, has_info=False)]
+    incoming = [
+        LinkPutModel(url="https://a", type=related, has_info=False),
+        LinkPutModel(url="https://b", type=related, has_info=False),
+    ]
+    merged = merge_links(existing, incoming)
+    assert [link.url for link in merged] == ["https://a", "https://b"]
+
+
+def test_to_create_link_models_defaults_type():
+    models = to_create_link_models([TestRunLink(url="https://ci.example/1")])
+    assert models is not None
+    assert len(models) == 1
+    assert models[0].url == "https://ci.example/1"
+    assert str(models[0].type) == "Related"
+
+
+def test_create_test_run_passes_tags_and_links():
+    api_client = Mock()
+    api_client.create_test_run.return_value = TestRun(
+        id="run-1",
+        project_id="proj-1",
+        state="InProgress",
+        name="Run",
+        description="",
+        launch_source="",
+        attachments=[],
+        links=[],
+        tags=["smoke"],
+    )
+    api_client.upload_attachments.return_value = []
+    config = Mock(
+        project_id="proj-1",
+        testrun_name="Run",
+        testrun_tags=["smoke"],
+        testrun_links=[TestRunLink(url="https://ci.example/1", title="CI", link_type="Related")],
+        paths_to_attachments=[],
+        output="out.txt",
+    )
+    service = Service(config, api_client, Mock(), Mock(), Mock())
+    service._Service__write_to_output = Mock()
+
+    service.create_test_run()
+
+    kwargs = api_client.create_test_run.call_args.kwargs
+    assert kwargs["tags"] == ["smoke"]
+    assert kwargs["links"] is not None
+    assert kwargs["links"][0].url == "https://ci.example/1"
+
+
+def test_upload_results_merges_tags_and_links_early():
+    related = LinkType("Related")
+    existing = TestRun(
+        id="run-1",
+        project_id="proj-1",
+        state="InProgress",
+        name="Run",
+        description="",
+        launch_source="",
+        attachments=[],
+        links=[LinkPutModel(url="https://existing", type=related, has_info=False)],
+        tags=["ui"],
+    )
+    api_client = Mock()
+    api_client.get_test_run.return_value = existing
+    api_client.upload_attachments.return_value = []
+    parser = Mock()
+    parser.read_file.return_value = []
+    importer = Mock()
+    config = Mock(
+        testrun_id="run-1",
+        testrun_tags=["smoke"],
+        testrun_links=[TestRunLink(url="https://ci.example/1")],
+        paths_to_attachments=[],
+        project_id=None,
+    )
+    service = Service(config, api_client, parser, importer, Mock())
+
+    service.upload_results()
+
+    assert api_client.update_test_run.call_count >= 1
+    first_update = api_client.update_test_run.call_args_list[0].args[0]
+    assert first_update.tags == ["ui", "smoke"]
+    assert [link.url for link in first_update.links] == ["https://existing", "https://ci.example/1"]

testit_cli-2.10.1.post580/README.md

@@ -1,32 +0,0 @@
-# Test IT CLI
-
-[![Release
-Status](https://img.shields.io/pypi/v/testit-cli?style=plastic)](https://pypi.python.org/pypi/testit-cli)
-[![Downloads](https://img.shields.io/pypi/dm/testit-cli?style=plastic)](https://pypi.python.org/pypi/testit-cli)
-
-This tool is the command line wrapper of Test IT allowing you to upload the test results in real time to Test IT.
-You can see more information in [official documentation](https://docs.testit.software/user-guide/integrations/cli.html)
-
-## Compatibility
-
-| Test IT | Test IT CLI    |
-|---------|----------------|
-| 3.5+    | 0.1            |
-| 4.4     | 1.0            |
-| 4.5     | 1.2            |
-| 4.6     | 1.5            |
-| 5.0     | 2.0            |
-| 5.2     | 2.1            |
-| 5.2.2   | 2.2.1.post522  |
-| 5.2.3   | 2.3.0.post523  |
-| 5.3     | 2.4.5.post530  |
-| 5.4     | 2.4.11.post540 |
-| 5.5     | 2.7.2.post550  |
-| 5.6     | 2.8.1.post560  |
-| 5.7     | 2.9.1.post570  |
-| 5.8     | 2.10.0.post580 |
-| Cloud   | 2.8.0 +        |
-
-1. For current versions, see the releases tab.
-2. Starting with 5.2, we have added a TMS postscript, which means that the utility is compatible with a specific enterprise version.
-3. If you are in doubt about which version to use, check with the support staff. support@yoonion.ru