Test ITTest IT
  • Руководство системного администратора
  • Руководство пользователя
  • Загрузить Test IT Enterprise
  • GitHub
  • Руководство по работе с Личным кабинетом
  • Руководство пользователя
  • Личный кабинет Test IT Cloud
  • GitHub
  • Release notes: Test IT Enterprise
  • Release notes: Test IT Cloud
  • Новое в документации
  • Центр помощи
  • Видеокурс по Test IT
  • Часто задаваемые вопросы
  • Спросите нас в Telegram
      
    
  • Руководство системного администратора
  • Руководство пользователя
  • Загрузить Test IT Enterprise
  • GitHub
  • Руководство по работе с Личным кабинетом
  • Руководство пользователя
  • Личный кабинет Test IT Cloud
  • GitHub
  • Release notes: Test IT Enterprise
  • Release notes: Test IT Cloud
  • Новое в документации
  • Центр помощи
  • Видеокурс по Test IT
  • Часто задаваемые вопросы
  • Спросите нас в Telegram
  • Что такое Test IT?
  • Быстрый старт
  • Администрирование

    • Администрирование Test IT
    • Вход в систему после установки
    • Настройка подключений

      • Внешние подключения в Test IT
      • AD/LDAP
        • Поля настроек подключения
      • AD/Kerberos
      • OpenID Connect
    • Добавление лицензий
    • Приглашение пользователей
    • Добавление пользователей и групп
    • Присвоение системных ролей
    • Настройка проектных ролей
    • Настройка очистки хранилища
    • Настройки геймификации
    • Настройка атрибутов
    • Настройка интеграций с таск-трекерами

      • Интеграция с таск-трекерами
      • Интеграция с Azure DevOps
      • Интеграция с ClickUp
      • Интеграция с Easy Redmine
      • Интеграция с EvaProject
      • Интеграция с Jira
        • Интеграция с Jira Server
          • Плагин Test IT для Jira Server
        • Интеграция с Jira Cloud
        • Настройка подключения Jira через OAuth 1.0
      • Интеграция с Kaiten
      • Интеграция с Monday
      • Интеграция с Redmine
      • Интеграция с TeamStorm
      • Интеграция с Yandex Tracker
      • Интеграция с YouTrack
    • Настройка интеграций с ИИ-моделями

      • Интеграция Test IT с ИИ-моделями
      • Интеграция с GigaChat
      • Интеграция с YandexGPT
  • Авторизация
  • Профиль пользователя

    • Данные профиля пользователя
    • Настройки профиля и создание API-токена
    • Фоновые задачи
  • Проекты

    • Работа с проектами
    • Структура и компоненты проекта
    • Создание и редактирование проекта
    • Добавление пользователей и групп в проект
    • Настройка атрибутов в проекте
    • Работа с вебхуками

      • Настройка вебхуков
      • Вебхук для изменения проекта
      • Вебхуки для действий с рабочими элементами
      • Вебхуки для работы с тест-планами
      • Вебхук для изменения конфигурации
      • Вебхуки для работы с тест-поинтами
      • Вебхуки для работы с автотестами
      • Вебхуки для уведомлений пользователя
      • Настройка уведомлений в Slack с помощью вебхуков
      • Настройка уведомлений в Telegram с помощью вебхуков
      • Настройка интеграции с GitFlic с помощью вебхуков
      • Настройка интеграции с GitLab CI с помощью вебхуков
      • Настройка запуска автотестов в Jenkins CI с помощью вебхука
      • Настройка вебхука в TeamCity и Python (на примере Pytest)
    • Импорт и экспорт проектов
    • Подключение таск-трекера к проекту
    • Добавление ИИ-модели в проект
    • Архивация, восстановление и удаление проектов
  • Библиотека тестов

    • Библиотека тестов в Test IT
    • Создание тестов
      • Сравнение типов рабочих элементов
    • Импорт тестовой документации из XLS и XLSX
    • Версионирование тестов
    • Добавление общего шага в тест
    • Выделение шагов теста в общий шаг
    • Работа с параметрами тестов
    • Добавление ссылок в тесты
    • Работа с вложениями тестов
    • Использование тегов
    • Автоматизация тест-кейсов
    • Экспорт тестов
    • Массовое изменение тестов
    • Перемещение и копирование тестов в библиотеке
    • Архивация, восстановление и удаление тестов
    • Работа с секциями
  • Параметры и конфигурации

    • Работа с параметрами и конфигурациями
  • Тест-планы

    • Работа с тест-планами
    • Создание тест-плана
    • Изменение тест-плана
    • Блокировка тест-плана
    • Дублирование тест-плана
    • Добавление атрибутов тест-плана
    • Архивация, восстановление и удаление тест-плана
    • Формирование тестового набора
    • Назначение исполнителей тест-плана
    • Выполнение тест-плана
    • Создание дефектов в таск-трекерах
    • Отчет по тест-плану
  • Автотестирование

    • Работа с автоматизированными тестами
    • Добавление автотестов в Test IT из внешнего репозитория
    • Работа с нестабильными автотестами
    • Связывание автотестов с ручными тестами
    • Запуск автотестов из UI
    • Запуск автотестов с помощью клиентских библиотек
    • Импорт результатов из Allure Adapters
    • Отслеживание запусков автотестов
    • Создание дефектов в таск-трекерах из прогонов автотестов
    • Анализ результатов автотестов
    • Таймлайн
  • Интеграции с системами автоматизированного тестирования

    • Работа с системами автоматизированного тестирования
    • Test IT CLI
    • Интеграция с системами CI/CD

      • Работа с системами CI/CD
      • Azure DevOps
      • Bamboo
      • Bitbucket
      • CircleCI
      • GitHub Actions
      • GitLab CI/CD
      • Jenkins
      • TeamCity
    • Интеграция с тестовыми фреймворками

      • Работа с тестовыми фреймворками
      • Адаптер Test IT
      • Appium
      • BrowserStack
      • Catch2
      • CodeceptJS
      • Cucumber
      • Cypress
      • Emcee
      • Flutter
      • Golang
      • GoogleTest
      • Jasmine
      • JBehave
      • Jest
      • JUnit
      • Kotest
      • Marathon Cloud
      • Minitest
      • Mocha
      • MSTest
      • Nose2
      • NUnit
      • PHPUnit
      • Playwright
      • Postman
      • Pytest
      • Pytest-BDD
      • Robot Framework
      • RSpec
      • Sauce Labs
      • Selenide
      • Selenium
      • SoapUI
      • SpecFlow
      • Telerik Test Studio
      • TestCafe
      • TestComplete
      • Testim
      • TestNG
      • Unittest
      • WebdriverIO
      • XCTest
      • xUnit.net
    • Плагин Test IT Management для систем IDE
    • Использование API-клиентов
  • Миграция в Test IT

    • Миграция в Test IT: возможности и процесс
    • Миграция из Allure TestOps
    • Миграция из Azure DevOps
    • Миграция из HP ALM
    • Миграция из PractiTest
    • Миграция из Qase
    • Миграция из SpiraTest
    • Миграция из TestCollab
    • Миграция из TestLink
    • Миграция из TestRail
    • Миграция из Xray
    • Миграция из Zephyr Scale
    • Миграция из Zephyr Squad
    • Загрузка тест-кейсов в Test IT с помощью импортера
  • Дашборды

    • Работа с дашбордами
    • Работа с виджетами

      • Действия с виджетами
      • Анализ результатов тестов
      • Анализ тестов, хранящихся в библиотеке
      • Анализ автотестов
      • Анализ прогонов
      • Анализ тест-планов
      • Анализ активности команды
  • Поиск и фильтры

    • Использование фильтров
    • Работа с запросами
    • Глобальный поиск
  • Уведомления
  • API

    • Работа с API
  • Горячие клавиши
  • Глоссарий

