Test IT CLI - это утилита командной строки, которая поможет вам взаимодействовать с системой управления тестированием Test IT. Она позволяет легко и быстро собирать и загружать результаты ваших автоматизированных тестов, работать с любыми тестовымми фреймфорками и интегрировать их в считаные минуты.
Test IT CLI распространяется как Python пакет и очень легко устанавливается на любые платформы (Linux, Windows и macOS) и любые окружения (отдельные сервера, контейнеры docker, CI/CD системы и т.д. )
Основные преимущества
- Простая и быстрая загрузка результатов автоматизированных тестов
- Простая интеграция с CI/CD системами, такими как GitHub, GitLab, Jenkins и другими
- Работа с любыми тестовыми фреймворками, которые поддерживают формат Junit XML
- Поддержка параллельного запуска тестов
- Легкая установка на любые платфоры и окружения
Установка
Для начала работы с Test IT CLI установите пакет testit-cli
из официального Python репозитория. После установки у вас появится возможность использовать утилиту testit
из командной строки.
Для установки выполните команду:
$ pip install testit-cli
$ testit -h
usage: testit [options]
[...]
Большинство систем и окружений уже сожержат установленый Python. Если Python отсутствует в вашей ситеме или окружении, то установите его согласно официальной документации.
Загрузка первых результатов выполнения тестов
После установки Test IT CLI вы можете загрузить результаты выполнения автоматизированных тестов в систему управления тестированием Test IT.
Для загрузки результатов запустите автоматизированные тесты с опцией экспортирования отчета в формате Junit XML. Данный отчет является стандартном для обмена результатами между утилитами тестирования, а так же CI/CD системами. Вы можете ознакомится с многими примерами экспорта Junit XML отчета для тестовых фреймворков.
После получения Junit XML отчета используйте Test IT CLI со следующими параметрами:
$ export TMS_TOKEN=<YOUR_TOKEN>
$ testit \
--url <YOUR_INSTANCE_URL> \
--project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
--testrun-name "TestNG test run" \
--results results/report.xml
- <YOUR_TOKEN> - Приватный токен, сгенерированный в вашем профиле Test IT,
- <YOUR_INSTANCE_URL> - адрес вашей системы Test IT, к примеру, https://tms.testit.software/
Пример выполнения команды
Collecting log files ...
Found 6 result file with a total of 14 tests
Created new testrun (ID: 4eeead72-b88a-4845-b258-3d077065561b)
Sending test results to Test IT ...
Uploading: 100%|██████████| 14/14 [00:06<00:00, 2.09it/s]
Successfully sent test results
Completed testrun (ID: 4eeead72-b88a-4845-b258-3d077065561b)
Параметры запуска Test IT CLI
Используйте команду testit --help
для получения полной справки о доступных параметрах.
$ testit --help
usage: testit [options]
This tool is the command line wrapper of Test IT allowing you to upload the test results in real time to Test IT
optional arguments:
-h, --help show this help message and exit
-m {import,create,finish,upload}, --mode {import,create,finish,upload}
Set CLI mode
-u https://demo.testit.software, --url https://demo.testit.software
Set url address of the Test IT instance
-t T2lKd2pLZGI4WHRhaVZUejNl, --token T2lKd2pLZGI4WHRhaVZUejNl
Set API token
-pi 5236eb3f-7c05-46f9-a609-dc0278896464, --project-id 5236eb3f-7c05-46f9-a609-dc0278896464
Set project id
-ci 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb, --configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb
Set configuration id
-ti 3802f329-190c-4617-8bb0-2c3696abeb8f, --testrun-id 3802f329-190c-4617-8bb0-2c3696abeb8f
Set test run id
-tn TestRun01, --testrun-name TestRun01
Set test run name
-r DIR, --results DIR
Set directory with results file
-d, --debug Set debug logs
-o FILE, --output FILE
Set file path for output
Описание параметров
- --mode, -m : задает режим работы утилиты. По умолчанию используется
import
. - --url, -u : задает адрес вашей системы Test IT, к примеру, https://tms.testit.software/
- --token, -t : задает приватный токен, сгенерированный в вашем профиле Test IT. Можно указывать как параметр или переменная окружения
TMS_TOKEN
- --project-id, -pi : задачет id проекта, в который будут загружены тесты
- --configuration-id, -ci : задает id конфигурации, на которой выполнялись тесты
- --testrun-id, -ti : задает id тестрана, в который будут загружены результаты или который необходимо будет пометить завершенным
- --testrun-name, -tn : задает название тестрана
- --results, -r : задает путь до директории или файла с результатами выполнения тестов
- --output, -o : задает путь до файла, в который будет сохранен id созданого тестрана
- --debug, -d : включает расширеный редим логгирования
Режимы работы
Test IT CLI поддерживает несколько режимов работы:
Стандартный запуск
Данный режим позволяет с помощью одной команды загрузить результаты выполнения тестов и используется по умолчанию.

Сначала осуществляется сбор информации из Junit XML отчета о пройденых тестах. Далее если не указан testrun_id
то создается новый тест ран, в который загружаются все результаты. После загрузки тест ран помечается как завершенный.
Пример выполнения команды
# загрузка результатов в новый тестран
$ testit \
--url https://tms.testit.software \
--project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
--testrun-name "New test run" \
--results results/report.xml
# загрузка результатов в существующий тестран
$ testit \
--url https://tms.testit.software \
--project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
--testrun-id da02746b-7734-4220-a7f3-126d9f291317 \
--results results/report.xml
Параллельный запуск
Данный режим позволяет загружать результаты тестов при параллельном запуске тестов.

Последовательность действий состоит из нескольких шагов:
Создание нового тестрана
$ export TMS_TOKEN=<YOUR_TOKEN> $ testit \ --mode create --url https://tms.testit.software \ --project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \ --testrun-name "New test run" \ --output tmp/output.txt
Загрузка результатов из разных потоков
$ export TMS_TOKEN=<YOUR_TOKEN> $ testit \ --mode upload --url https://tms.testit.software \ --configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \ --testrun-id $(cat tmp/output.txt) \ --results results/report.xml
Завершение тестрана
$ export TMS_TOKEN=<YOUR_TOKEN> $ testit \ --mode finish --url https://tms.testit.software \ --testrun-id $(cat tmp/output.txt) \
Дополнительные ресурсы
Мы заботливо оставили ниже полезные материалы, чтобы вы смогли в полной мере оценить всё удобство и возможности взаимодействия с нашей системой управления тестированием 😉.