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

testit_cli-2.10.2/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: testit-cli
+Version: 2.10.2
+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
+Author-email: integrations@testit.software
+License: Apache-2.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: testit-api-client==7.5.12
+Requires-Dist: validators
+Requires-Dist: tqdm
+Requires-Dist: click~=8.0.4
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# 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.2/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}/setup.py

@@ -1,6 +1,15 @@
 from setuptools import find_packages, setup
 
-VERSION = "2.10.1.post580"
+VERSION = "2.10.2"
+
+ADAPTERS_ROOT = "src/testit_cli/adapters_api"
+ADAPTERS_PACKAGES = ["adapters_api"] + [
+    f"adapters_api.{pkg}" for pkg in find_packages(where=ADAPTERS_ROOT)
+]
+CLI_PACKAGES = [
+    pkg for pkg in find_packages(where="src")
+    if not pkg.startswith("testit_cli.adapters_api")
+]
 
 setup(
     name='testit-cli',
@@ -24,9 +33,12 @@ setup(
         'Programming Language :: Python :: 3.12',
     ],
     py_modules=['testit_cli'],
-    packages=find_packages(where='src'),
-    package_dir={'': 'src'},
-    install_requires=['testit-api-client==7.6.1.post580', 'validators', 'tqdm', 'click~=8.0.4'],
+    packages=CLI_PACKAGES + ADAPTERS_PACKAGES,
+    package_dir={
+        '': 'src',
+        'adapters_api': ADAPTERS_ROOT,
+    },
+    install_requires=['testit-api-client==7.5.12', 'validators', 'tqdm', 'click~=8.0.4'],
     entry_points={
         'console_scripts': [
             'testit = testit_cli.__main__:console_main'

testit_cli-2.10.2/src/testit_cli/__init__.py

@@ -0,0 +1,30 @@
+"""Register vendored OpenAPI client as package name ``adapters_api``."""
+import importlib.util
+import sys
+from pathlib import Path
+
+
+def _ensure_adapters_api() -> None:
+    if "adapters_api" in sys.modules:
+        return
+    try:
+        import adapters_api  # noqa: F401
+        return
+    except ImportError:
+        pass
+
+    adapters_dir = Path(__file__).resolve().parent / "adapters_api"
+    init_file = adapters_dir / "__init__.py"
+    spec = importlib.util.spec_from_file_location(
+        "adapters_api",
+        init_file,
+        submodule_search_locations=[str(adapters_dir)],
+    )
+    if spec is None or spec.loader is None:
+        raise ImportError(f"Cannot load adapters_api from {adapters_dir}")
+    module = importlib.util.module_from_spec(spec)
+    sys.modules["adapters_api"] = module
+    spec.loader.exec_module(module)
+
+
+_ensure_adapters_api()

testit_cli-2.10.2/src/testit_cli/adapters_api/__init__.py

@@ -0,0 +1,27 @@
+# flake8: noqa
+
+"""
+    API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)  # noqa: E501
+
+    The version of the OpenAPI document: adapters
+    Generated by: https://openapi-generator.tech
+"""
+
+
+__version__ = "1.0.0"
+
+# import ApiClient
+from adapters_api.api_client import ApiClient
+
+# import Configuration
+from adapters_api.configuration import Configuration
+
+# import exceptions
+from adapters_api.exceptions import OpenApiException
+from adapters_api.exceptions import ApiAttributeError
+from adapters_api.exceptions import ApiTypeError
+from adapters_api.exceptions import ApiValueError
+from adapters_api.exceptions import ApiKeyError
+from adapters_api.exceptions import ApiException

testit_cli-2.10.2/src/testit_cli/adapters_api/api/__init__.py

@@ -0,0 +1,3 @@
+# do not import all apis into this module because that uses a lot of memory and stack frames
+# if you need the ability to import all apis from one package, import them with
+# from adapters_api.apis import AttachmentsApi