Test IT 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

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 +

For current versions, see the releases tab.
Starting with 5.2, we have added a TMS postscript, which means that the utility is compatible with a specific enterprise version.
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:

--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.

--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):

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:

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:

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”.

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.

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

testit_cli-2.11.0.tar.gz (155.7 kB view details)

Uploaded Aug 28, 2026 Source

File details

Details for the file testit_cli-2.11.0.tar.gz.

File metadata

Download URL: testit_cli-2.11.0.tar.gz
Upload date: Aug 28, 2026
Size: 155.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for testit_cli-2.11.0.tar.gz
Algorithm	Hash digest
SHA256	`4e267bec8a382a57ead5f3137e2b8c4dffa9c3fc85b409d317c922a79a06555f`
MD5	`13f489c27538dd76bfe12fded1a7ba48`
BLAKE2b-256	`62dc4c8618b5ca89baa0f476896b6e3e016f46dbab2b4bdbb75597a6fef4ad43`