Мітки та відбір тестів
### Не всі тести мають завжди запускатися
Коли тест-сьют розростається, тести набувають дуже різних характеристик:
- Одні швидкі (чисті функції, без I/O)
- Інші повільні (звертаються до БД або зовнішнього API)
- Деякі мають сенс лише на конкретній ОС або версії Python
- Деякі тестують функцію, яка ще не реалізована
- Деякі відомо провалюються через відкритий баг
Запускати все на кожному натисканні клавіші -- марна витрата часу. **Мітки** дозволяють семантично позначати тести і фільтрувати їх прапором `-m` під час запуску.
## Вбудовані мітки
pytest поставляється з кількома мітками з коробки. Вони не потребують реєстрації.
### @pytest.mark.skip -- безумовний пропуск
```python
@pytest.mark.skip(reason='платіжний шлюз не налаштований у тестовому середовищі')
def test_charge_card():
...
```
Тест відображається як `s` у виводі. З `-v` видно причину. Завжди вказуйте `reason=` -- майбутній ви подякує теперішньому.
### @pytest.mark.skipif -- умовний пропуск
```python
import sys
@pytest.mark.skipif(sys.platform == 'win32', reason='лише POSIX-шляхи')
def test_symlinks():
...
@pytest.mark.skipif(sys.version_info < (3, 11), reason='tomllib додано у 3.11')
def test_tomllib_parse():
import tomllib
...
```
Умова обчислюється під час **збору** (коли pytest збирає тести), а не під час запуску. Використовуйте будь-який вираз Python, що обчислюється як bool.
### @pytest.mark.xfail -- очікуваний збій
```python
@pytest.mark.xfail(reason='баг #47: парсер падає на порожньому введенні')
def test_parse_empty():
assert parse('') == [] # наразі підіймає IndexError
```
Результати:
- Тест провалюється → `x` (xfail -- очікувано, нормально)
- Тест проходить → `X` (xpass -- неочікуваний успіх)
Додайте `strict=True`, щоб неочікуваний успіх став жорсткою помилкою. Це змушує видалити мітку після виправлення бага -- критично для CI:
```python
@pytest.mark.xfail(strict=True, reason='баг #47')
def test_parse_empty():
assert parse('') == []
```
З `strict=True`:
- Тест продовжує провалюватися як очікувано → `x` (так само, як без `strict`)
- Тест несподівано проходить → `FAILED` -- блокує CI так само, як звичайний провал тесту
Без `strict=True` неочікуваний успіх відображається як `X` (xpass) -- попередження, а не збій.
## @pytest.mark.parametrize -- запуск одного тесту з багатьма вхідними даними
Найбільш вживана мітка. Замість написання п'яти майже однакових тестів -- напишіть один і надайте список вхідних даних:
```python
import pytest
@pytest.mark.parametrize('value,expected', [
(0, 0),
(1, 1),
(-1, 1),
(100, 100),
(-50, 50),
])
def test_abs(value, expected):
assert abs(value) == expected
```
pytest запускає цей тест п'ять разів, по одному на кожен рядок. Кожен запуск відображається як окремий елемент у виводі: `test_abs[0-0]`, `test_abs[1-1]` тощо.
### Один параметр
```python
@pytest.mark.parametrize('n', [1, 2, 3, 10, 100])
def test_positive(n):
assert n > 0
```
### Позначення окремих кейсів
Кожен набір параметрів може мати власні мітки. Корисно для пропуску одного кейсу або позначення його як очікуваного збою:
```python
@pytest.mark.parametrize('code,expected_status', [
('SAVE20', 200),
('EXPIRED', 400),
pytest.param('SECRET', 200, marks=pytest.mark.xfail(reason='ще не реалізовано')),
])
def test_coupon(code, expected_status):
...
```
### Стекування parametrize
Кілька декораторів `@pytest.mark.parametrize` на одному тесті дають **декартовий добуток** -- тестується кожна комбінація:
```python
@pytest.mark.parametrize('base', [10, 100])
@pytest.mark.parametrize('discount', [0.1, 0.2, 0.5])
def test_discount(base, discount):
result = base * (1 - discount)
assert result < base # 2 × 3 = 6 тест-кейсів всього
```
---
## Власні мітки
Ви можете визначити будь-яке ім'я мітки: `@pytest.mark.slow`, `@pytest.mark.database`, `@pytest.mark.external`. Але їх необхідно **зареєструвати** у `pytest.ini`, щоб уникнути `PytestUnknownMarkWarning`:
```ini
[pytest]
markers =
slow: позначає повільні тести (відмінити з '-m "not slow"')
database: тести, що потребують реального підключення до БД
external: тести, що звертаються до зовнішніх сервісів
```
Застосовуйте їх як декоратори -- тест може мати кілька міток:
```python
@pytest.mark.slow
@pytest.mark.external
def test_load_from_s3():
...
```
## Запуск тестів за міткою: вирази -m
```bash
pytest -m slow # лише тести 'slow'
pytest -m "not slow" # все, крім 'slow'
pytest -m "slow and external" # мають бути обидві мітки
pytest -m "slow or database" # будь-яка з міток
pytest -m "not (slow or external)" # жодна з міток
```
Прапор `-m` підтримує `and`, `or`, `not` і дужки -- повна булева алгебра.
## Практичний шаблон розробки
Зареєструйте мітку `slow`. Застосовуйте її до всього, що звертається до мережі або реальної БД. Під час розробки запускайте `pytest -m "not slow"` для зворотного зв'язку за частки секунди. У CI запускайте `pytest` без фільтра, щоб охопити все, включаючи повільні тести.
Цей шаблон тримає локальні ітерації швидкими, забезпечуючи повне покриття в CI без жодних відмінностей у конфігурації -- ті самі файли тестів, різні прапори `-m`.