🏷️ Маркеры и структура: запускаем нужные тесты

import pytest
import sys
 
@pytest.mark.slow          # 🐌 Долгие (>1 с)
def test_performance():
    ...
 
@pytest.mark.integration   # 🏗️ БД/сервисы
def test_database_operations():
    ...
 
@pytest.mark.external_api  # 🌐 Внешний API
def test_payment_gateway():
    ...
 
@pytest.mark.skip(reason="Ждём фикс от API")  # ⏸️ Временно отключено
def test_broken_external_service():
    ...
 
@pytest.mark.skipif(sys.version_info < (3, 9), reason="Требует Python 3.9+")
def test_new_syntax():
    ...

[pytest]
markers =
    slow: медленные тесты (deselect with -m "not slow")
    integration: тесты с БД или сервисами
    external_api: вызовы внешних API
    bugfix: тесты для исправленных багов

pytest -m "not slow"      # Только быстрые
pytest -m integration     # Только интеграционные
pytest -m bugfix          # Багфиксы
pytest -rs                # Показывать пропущенные

tests/
  test_todo.py
  test_user.py
  conftest.py

tests/
  unit/            # 🚀 Быстрые проверки (<100ms)
    test_todo.py
    test_user.py
    conftest.py    # 🔧 Фикстуры только для unit
  integration/     # 🏗️ Медленные/сеть/БД
    test_database.py
    test_api.py
    conftest.py    # 🔧 Фикстуры только для integration
  conftest.py      # 🔧 Общие фикстуры для всех тестов

import pytest
from src.task_manager import TaskManager
 
@pytest.fixture
def sample_tasks():
    return ["task1", "task2"]
 
@pytest.fixture
def empty_task_manager():
    return TaskManager()

import pytest
 
@pytest.fixture
def mock_database():
    return MockDatabase()  # моки только для unit-тестов

import pytest
from myapp.db import create_connection
 
@pytest.fixture
def db_connection():
    conn = create_connection(testing=True)
    yield conn
    conn.close()

import pytest, sys
 
@pytest.mark.unit  # 🚀 Быстрый unit-тест
def test_fast_unit():
    pass
 
@pytest.mark.integration  # 🏗️ Интеграция с БД
def test_database_query():
    pass
 
@pytest.mark.external_api  # 🌐 Внешний API
@pytest.mark.slow          # 🐌 Долгий
def test_external_payment_api():
    pass
 
@pytest.mark.skip(reason="База в maintenance")
def test_database_maintenance():
    pass

pytest -m "not slow and not integration" --tb=short   # Разработка
pytest -m "not external_api" --junitxml=report.xml    # CI без внешних API
pytest --durations=10 -m "slow"                       # Поиск медленных
pytest tests/unit/ -v                                 # Только unit

jobs:
  unit-tests:
    runs-on: ubuntu-latest
    steps:
      - run: pytest -m "not slow and not integration" --junitxml=unit-report.xml
 
  integration-tests:
    runs-on: ubuntu-latest
    needs: unit-tests
    steps:
      - run: pytest -m integration --junitxml=integration-report.xml

tests/
  test_everything.py      # 1000 строк вперемешку
  test_utils.py           # Непонятно, что проверяется
  helpers.py              # Фикстуры разбросаны

# pytest.ini в корне проекта
[pytest]
# Где искать тесты
testpaths = tests
 
# Какие файлы считать тестами
python_files = test_*.py *_test.py
 
# Какие классы считать тестовыми
python_classes = Test*
 
# Какие функции считать тестами
python_functions = test_*
 
# Дефолтные флаги для всех запусков
addopts =
    -v
    --strict-markers
    --tb=short
    --cov=src
    --cov-report=term-missing
    --cov-fail-under=70
 
# Регистрация маркеров (обязательно с --strict-markers)
markers =
    slow: медленные тесты (deselect with '-m "not slow"')
    integration: тесты с БД или сервисами
    external_api: вызовы внешних API
    unit: быстрые unit-тесты
    bugfix: тесты для исправленных багов

# pyproject.toml в корне проекта
[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py", "*_test.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
 
addopts = [
    "-v",
    "--strict-markers",
    "--tb=short",
    "--cov=src",
    "--cov-report=term-missing",
    "--cov-fail-under=70",
]
 
markers = [
    "slow: медленные тесты (deselect with '-m \"not slow\"')",
    "integration: тесты с БД или сервисами",
    "external_api: вызовы внешних API",
    "unit: быстрые unit-тесты",
    "bugfix: тесты для исправленных багов",
]

# Каждый раз вводим вручную
pytest -v --strict-markers --cov=src --cov-report=term-missing tests/

# Просто pytest — все флаги подхватываются из конфига
pytest
 
# Переопределяем при необходимости
pytest -q  # тихий режим вместо -v
pytest --no-cov  # без coverage

# Если у вас уже есть pyproject.toml — добавьте секцию
# Если нет — создайте файл
 
cat >> pyproject.toml << 'EOF'
 
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = [
    "-v",
    "--strict-markers",
    "--tb=short",
]
markers = [
    "slow: медленные тесты",
    "integration: интеграционные тесты",
    "unit: unit-тесты",
]
EOF
 
# Проверьте
pytest --markers  # должны увидеть ваши маркеры
pytest  # запуск с дефолтными флагами

# Установка
pip install pytest-xdist
 
# Автоматически использует все ядра
pytest -n auto
 
# Или явно укажите количество процессов
pytest -n 4
 
# С coverage (работает корректно)
pytest -n auto --cov=src
 
# С маркерами
pytest -n auto -m "not slow"

# Последовательный запуск (1 ядро)
pytest tests/
# 1000 тестов × 0.1 сек = 100 секунд
 
# Параллельный запуск (4 ядра)
pytest -n 4 tests/
# 1000 тестов ÷ 4 ядра × 0.1 сек = 25 секунд
 
# Автоматически (8 ядер на M1/M2 Mac)
pytest -n auto tests/
# 1000 тестов ÷ 8 ядер × 0.1 сек = 12.5 секунд
 
# ⚡ 8x ускорение!

# По умолчанию: loadfile (файлы распределяются по процессам)
pytest -n 4
 
# loadscope: тесты одного класса идут на один процесс
pytest -n 4 --dist loadscope
 
# loadgroup: группировка по маркерам
pytest -n 4 --dist loadgroup

# pyproject.toml
[tool.pytest.ini_options]
addopts = [
    "-n auto",  # Всегда параллельно
    "-v",
    "--strict-markers",
]
 
# Или для CI:
# addopts = ["-n 4"]  # Фиксированное количество