testit-cli 2.10.3.post580__tar.gz → 2.10.4.post600__tar.gz

{testit_cli-2.10.3.post580 → testit_cli-2.10.4.post600}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testit-cli
-Version: 2.10.3.post580
+Version: 2.10.4.post600
 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
@@ -16,10 +16,11 @@ 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.6.1.post580
 Requires-Dist: validators
 Requires-Dist: tqdm
 Requires-Dist: click~=8.0.4
+Requires-Dist: urllib3>=2.6.0
+Requires-Dist: python-dateutil
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -58,12 +59,75 @@ You can see more information in [official documentation](https://docs.testit.sof
 | 5.6     | 2.8.1.post560  |
 | 5.7     | 2.9.1.post570  |
 | 5.8     | 2.10.0.post580 |
+| 6.0     | 2.10.4.post600 |
 | 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
 
+## Launch a filled test run (`testrun create launch`)
+
+Unlike `testrun create` (empty run), `testrun create launch` creates a **filled** test run.
+
+Provide **exactly one** source:
+
+| Source            | Flag                                   | Behaviour                                         |
+|-------------------|----------------------------------------|---------------------------------------------------|
+| Test plan         | `--test-plan-id` / `-tpi`              | Search automated test points in the TMS test plan |
+| Tags              | `--filter tags=smoke,nightly`          | Search autotests in TMS                           |
+| External IDs file | `--autotest-external-ids-file` / `-af` | One external ID per line in file                  |
+
+Required: `--url`, `--token`, `--project-id`, `--configuration-id`. Optional: `--testrun-name`, `--output` (also write ID to a file).
+
+The command prints `testRunId` to **stdout** (suitable for `export TMS_TEST_RUN_ID=$(...)`).
+
+```bash
+export TMS_TEST_RUN_ID=$(testit testrun create launch \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --filter tags=smoke \
+  --testrun-name "CI smoke")
+```
+
+From a test plan:
+
+```bash
+testit testrun create launch \
+  -u "$TMS_URL" -t "$TMS_TOKEN" \
+  -pi "$TMS_PROJECT_ID" -ci "$TMS_CONFIGURATION_ID" \
+  --test-plan-id "$TMS_TEST_PLAN_ID" \
+  -o ./testrun.id
+```
+
+### Autotest external IDs file
+
+`--autotest-external-ids-file` / `-af` expects a plain-text file of **autotest external IDs** (the same values as in TMS / `autoTestExternalIds`, not internal UUIDs or global IDs):
+
+- one external ID per line;
+- empty lines are ignored;
+- lines starting with `#` are comments;
+- duplicate IDs are ignored.
+
+Example `autotest-external-ids.txt`:
+
+```text
+# smoke suite
+login-test-ext-id
+checkout-test-ext-id
+
+payment-test-ext-id
+```
+
+```bash
+testit testrun create launch \
+  -u "$TMS_URL" -t "$TMS_TOKEN" \
+  -pi "$TMS_PROJECT_ID" -ci "$TMS_CONFIGURATION_ID" \
+  -af ./autotest-external-ids.txt
+```
+
 ## 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.  
@@ -144,3 +208,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.post580 → testit_cli-2.10.4.post600}/README.md

@@ -25,12 +25,75 @@ You can see more information in [official documentation](https://docs.testit.sof
 | 5.6     | 2.8.1.post560  |
 | 5.7     | 2.9.1.post570  |
 | 5.8     | 2.10.0.post580 |
+| 6.0     | 2.10.4.post600 |
 | 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
 
+## Launch a filled test run (`testrun create launch`)
+
+Unlike `testrun create` (empty run), `testrun create launch` creates a **filled** test run.
+
+Provide **exactly one** source:
+
+| Source            | Flag                                   | Behaviour                                         |
+|-------------------|----------------------------------------|---------------------------------------------------|
+| Test plan         | `--test-plan-id` / `-tpi`              | Search automated test points in the TMS test plan |
+| Tags              | `--filter tags=smoke,nightly`          | Search autotests in TMS                           |
+| External IDs file | `--autotest-external-ids-file` / `-af` | One external ID per line in file                  |
+
+Required: `--url`, `--token`, `--project-id`, `--configuration-id`. Optional: `--testrun-name`, `--output` (also write ID to a file).
+
+The command prints `testRunId` to **stdout** (suitable for `export TMS_TEST_RUN_ID=$(...)`).
+
+```bash
+export TMS_TEST_RUN_ID=$(testit testrun create launch \
+  --url "$TMS_URL" \
+  --token "$TMS_TOKEN" \
+  --project-id "$TMS_PROJECT_ID" \
+  --configuration-id "$TMS_CONFIGURATION_ID" \
+  --filter tags=smoke \
+  --testrun-name "CI smoke")
+```
+
+From a test plan:
+
+```bash
+testit testrun create launch \
+  -u "$TMS_URL" -t "$TMS_TOKEN" \
+  -pi "$TMS_PROJECT_ID" -ci "$TMS_CONFIGURATION_ID" \
+  --test-plan-id "$TMS_TEST_PLAN_ID" \
+  -o ./testrun.id
+```
+
+### Autotest external IDs file
+
+`--autotest-external-ids-file` / `-af` expects a plain-text file of **autotest external IDs** (the same values as in TMS / `autoTestExternalIds`, not internal UUIDs or global IDs):
+
+- one external ID per line;
+- empty lines are ignored;
+- lines starting with `#` are comments;
+- duplicate IDs are ignored.
+
+Example `autotest-external-ids.txt`:
+
+```text
+# smoke suite
+login-test-ext-id
+checkout-test-ext-id
+
+payment-test-ext-id
+```
+
+```bash
+testit testrun create launch \
+  -u "$TMS_URL" -t "$TMS_TOKEN" \
+  -pi "$TMS_PROJECT_ID" -ci "$TMS_CONFIGURATION_ID" \
+  -af ./autotest-external-ids.txt
+```
+
 ## 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.  
@@ -111,3 +174,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.post580 → testit_cli-2.10.4.post600}/setup.py

@@ -1,6 +1,15 @@
 from setuptools import find_packages, setup
 
-VERSION = "2.10.3.post580"
+VERSION = "2.10.4.post600"
+
+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=['validators', 'tqdm', 'click~=8.0.4', 'urllib3>=2.6.0', 'python-dateutil'],
     entry_points={
         'console_scripts': [
             'testit = testit_cli.__main__:console_main'

testit_cli-2.10.4.post600/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.4.post600/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.4.post600/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