A library for integrating Jira Zephyr Scale (Adaptavist\TM4J) with pytest
Project description
pytest-zephyr-scale-integration
pytest-zephyr-scale-integration
— это библиотека для интеграции pytest
с Jira Zephyr (Adaptavist\TM4J).
Она позволяет автоматически создавать тестовые циклы в Zephyr, запускать тесты и обновлять их статусы в Jira.
Возможности
- Автоматическое создание тестовых циклов в Zephyr (с возможностью создания папки или добавления в существующую).
- Обновление статусов тестов в Jira Zephyr.
- Поддержка параметризованных тестов.
- Гибкая настройка через файл
.env
.
Установка
Установить библиотеку можно через pip
:
pip install pytest_zephyr_scale_integration
Запуск
- Создать файл
.env
и заполнить его полями
# Конфигурация JIRA
JIRA_TOKEN='Jira_Token' # продпочтительнее использовать ТУЗ, у которого настроена электронная почта.
JIRA_PROJECT_ID=12345 # id проекта, можно узнать вызвав `GET /rest/tests/1.0/project`
JIRA_URL='https://your-jira-instance.atlassian.net'
FOLDER_NAME='Regress v1.0.0'
- Называть тесты нужно по имени ключа тест-кейса Jira Zephyr, например,
"test_T123"
. - При запуске автотестов через
pyest
нужно указать дополнительные параметры:
--zephyr
- необязательный. Вкл процесса интеграции. После прохождения автотестов будет автоматически создан тестовый цикл.
--zephyr_test_run_name
- необязательный. Наименования тестового цикла, по-умолчанию - "Test Run Cycle".
Например,
pytest --zephyr --zephyr_test_run_name="Regress v.1.1.0"
Логика создания тестового цикла
- Если FOLDER_NAME в
.env
пустой, то тестовый цикл с пройденными тестами будет создан в корневой папке. - Если FOLDER_NAME в
.env
заполнен, то:- Если указанная папка уже есть, то тестовый цикл создастся в ней.
- Если указанной папки нет, то она авматотически создастся в корне и ней будет находится созданный тестовый цикл.
Логика установки статусов тест-кейсам в Jira Zephyr
Всем тест-кейсам устанавливаются соответствующие pytest'у статусы в Jira Zephyr.
Если в Jira Zephyr написан параметризованный тест, то в тестовом
цикле он будет выглядеть как один тест с тестовыми скриптами в
колчичестве равном набору параметров в тест-кейсе. Каждый такой набор называется Test Script
.
При автоматизации такого тест-кейса нужно делать параметризацию и в коде. Наборы в pyest
должны идти
в том же порядке, что и в Zephyr, так как pyest
выполняет их по порядку.
В тестовом цикле результаты прохождения одного параметризованного теста отображаются в
шагах Test Script'а
, чтобы можно было явно определить какой из всех наборов оказался упавшим.
Логика установки статусов у шагов параметризованных тестов:
- Если набор пройден успешно, то все шаги
Test Script'а
- PASS - Если набор упал, то все шаги
Test Script'а
- FAIL.
Логики по сопоставлению действий в `pytest' и шагов в Zephyr нет.
Логика установки статусов и тест-кейсов:
- Если все наборы пройдены успешно, то тест-кейс - PASS
- Если хотя бы один набор упал, то тест-кейса отмечается как FAIL.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytest_zephyr_scale_integration-0.1.23.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac0d7f09029dfc9b8822e5a32b3a84cd4f8cf905174b135100d20d597f0c6a85 |
|
MD5 | 3d90d6d831b30bf774ca6240b75b82f4 |
|
BLAKE2b-256 | b9b3afeba167393de0b06d8049cd7b11577bc6f954f80284a836271b0f9525ff |
Hashes for pytest_zephyr_scale_integration-0.1.23-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6c1acc1928df84df1a1380d11fefc5b5cc11a9a480f73922803d0856e0355e17 |
|
MD5 | 5c45a63af2195392142821e6a205604c |
|
BLAKE2b-256 | 552739d2eccd852ffb7a1b6db038dc9b24a14571fbaf4eaddb7bd402bd731407 |