Test IT

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

CLI

Мы поддерживаем загрузку тестов и результатов выполнения в формате Junit XML. Для этого необходимо выполнить следующие действия:

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

Вы можете запускать тесты через командную строку или как часть вашей CI/CD системы. XCTest поддерживает генерацию Junit XML отчета с помощью сторонних пакетов. Воспользуйтесь одним из популярных пакетов tuist/xcbeautifyopen in new window. Для подключения пакета необходимо выполнить команду:

$ brew install xcbeautify

Для генерации отчета, воспользуйтесь командой:

$ set -o pipefail && xcodebuild [flags] test | xcbeautify --report junit

После выполнения тестов отчет будет автоматически сгенерирован в директории build/reports.

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

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

$ pip install testit-cli
$ testit -h

usage: testit [options]
[...]

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

$ 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 "XCTest test run" \
  --results build/reports/junit.xml
  • <YOUR_TOKEN> — Приватный токен, сгенерированный в вашем профиле Test IT,
  • <YOUR_INSTANCE_URL> — адрес вашей системы Test IT, к примеру, https://tms.testit.software/
Пример выполнения команды
Collecting log files ...
Found 3 result file with a total of 7 tests
Created new testrun (ID: 18725f28-f054-40d6-b30e-b05cf36deaf9)
Sending test results to Test IT ...
Uploading: 100%|█████████████████████████████████████████████| 7/7 [00:01<00:00,  3.98it/s]
Successfully sent test results
Completed testrun (ID: 18725f28-f054-40d6-b30e-b05cf36deaf9)

Результаты загружены в систему Test IT.

Адаптер

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

В настоящее время адаптер находится в разработке. Ожидайте в ближайшее время.

Сейчас вы можете воспользоваться CLI

Public API

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

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

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

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