e5377375c6
Features: - Full async API client for Kwork.ru - Pydantic models for type-safe responses - Comprehensive error handling - 93% test coverage CI/CD: - Parallel workflow jobs (lint, test, security) - Ruff for linting and formatting - MyPy for static type checking - pip-audit for security scanning - Pre-commit hooks for code quality
137 lines
3.2 KiB
Markdown
137 lines
3.2 KiB
Markdown
# End-to-End (E2E) Testing
|
||
|
||
E2E тесты требуют реальных credentials Kwork.ru и запускаются **только локально** (не в CI).
|
||
|
||
## ⚠️ Предупреждение
|
||
|
||
- **Не запускай в CI** — требуются реальные credentials
|
||
- **Используй тестовый аккаунт** — не основной аккаунт Kwork
|
||
- **Rate limiting** — добавляй задержки между запросами
|
||
|
||
---
|
||
|
||
## 🔧 Настройка
|
||
|
||
### 1. Создай файл окружения
|
||
|
||
```bash
|
||
cd /root/kwork-api
|
||
cp tests/e2e/.env.example tests/e2e/.env
|
||
```
|
||
|
||
### 2. Заполни credentials
|
||
|
||
```bash
|
||
# tests/e2e/.env
|
||
KWORK_USERNAME=your_test_username
|
||
KWORK_PASSWORD=your_test_password
|
||
```
|
||
|
||
### 3. Установи зависимости
|
||
|
||
```bash
|
||
uv sync --group dev
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Запуск тестов
|
||
|
||
### Все E2E тесты
|
||
|
||
```bash
|
||
uv run pytest tests/e2e/ -v
|
||
```
|
||
|
||
### Конкретный тест
|
||
|
||
```bash
|
||
uv run pytest tests/e2e/test_auth.py -v
|
||
uv run pytest tests/e2e/test_catalog.py::test_get_catalog_list -v
|
||
```
|
||
|
||
### С задержками (rate limiting)
|
||
|
||
```bash
|
||
uv run pytest tests/e2e/ -v --slowmo=1
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 Структура тестов
|
||
|
||
```
|
||
tests/e2e/
|
||
├── README.md # Этот файл
|
||
├── .env.example # Шаблон для credentials
|
||
├── conftest.py # Фикстуры и setup
|
||
├── test_auth.py # Аутентификация
|
||
├── test_catalog.py # Каталог кворков
|
||
├── test_projects.py # Биржа проектов
|
||
└── test_user.py # Пользовательские данные
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 Пример теста
|
||
|
||
```python
|
||
import pytest
|
||
from kwork_api import KworkClient
|
||
|
||
@pytest.mark.e2e
|
||
async def test_get_user_info():
|
||
"""E2E тест: получение информации о пользователе."""
|
||
async with await KworkClient.login(
|
||
username="test_user",
|
||
password="test_pass"
|
||
) as client:
|
||
user = await client.user.get_info()
|
||
assert user.username == "test_user"
|
||
assert user.balance >= 0
|
||
```
|
||
|
||
---
|
||
|
||
## 🏷️ Маркировка тестов
|
||
|
||
E2E тесты маркируются `@pytest.mark.e2e` для изоляции:
|
||
|
||
```bash
|
||
# Запустить только unit тесты (исключить e2e)
|
||
uv run pytest tests/ -v -m "not e2e"
|
||
|
||
# Запустить только e2e тесты
|
||
uv run pytest tests/ -v -m e2e
|
||
```
|
||
|
||
---
|
||
|
||
## 🔒 Безопасность
|
||
|
||
1. **Никогда не коммить `.env`** — добавлен в `.gitignore`
|
||
2. **Используй тестовый аккаунт** — не основной
|
||
3. **Не сохраняй токены в коде** — только через env vars
|
||
|
||
---
|
||
|
||
## 🐛 Troubleshooting
|
||
|
||
### Ошибка аутентификации
|
||
```
|
||
KworkAuthError: Invalid credentials
|
||
```
|
||
**Решение:** Проверь credentials в `.env`
|
||
|
||
### Rate limit
|
||
```
|
||
KworkApiError: Too many requests
|
||
```
|
||
**Решение:** Запусти с задержкой: `pytest --slowmo=2`
|
||
|
||
### Session expired
|
||
```
|
||
KworkAuthError: Session expired
|
||
```
|
||
**Решение:** Перезапусти тесты (session создаётся заново)
|