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.22.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 125e0cfbbb799dacae52ab3418a8bfb7585445eeef33e05d2ad0d735f08d2330 |
|
MD5 | f0a845f4b22795e81ed3a041305f1358 |
|
BLAKE2b-256 | 36d00f3a33f611ab2d8aaac5492c03aa62c92ca699bb414b5b0a533d789f6899 |
Hashes for pytest_zephyr_scale_integration-0.1.22-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 424bf6aa9173058b18a003f0f6a376332874cf31d538525f304226c5f5c23977 |
|
MD5 | 14e66c7c07a0473268ecdf210b83d349 |
|
BLAKE2b-256 | 727ab97732f64ada0334ab0215f075390fb2a90a1689696a442c0152699049fa |