4. Allure репорт, основи та інтеграція в CI

Повноцінний reporting — це додаткова система, яку доведеться оновлювати й підтримувати. Якщо команді достатньо logs, screenshots, traces і простого HTML report, не варто автоматично додавати Allure лише через популярність. Він доречний, коли потрібні історія, структуровані steps, attachments і спільна точка перегляду результатів.

Екосистема має три практичні шари: Allure CLI генерує report; language binding формує сумісні result files; framework adapter на кшталт allure-pytest підключається до конкретного test runner. У відео також прямо згадано ризик telemetry та походження продукту: перед adoption треба перевірити актуальну політику даних і вимкнути необов’язкову аналітику відповідно до правил організації.

CLI встановлюється як системний інструмент, а allure-pytest додається до Python dependencies. Pytest налаштовується зберігати машинні результати в allure-results; цю директорію не комітять.

Smoke і regression jobs завантажують свої allure-results як artifacts. Publish job завантажує їх, встановлює сумісну версію Allure CLI та виконує allure generate. Старі Playwright HTML artifacts можна прибрати, якщо Allure справді стає єдиним report і не втрачає потрібної діагностики.

Версії CLI, Python binding і pytest adapter мають залишатися сумісними. Їх не слід незалежно оновлювати без pipeline verification, бо format results і генератор розвиваються окремо.

import allure

@allure.step("Open login page")
def open_login(page) -> None:
    page.goto("https://example.test/login")

def attach_screenshot(page) -> None:
    allure.attach(
        page.screenshot(),
        name="failure",
        attachment_type=allure.attachment_type.PNG,
    )

При failure fixture може додати screenshot і trace до результату через Allure attachments із відповідним content type. Screenshot після завершення тесту інколи фіксує стан запізно, тому Playwright trace залишається ціннішим джерелом послідовності дій.

Публічні дії Page Object позначаються @allure.step, щоб report показував бізнес-зрозумілі кроки, а не лише назву тесту. Приватні helpers, constructors і прості properties не потребують окремих steps: вони створять шум без корисного контексту.

Для наявного набору Page Objects decorators додаються через project-wide search/replace. Демонстрація показує ризик такого скорочення: regex зачіпає __init__, properties та неправильні відступи, після чого зміни доводиться вручну чистити й додавати imports.

Після механічної зміни запускаються format check і Ruff. Це обов’язкова межа безпеки для bulk edit: результат пошуку не вважається правильним, доки diff не переглянуто, код не форматується й статичні checks не проходять.

Pipeline успішно збирає smoke results, генерує Allure static site і публікує його через GitHub Pages. Початкове посилання повертає 404 через неправильний path; після переходу до фактичного deployment path report відкривається й показує tests та додані steps.

Це корисне нагадування: зелена publish job доводить, що deployment завершився, але не доводить, що користувацький URL правильний. Посилання на report треба відкрити окремою перевіркою.

Навмисно створюється failure, щоб перевірити новий content type для Playwright trace в Allure. У цьому Python setup очікуваний інтерактивний trace у report не з’являється. Автор не видає припущення за успіх і залишає робочий fallback: зберігати traces окремим artifact та відкривати їх через Playwright Trace Viewer.

Таким чином Allure покращує навігацію по tests і steps, але не замінює перевірену trace-діагностику, доки конкретна інтеграція не підтверджена end to end.

Спроба вивести URL через run у неправильному місці YAML ламає workflow schema, і GitHub відхиляє конфігурацію ще до тестів. Команду переносять усередину валідного step. IDE plugin і GitHub validation допомагають ловити такі структурні помилки до або одразу після push.

Фінальний мінімальний ланцюжок: pytest створює allure-results, test jobs передають їх як artifacts, publish job генерує site, GitHub Pages розміщує report, а Playwright traces поки зберігаються окремо як надійний diagnostic artifact.