Test IT CLI

Используйте адаптер Test IT

Помимо Test IT CLI, при работе с многими тестовыми фреймворками вы можете использовать адаптер Test IT.

Test IT CLI — это утилита командной строки, которая помогает взаимодействовать с Test IT. Она позволяет легко и быстро собирать и загружать результаты ваших автоматизированных тестов, работать с любыми тестовыми фреймворками и интегрировать их.

Test IT CLI распространяется как пакет Python и легко устанавливается на любые платформы (Linux, Windows и macOS) и окружения (отдельные сервера, контейнеры docker, CI/CD системы и т.д.).

Test IT CLI доступна для скачивания на Python Package Index.

Основные преимущества

Основные преимущества Test IT CLI:

  • Простая и быстрая загрузка результатов автоматизированных тестов
  • Простая интеграция с CI/CD системами, такими как GitHub, GitLab, Jenkins и др.
  • Работа с любыми тестовыми фреймворками, которые поддерживают формат JUnit XML
  • Поддержка параллельного запуска тестов
  • Простая установка на любые платформы и окружения

Установка

Для начала работы с Test IT CLI:

  1. Установите пакет testit-cli из официального репозитория Python. После установки вы сможете использовать утилиту testit из командной строки. Для установки используйте команду:

    $ pip install testit-cli
    $ testit --help
    
    usage: testit [options]
    [...]
    
  2. Если Python отсутствует в вашей системе или окружении, установите его согласно официальной документации (большинство систем и окружений уже содержат установленный Python).

