Test IT

JUnit

Test IT позволяет загружать результаты автоматизированных тестов из тестового фреймворка JUnit. Существуют следующие способы интеграции:

Смотрите также: Дополнительные ресурсы.

CLI

Test IT поддерживает загрузку тестов и результатов их выполнения в формате JUnit XML. Для этого необходимо:

  1. Запустить тесты и сгенерировать отчет JUnit XML
  2. Загрузить результаты тестов в Test IT

Запуск тестов и генерация отчета JUnit XML

Вы можете запускать тесты через командную строку или как часть вашей CI/CD системы. JUnit поддерживает несколько утилит для сборки. Руководство по настройке используемой вами утилиты смотрите в официальной документации:

Загрузка результатов тестов в Test IT

Загрузка осуществляется при помощи Test IT CLI. Утилита распространяется как пакет для Python и легко устанавливается в системе.

  1. Для установки выполните команду:

    $ pip install testit-cli
$ testit --help

usage: testit [options]
[...]

  2. Добавьте переменную окружения TMS_TOKEN и выполните команду:

    $ 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 "Junit test run" \
  --results test-output/test/
    • <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.

Адаптер

Адаптер предоставляет гибкие возможности интеграции и позволяет загружать не только базовую информацию об автотестах, но и другие метаданные (шаги, вложения, ссылки и т.д.).

Для подключения адаптера воспользуйтесь инструкциейopen in new window на GitHub.

Список метаданных, передаваемых адаптером для JUnit
  • RunWith(BaseJunit4Runner.class) — соединение адаптера, необходимое для запуска автотестов (является обязательным)
  • WorkItemIds — идентификатор (ID) рабочего элемента, позволяет привязывать автотесты к ручным тестам в Test IT. Получает массив ID ручных тестов.
  • DisplayName — имя автотеста, используемое в Test IT
  • ExternalId — уникальный ID автотеста в Test IT
  • Title — имя автотеста, указанное в его карточке. Если имя не указано, используется имя DisplayName.
  • Description — описание автотеста, указанное в его карточке
  • Labels — теги, указанные в карточке автотеста
  • Links — ссылки, указанные в карточке автотеста
  • Step — шаг автотеста
  • ClassName — субдиректория автотеста в секции Test IT (по умолчанию используется имя файла автотеста)
  • NameSpace — расположение автотеста в секции Test IT (по умолчанию используется имя директории автотеста)
  • Adapter.addLinks — ссылки на результаты автотестов
  • Adapter.addAttachments — вложения, прикрепляемые к результатам автотестов
  • Adapter.addMessage — сообщения о результатах автотестов

Public API

Вы можете загружать тесты и результаты их выполнения с помощью нашего публичного API. Существует два способа загрузки:

  1. Самостоятельно взаимодействовать с API
  2. Использовать готовый API клиент

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

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