Загрузка первых результатов выполнения тестов

После установки Test IT CLI вы можете загрузить результаты выполнения автоматизированных тестов в систему управления тестированием Test IT.

Для загрузки результатов:

  1. Запустите автоматизированные тесты с опцией экспортирования отчета в формате JUnit XML. Данный отчет является стандартным способом обмена результатами между утилитами тестирования, а также CI/CD системами. Вы можете ознакомиться с примерами экспорта JUnit XML отчета для тестовых фреймворков.

  2. После получения JUnit XML отчета используйте Test IT CLI со следующими параметрами:

    $ export TMS_TOKEN=<YOUR_TOKEN>
    $ testit results import \
      --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 results import --help:

    $ testit results import --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
      -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
      -s ., --separator .   
                            Separate the classname value in the results into namespace and classname
      -ns NameSpace01, --namespace NameSpace01
                            Set namespace                     
      -cn ClassName01, --classname ClassName01
                            Set classname                     
      -r DIR, --results DIR
                            Set directory with results file
      -d, --debug           Set debug logs
      -o FILE, --output FILE
                            Set file path for output
      -a TEXT, --attachments TEXT        
                            Path to attachments for test run (multiple)                       
    
    

Описание параметров

В Test IT CLI используются следующие параметры:

  • --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: задает название прогона
  • --separator, -s: разделяет classname на namespace и classname по указанной строке
  • --namespace, -ns: задает название namespace по умолчанию
  • --classname, -cn: задает название classname по умолчанию
  • --results, -r: задает путь до директории или файла с результатами выполнения тестов
  • --output, -o: задает путь до файла, в который будет сохранен id созданного прогона
  • --debug, -d: включает расширенный режим логирования
  • --attachments, -a: задает путь к вложениям для прогона (может быть указан несколько раз)

Режимы работы

Test IT CLI поддерживает следующие режимы работы:

  • Стандартный запуск
  • Параллельный запуск

Стандартный запуск

Режим стандартного запуска позволяет загрузить результаты выполнения тестов с помощью одной команды. Данный режим используется по умолчанию.

Стандартный запуск Test IT CLI

Процесс состоит из следующих этапов:

  1. Сбор информации из JUnit XML отчета о пройденных тестах.
  2. Если не указан testrun_id, создается новый прогон
  3. В созданный прогон загружаются все результаты.
  4. После загрузки прогон помечается как завершенный.
Пример выполнения команды
# загрузка результатов в новый прогон
$ testit results import \
  --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 results import \
  --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  

Параллельный запуск

Режим параллельного запуска позволяет загружать результаты тестов при параллельном запуске тестов.

Параллельный запуск Test IT CLI

Процесс параллельного запуска включает в себя:

  1. Создание нового прогона
    $ export TMS_TOKEN=<YOUR_TOKEN>
    $ testit testrun create \
      --url https://tms.testit.software \
      --project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
      --testrun-name "New test run" \
      --output tmp/output.txt
    
  2. Загрузка результатов из разных потоков
    $ export TMS_TOKEN=<YOUR_TOKEN>
    $ testit results upload \
      --url https://tms.testit.software \
      --configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
      --testrun-id $(cat tmp/output.txt) \
      --results results/report.xml 
    
  3. Завершение прогона
    $ export TMS_TOKEN=<YOUR_TOKEN>
    $ testit testrun complete \
      --url https://tms.testit.software \
      --testrun-id $(cat tmp/output.txt) \
    

Дополнительные ресурсы

Чтобы узнать больше о возможностях интеграции Test IT с другими системами, прочтите наши статьи:

  • Интеграции с CI/CD системами
  • Примеры автоматизации с другими тестовыми фреймворками
  • Плагин Test IT Management для IntelliJ IDEA
  • Взаимодействие с REST API
Обновлено: