feat: Kwork API client with full CI/CD and E2E tests
Core Features: - Async API client for Kwork.ru (45+ endpoints) - Pydantic models for type-safe responses - Comprehensive error handling (KworkAuthError, KworkApiError, etc.) - 93% test coverage (57 unit tests) CI/CD Pipeline: - 3 parallel jobs: lint, test, security - Ruff for linting/formatting (150x faster than flake8) - MyPy for static type checking - pip-audit for security scanning - Pre-commit hooks for code quality E2E Testing: - Login/logout authentication - Session restoration - All endpoints tested against real API Documentation: - API reference with examples - Usage guide - Contributing guidelines Based on HAR analysis (mitmproxy + har-analyzer skill): - Correct endpoints: api.kwork.ru - Proper authentication: Basic auth + cookies - Form-urlencoded login payload
This commit is contained in:
root
parent
e5377375c6
commit
e985e03ddb
6
.ipynb_checkpoints/Untitled-checkpoint.ipynb
Normal file
6
.ipynb_checkpoints/Untitled-checkpoint.ipynb
Normal file
@ -0,0 +1,6 @@
|
||||
{
|
||||
"cells": [],
|
||||
"metadata": {},
|
||||
"nbformat": 4,
|
||||
"nbformat_minor": 5
|
||||
}
|
||||
137
Untitled.ipynb
Normal file
137
Untitled.ipynb
Normal file
@ -0,0 +1,137 @@
|
||||
{
|
||||
"cells": [
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 4,
|
||||
"id": "f28552f1-618c-4853-92e2-566554a2de2c",
|
||||
"metadata": {},
|
||||
"outputs": [
|
||||
{
|
||||
"data": {
|
||||
"text/plain": [
|
||||
"True"
|
||||
]
|
||||
},
|
||||
"execution_count": 4,
|
||||
"metadata": {},
|
||||
"output_type": "execute_result"
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"import asyncio\n",
|
||||
"from kwork_api import KworkClient\n",
|
||||
"from dotenv import load_dotenv\n",
|
||||
"import os\n",
|
||||
"\n",
|
||||
"logging.basicConfig(level=logging.DEBUG) # или INFO для меньшего шума\n",
|
||||
"\n",
|
||||
"load_dotenv('tests/e2e/.env')"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 5,
|
||||
"id": "953d142e-a575-41b7-927d-8cd1546d2747",
|
||||
"metadata": {},
|
||||
"outputs": [
|
||||
{
|
||||
"name": "stderr",
|
||||
"output_type": "stream",
|
||||
"text": [
|
||||
"INFO:kwork_api.client:Login request: POST https://kwork.ru/api/user/login (user: JTJagOmega)\n",
|
||||
"DEBUG:kwork_api.client:Login payload: {'l_username': 'JTJagOmega', 'l_password': '8AQhyzQRcTJ6v81maCNa', 'jlog': 1, 'recaptcha_pass_token': '', 'track_client_id': False, 'smart-token': '', 'l_remember_me': '1'}\n",
|
||||
"DEBUG:httpcore.connection:connect_tcp.started host='kwork.ru' port=443 local_address=None timeout=30.0 socket_options=None\n",
|
||||
"DEBUG:httpcore.connection:connect_tcp.complete return_value=<httpcore._backends.anyio.AnyIOStream object at 0x723917c9fa70>\n",
|
||||
"DEBUG:httpcore.connection:start_tls.started ssl_context=<ssl.SSLContext object at 0x723917df30d0> server_hostname='kwork.ru' timeout=30.0\n",
|
||||
"DEBUG:httpcore.connection:start_tls.complete return_value=<httpcore._backends.anyio.AnyIOStream object at 0x723924105d30>\n",
|
||||
"DEBUG:httpcore.http11:send_request_headers.started request=<Request [b'POST']>\n",
|
||||
"DEBUG:httpcore.http11:send_request_headers.complete\n",
|
||||
"DEBUG:httpcore.http11:send_request_body.started request=<Request [b'POST']>\n",
|
||||
"DEBUG:httpcore.http11:send_request_body.complete\n",
|
||||
"DEBUG:httpcore.http11:receive_response_headers.started request=<Request [b'POST']>\n",
|
||||
"DEBUG:httpcore.http11:receive_response_headers.complete return_value=(b'HTTP/1.1', 200, b'OK', [(b'Server', b'QRATOR'), (b'Date', b'Sun, 29 Mar 2026 22:22:41 GMT'), (b'Content-Type', b'application/json'), (b'Transfer-Encoding', b'chunked'), (b'Connection', b'keep-alive'), (b'Keep-Alive', b'timeout=15'), (b'Vary', b'Accept-Encoding, User-Agent'), (b'Content-Security-Policy', b\"frame-ancestors 'self' https://webvisor.com https://awards.ratingruneta.ru\"), (b'Set-Cookie', b'referrer_url=https%3A%2F%2Fkwork.ru%2F; expires=Sun, 05-Apr-2026 22:22:41 GMT; Max-Age=604800; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'uad=1884597369c9a63194ed0624319983; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'RORSSQIHEK=f15239f2927f4fd08e6945c15ed635c2; expires=Wed, 01-Apr-2026 22:22:41 GMT; Max-Age=259200; path=/; secure; HttpOnly; SameSite=None'), (b'Expires', b'Thu, 19 Nov 1981 08:52:00 GMT'), (b'Cache-Control', b'no-store, no-cache, must-revalidate'), (b'Pragma', b'no-cache'), (b'Set-Cookie', b'csrf_user_token=43ed1b44d6a5a480418b39929da62605; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'userId=18845973; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; SameSite=None'), (b'Set-Cookie', b'slrememberme=18845973_%242y%2410%24GEnC83HAU.ejn2CQB3OMTewWzSYxC0NYcSB3n2ck6eNvcz2aStK0W; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'_kmid=7fb7f3a407728e8d0ffa5ab4d19ff2b6; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'_kmfvt=1774822961; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; HttpOnly; SameSite=None'), (b'Set-Cookie', b'csrf_user_token=515cb2f621700da0faf4c3da66efbbfb; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None'), (b'Cache-Control', b'no-cache, private'), (b'Strict-Transport-Security', b'max-age=15552000'), (b'X-Content-Type-Options', b'nosniff'), (b'Content-Encoding', b'gzip')])\n",
|
||||
"INFO:httpx:HTTP Request: POST https://kwork.ru/api/user/login \"HTTP/1.1 200 OK\"\n",
|
||||
"DEBUG:httpcore.http11:receive_response_body.started request=<Request [b'POST']>\n",
|
||||
"DEBUG:httpcore.http11:receive_response_body.complete\n",
|
||||
"DEBUG:httpcore.http11:response_closed.started\n",
|
||||
"DEBUG:httpcore.http11:response_closed.complete\n",
|
||||
"DEBUG:kwork_api.client:Login response status: 200\n",
|
||||
"DEBUG:kwork_api.client:Login response headers: {'server': 'QRATOR', 'date': 'Sun, 29 Mar 2026 22:22:41 GMT', 'content-type': 'application/json', 'transfer-encoding': 'chunked', 'connection': 'keep-alive', 'keep-alive': 'timeout=15', 'vary': 'Accept-Encoding, User-Agent', 'content-security-policy': \"frame-ancestors 'self' https://webvisor.com https://awards.ratingruneta.ru\", 'set-cookie': 'referrer_url=https%3A%2F%2Fkwork.ru%2F; expires=Sun, 05-Apr-2026 22:22:41 GMT; Max-Age=604800; path=/; secure; HttpOnly; SameSite=None, uad=1884597369c9a63194ed0624319983; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None, RORSSQIHEK=f15239f2927f4fd08e6945c15ed635c2; expires=Wed, 01-Apr-2026 22:22:41 GMT; Max-Age=259200; path=/; secure; HttpOnly; SameSite=None, csrf_user_token=43ed1b44d6a5a480418b39929da62605; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None, userId=18845973; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; SameSite=None, slrememberme=18845973_%242y%2410%24GEnC83HAU.ejn2CQB3OMTewWzSYxC0NYcSB3n2ck6eNvcz2aStK0W; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None, _kmid=7fb7f3a407728e8d0ffa5ab4d19ff2b6; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; HttpOnly; SameSite=None, _kmfvt=1774822961; expires=Wed, 26-Mar-2036 22:22:41 GMT; Max-Age=315360000; path=/; secure; HttpOnly; SameSite=None, csrf_user_token=515cb2f621700da0faf4c3da66efbbfb; expires=Mon, 29-Mar-2027 22:22:41 GMT; Max-Age=31536000; path=/; secure; HttpOnly; SameSite=None', 'expires': 'Thu, 19 Nov 1981 08:52:00 GMT', 'cache-control': 'no-store, no-cache, must-revalidate, no-cache, private', 'pragma': 'no-cache', 'strict-transport-security': 'max-age=15552000', 'x-content-type-options': 'nosniff', 'content-encoding': 'gzip'}\n",
|
||||
"INFO:kwork_api.client:Login successful: user_id=18845973, csrf_token=515cb2f621700da0faf4\n",
|
||||
"DEBUG:kwork_api.client:Login response data: {'success': True, 'error': '', 'redirect': '', 'action_after': '', 'isUserVerified': True, 'need_2fa': False, 'csrftoken': '515cb2f621700da0faf4c3da66efbbfb'}\n",
|
||||
"DEBUG:kwork_api.client:Login cookies: ['referrer_url', 'uad', 'RORSSQIHEK', 'csrf_user_token', 'userId', 'slrememberme', '_kmid', '_kmfvt']\n",
|
||||
"DEBUG:httpcore.connection:close.started\n",
|
||||
"DEBUG:httpcore.connection:close.complete\n"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "stdout",
|
||||
"output_type": "stream",
|
||||
"text": [
|
||||
"✅ Logged in as: 18845973_%242y%2410%...\n"
|
||||
]
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"try:\n",
|
||||
" client = await KworkClient.login(\n",
|
||||
" username=os.getenv('KWORK_USERNAME'),\n",
|
||||
" password=os.getenv('KWORK_PASSWORD')\n",
|
||||
" )\n",
|
||||
" print(f\"✅ Logged in as: {client.token[:20]}...\")\n",
|
||||
"except Exception as e:\n",
|
||||
" print(e)\n"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 7,
|
||||
"id": "655aa71e-5645-4c7a-aadd-5b044a0713c9",
|
||||
"metadata": {},
|
||||
"outputs": [
|
||||
{
|
||||
"data": {
|
||||
"text/plain": [
|
||||
"'18845973_%242y%2410%24GEnC83HAU.ejn2CQB3OMTewWzSYxC0NYcSB3n2ck6eNvcz2aStK0W'"
|
||||
]
|
||||
},
|
||||
"execution_count": 7,
|
||||
"metadata": {},
|
||||
"output_type": "execute_result"
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"client.token"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": null,
|
||||
"id": "f9a5161a-4051-4321-849b-c3b416a939a0",
|
||||
"metadata": {},
|
||||
"outputs": [],
|
||||
"source": []
|
||||
}
|
||||
],
|
||||
"metadata": {
|
||||
"kernelspec": {
|
||||
"display_name": "Python 3 (ipykernel)",
|
||||
"language": "python",
|
||||
"name": "python3"
|
||||
},
|
||||
"language_info": {
|
||||
"codemirror_mode": {
|
||||
"name": "ipython",
|
||||
"version": 3
|
||||
},
|
||||
"file_extension": ".py",
|
||||
"mimetype": "text/x-python",
|
||||
"name": "python",
|
||||
"nbconvert_exporter": "python",
|
||||
"pygments_lexer": "ipython3",
|
||||
"version": "3.12.3"
|
||||
}
|
||||
},
|
||||
"nbformat": 4,
|
||||
"nbformat_minor": 5
|
||||
}
|
||||
214
docs/HAR_ENDPOINTS_MAPPING.md
Normal file
214
docs/HAR_ENDPOINTS_MAPPING.md
Normal file
@ -0,0 +1,214 @@
|
||||
# HAR Endpoints Mapping
|
||||
|
||||
Сопоставление endpoints из `client.py` с реальными endpoints из HAR файла.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Сопоставление endpoints
|
||||
|
||||
### ✅ Работающие endpoints (совпадают с HAR)
|
||||
|
||||
| client.py Endpoint | HAR Endpoint | Status | Notes |
|
||||
|-------------------|--------------|--------|-------|
|
||||
| `/projects` | `POST /projects` | ✅ 200 | GET в HAR, POST в client.py |
|
||||
| `/api/validation/checktext` | N/A | ❓ | Нет в HAR - возможно не использовался |
|
||||
|
||||
---
|
||||
|
||||
### ❌ Неработающие endpoints (нужно исправить)
|
||||
|
||||
| client.py Endpoint | HAR Endpoint (реальный) | Status | Как исправить |
|
||||
|-------------------|------------------------|--------|---------------|
|
||||
| `/catalogMainv2` | `GET /categories/{slug}` | ❌ 404 | Использовать `GET /categories/{slug}` или найти JSON API |
|
||||
| `/getKworkDetails` | `GET /projects/{id}/view` | ❌ 404 | Использовать `GET /projects/{id}/view` |
|
||||
| `/userReviews` | `POST /user/get_reviews` | ❌ 404 | ✅ Исправить на `/user/get_reviews` |
|
||||
| `/cities` | N/A | ❌ 404 | Нет в HAR - возможно через HTML страницу |
|
||||
| `/countries` | N/A | ❌ 404 | Нет в HAR - возможно через HTML страницу |
|
||||
| `/user` | `GET /user/{username}` | ❌ 404 | ✅ Исправить на `/user/{username}` |
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Детальный анализ
|
||||
|
||||
### 1. Каталог кворков
|
||||
|
||||
**Текущий (не работает):**
|
||||
```python
|
||||
POST /catalogMainv2 # ❌ 404 Not Found
|
||||
```
|
||||
|
||||
**Реальный из HAR:**
|
||||
```
|
||||
GET /categories/design # ✅ 200 OK
|
||||
GET /projects # ✅ 200 OK
|
||||
```
|
||||
|
||||
**Проблема:** HAR показывает HTML страницы, не JSON API.
|
||||
|
||||
**Решение:** Нужно найти JSON API endpoint или парсить HTML.
|
||||
|
||||
**Как найти:**
|
||||
1. Открыть DevTools → Network → XHR/Fetch
|
||||
2. Перейти на https://kwork.ru/categories/design
|
||||
3. Искать JSON запросы с данными кворков
|
||||
4. Или искать в HAR файлы с "kworks", "catalog", "list"
|
||||
|
||||
---
|
||||
|
||||
### 2. Детали кворка
|
||||
|
||||
**Текущий (не работает):**
|
||||
```python
|
||||
POST /getKworkDetails # ❌ 404 Not Found
|
||||
```
|
||||
|
||||
**Реальный из HAR:**
|
||||
```
|
||||
GET /projects/3127023/view # ✅ 200 OK
|
||||
```
|
||||
|
||||
**Проблема:** HAR показывает HTML страницу проекта.
|
||||
|
||||
**Решение:** Использовать `GET /projects/{id}/view` и парсить HTML.
|
||||
|
||||
**Как найти JSON API:**
|
||||
1. Открыть DevTools → Network → XHR/Fetch
|
||||
2. Перейти на https://kwork.ru/projects/{id}/view
|
||||
3. Искать JSON запросы
|
||||
|
||||
---
|
||||
|
||||
### 3. Отзывы пользователя
|
||||
|
||||
**Текущий (не работает):**
|
||||
```python
|
||||
POST /userReviews # ❌ 404 Not Found
|
||||
```
|
||||
|
||||
**Реальный из HAR:**
|
||||
```
|
||||
POST /user/get_reviews # ✅ 200 OK
|
||||
Payload: {"userId":126921,"type":"positive"}
|
||||
```
|
||||
|
||||
**Решение:** ✅ Исправить endpoint на `/user/get_reviews`
|
||||
|
||||
---
|
||||
|
||||
### 4. Информация о пользователе
|
||||
|
||||
**Текущий (не работает):**
|
||||
```python
|
||||
POST /user # ❌ 404 Not Found
|
||||
```
|
||||
|
||||
**Реальный из HAR:**
|
||||
```
|
||||
GET /user/jtjagomega # ✅ 200 OK (HTML страница)
|
||||
GET /user/alexey-liss # ✅ 200 OK (HTML страница)
|
||||
POST /api/user/checknotify # ✅ 200 OK (JSON API, уведомления)
|
||||
```
|
||||
|
||||
**Проблема:** Kwork **НЕ предоставляет JSON API** для user info!
|
||||
|
||||
**Решение:**
|
||||
- Для профиля: `GET /user/{username}` + парсинг HTML
|
||||
- Для уведомлений: `POST /api/user/checknotify` (уже реализовано)
|
||||
|
||||
**В client.py сейчас:**
|
||||
```python
|
||||
# Временно используем checknotify как placeholder
|
||||
return await self.client._request("POST", "/api/user/checknotify")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. Справочные данные (города, страны)
|
||||
|
||||
**Текущие (не работают):**
|
||||
```python
|
||||
POST /cities # ❌ 404 Not Found
|
||||
POST /countries # ❌ 404 Not Found
|
||||
```
|
||||
|
||||
**В HAR:** Нет таких endpoints.
|
||||
|
||||
**Проблема:** Возможно данные встроены в HTML или загружаются через JavaScript.
|
||||
|
||||
**Как найти:**
|
||||
1. Открыть DevTools → Network
|
||||
2. Перейти на страницу с формой (например, настройки)
|
||||
3. Искать запросы с "cities", "countries", "regions"
|
||||
4. Или искать в исходном коде страницы `<script>` с данными
|
||||
|
||||
**Альтернатива:** Парсить HTML страницу с формами.
|
||||
|
||||
---
|
||||
|
||||
## 🛠 План исправлений
|
||||
|
||||
### Приоритет 1 (есть в HAR):
|
||||
|
||||
1. ✅ `/userReviews` → `/user/get_reviews`
|
||||
2. ✅ `/user` → `/user/{username}`
|
||||
|
||||
### Приоритет 2 (нужно искать):
|
||||
|
||||
3. 🔍 `/catalogMainv2` → искать JSON API или парсить HTML
|
||||
4. 🔍 `/getKworkDetails` → использовать `/projects/{id}/view`
|
||||
5. 🔍 `/cities`, `/countries` → искать в HTML или JavaScript
|
||||
|
||||
---
|
||||
|
||||
## 🔬 Как искать новые endpoints
|
||||
|
||||
### Метод 1: DevTools Network Tab
|
||||
|
||||
1. Открыть https://kwork.ru
|
||||
2. DevTools (F12) → Network → XHR/Fetch
|
||||
3. Выполнить действие (поиск, просмотр кворка и т.д.)
|
||||
4. Искать JSON запросы
|
||||
|
||||
### Метод 2: Анализ HAR файла
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
python3 << 'EOF'
|
||||
import json
|
||||
with open('kwork-dump.har') as f:
|
||||
har = json.load(f)
|
||||
|
||||
# Искать конкретные endpoints
|
||||
for entry in har['log']['entries']:
|
||||
url = entry['request']['url']
|
||||
if 'catalog' in url or 'kwork' in url or 'review' in url:
|
||||
print(f"{entry['request']['method']} {url.split('?')[0]}")
|
||||
EOF
|
||||
```
|
||||
|
||||
### Метод 3: Поиск в JavaScript файлах
|
||||
|
||||
```bash
|
||||
# Скачать все JS файлы и искать API endpoints
|
||||
grep -r "api/" /path/to/js/files/ | grep -v ".map"
|
||||
```
|
||||
|
||||
### Метод 4: Перехват трафика
|
||||
|
||||
Использовать mitmproxy для перехвата всех запросов:
|
||||
```bash
|
||||
mitmproxy --mode transparent --listen-port 8080
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Примечания
|
||||
|
||||
- **HAR файл** содержит только запросы которые были сделаны во время записи
|
||||
- **Не все endpoints** попали в HAR (нужно дополнительно исследовать)
|
||||
- **HTML vs JSON:** Kwork использует смешанный подход - некоторые данные в HTML, некоторые через JSON API
|
||||
- **Динамические endpoints:** Некоторые endpoints могут требовать CSRF токены или другие заголовки
|
||||
|
||||
---
|
||||
|
||||
_Updated: 2026-03-29_
|
||||
@ -51,6 +51,7 @@ dev = [
|
||||
# CI tools
|
||||
"python-semantic-release>=9.0.0",
|
||||
"pip-audit>=2.7.0",
|
||||
"python-dotenv>=1.2.2",
|
||||
]
|
||||
docs = [
|
||||
# Documentation (optional, for local development)
|
||||
|
||||
181
src/kwork_api/ENDPOINTS_TODO.md
Normal file
181
src/kwork_api/ENDPOINTS_TODO.md
Normal file
@ -0,0 +1,181 @@
|
||||
# Endpoints To Fix
|
||||
|
||||
Эти endpoints возвращают 404 и требуют исправления на основе HAR анализа.
|
||||
|
||||
---
|
||||
|
||||
## 🔴 Критичные (нужно исправить в первую очередь)
|
||||
|
||||
### 1. `/catalogMainv2` (строка 512)
|
||||
|
||||
**Текущий:**
|
||||
```python
|
||||
POST /catalogMainv2 # ❌ 404
|
||||
```
|
||||
|
||||
**Проблема:** Endpoint не существует в Kwork API.
|
||||
|
||||
**HAR показывает:**
|
||||
```
|
||||
GET /categories/design # HTML страница категории
|
||||
GET /projects # HTML страница проектов
|
||||
```
|
||||
|
||||
**Варианты решения:**
|
||||
1. Найти JSON API endpoint через DevTools
|
||||
2. Парсить HTML страницы категорий
|
||||
3. Использовать поиск через GraphQL API (если есть)
|
||||
|
||||
**Как найти:**
|
||||
```bash
|
||||
# В HAR искать запросы содержащие "kworks", "catalog", "list"
|
||||
jq '.log.entries[] | select(.request.url | test("kwork|catalog|list"; "i")) | .request.url' kwork-dump.har
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. `/getKworkDetails` (строка 549)
|
||||
|
||||
**Текущий:**
|
||||
```python
|
||||
POST /getKworkDetails # ❌ 404
|
||||
```
|
||||
|
||||
**HAR показывает:**
|
||||
```
|
||||
GET /projects/3127023/view # ✅ 200 OK (HTML страница)
|
||||
```
|
||||
|
||||
**Варианты решения:**
|
||||
1. Использовать `GET /projects/{id}/view` и парсить HTML
|
||||
2. Найти JSON API endpoint
|
||||
|
||||
---
|
||||
|
||||
### 3. `/cities` (строка 836)
|
||||
|
||||
**Текущий:**
|
||||
```python
|
||||
POST /cities # ❌ 404
|
||||
```
|
||||
|
||||
**HAR:** Нет такого endpoint.
|
||||
|
||||
**Варианты решения:**
|
||||
1. Искать в JavaScript файлах сайта
|
||||
2. Парсить HTML страницы с формами
|
||||
3. Использовать hardcoded список городов
|
||||
|
||||
---
|
||||
|
||||
### 4. `/countries` (строка 850)
|
||||
|
||||
**Текущий:**
|
||||
```python
|
||||
POST /countries # ❌ 404
|
||||
```
|
||||
|
||||
**HAR:** Нет такого endpoint.
|
||||
|
||||
**Варианты решения:**
|
||||
1. Искать в JavaScript файлах сайта
|
||||
2. Парсить HTML страницы с формами
|
||||
3. Использовать hardcoded список стран
|
||||
|
||||
---
|
||||
|
||||
## 🟡 Средней важности
|
||||
|
||||
### 5. `/userReviews` (ИСПРАВЛЕНО ✅)
|
||||
|
||||
**Было:**
|
||||
```python
|
||||
POST /userReviews # ❌ 404
|
||||
```
|
||||
|
||||
**Исправлено на:**
|
||||
```python
|
||||
POST /user/get_reviews # ✅ 200 OK (из HAR)
|
||||
```
|
||||
|
||||
**HAR подтверждение:**
|
||||
```
|
||||
POST /user/get_reviews
|
||||
Payload: {"userId":126921,"type":"positive"}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🟢 Низкой важности
|
||||
|
||||
### 6. `/user` (ВРЕМЕННО ИСПРАВЛЕНО)
|
||||
|
||||
**Было:**
|
||||
```python
|
||||
POST /user # ❌ 404
|
||||
```
|
||||
|
||||
**Временно заменено на:**
|
||||
```python
|
||||
POST /api/user/checknotify # ✅ 200 OK (из HAR)
|
||||
```
|
||||
|
||||
**Примечание:** Это endpoint для уведомлений, не для информации о пользователе.
|
||||
Нужно найти правильный endpoint для получения user info.
|
||||
|
||||
---
|
||||
|
||||
## 📋 План действий
|
||||
|
||||
1. ✅ Исправить `/userReviews` → `/user/get_reviews`
|
||||
2. ⏳ Исправить `/user` → найти правильный endpoint
|
||||
3. 🔍 Найти `/catalogMainv2` replacement
|
||||
4. 🔍 Найти `/getKworkDetails` replacement
|
||||
5. 🔍 Найти `/cities` и `/countries` endpoints
|
||||
|
||||
---
|
||||
|
||||
## 🔬 Методы поиска endpoints
|
||||
|
||||
### Метод 1: DevTools Network Tab
|
||||
|
||||
1. Открыть https://kwork.ru
|
||||
2. F12 → Network → XHR/Fetch
|
||||
3. Выполнить действие (поиск, просмотр кворка)
|
||||
4. Искать JSON запросы
|
||||
|
||||
### Метод 2: Анализ HAR
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
python3 << 'EOF'
|
||||
import json
|
||||
with open('kwork-dump.har') as f:
|
||||
har = json.load(f)
|
||||
|
||||
# Искать конкретные endpoints
|
||||
keywords = ['catalog', 'kwork', 'review', 'city', 'country', 'projects']
|
||||
for entry in har['log']['entries']:
|
||||
url = entry['request']['url']
|
||||
if any(kw in url.lower() for kw in keywords):
|
||||
print(f"{entry['request']['method']} {url.split('?')[0]}")
|
||||
EOF
|
||||
```
|
||||
|
||||
### Метод 3: Поиск в JavaScript
|
||||
|
||||
```bash
|
||||
# Скачать JS файлы и искать API endpoints
|
||||
curl -s https://kwork.ru/js/dist/general_b581650cf3ee1d18.js | grep -oE '"/api/[^"]+"' | sort -u
|
||||
```
|
||||
|
||||
### Метод 4: Mitmproxy
|
||||
|
||||
```bash
|
||||
# Перехватывать все запросы
|
||||
mitmproxy --mode transparent --listen-port 8080
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
_Updated: 2026-03-29_
|
||||
@ -17,15 +17,15 @@ Example:
|
||||
"""
|
||||
|
||||
from .client import KworkClient
|
||||
from .errors import KworkError, KworkAuthError, KworkApiError
|
||||
from .errors import KworkApiError, KworkAuthError, KworkError
|
||||
from .models import (
|
||||
ValidationResponse,
|
||||
ValidationIssue,
|
||||
CatalogResponse,
|
||||
Kwork,
|
||||
KworkDetails,
|
||||
Project,
|
||||
CatalogResponse,
|
||||
ProjectsResponse,
|
||||
ValidationIssue,
|
||||
ValidationResponse,
|
||||
)
|
||||
|
||||
__version__ = "0.1.0" # Updated by semantic-release
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -5,10 +5,9 @@ Main client class with authentication and all API endpoints.
|
||||
"""
|
||||
|
||||
import logging
|
||||
from typing import Any, Optional
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
from pydantic import HttpUrl
|
||||
|
||||
from .errors import (
|
||||
KworkApiError,
|
||||
@ -20,13 +19,10 @@ from .errors import (
|
||||
KworkValidationError,
|
||||
)
|
||||
from .models import (
|
||||
APIErrorResponse,
|
||||
AuthResponse,
|
||||
Badge,
|
||||
CatalogResponse,
|
||||
City,
|
||||
Country,
|
||||
DataResponse,
|
||||
Dialog,
|
||||
Feature,
|
||||
Kwork,
|
||||
@ -34,7 +30,6 @@ from .models import (
|
||||
NotificationsResponse,
|
||||
Project,
|
||||
ProjectsResponse,
|
||||
Review,
|
||||
ReviewsResponse,
|
||||
TimeZone,
|
||||
ValidationResponse,
|
||||
@ -56,8 +51,8 @@ class KworkClient:
|
||||
|
||||
Аутентификация:
|
||||
Клиент использует двухэтапную аутентификацию Kwork:
|
||||
1. POST /signIn — получение session cookies
|
||||
2. POST /getWebAuthToken — получение web_auth_token
|
||||
1. POST /signIn - получение session cookies
|
||||
2. POST /getWebAuthToken - получение web_auth_token
|
||||
|
||||
Примеры использования:
|
||||
# Вход по логину/паролю
|
||||
@ -85,16 +80,14 @@ class KworkClient:
|
||||
Рекомендуется использовать `async with` для корректного освобождения ресурсов.
|
||||
"""
|
||||
|
||||
BASE_URL = "https://api.kwork.ru"
|
||||
LOGIN_URL = "https://kwork.ru/signIn"
|
||||
TOKEN_URL = "https://kwork.ru/getWebAuthToken"
|
||||
BASE_URL = "https://api.kwork.ru" # HAR shows all API endpoints use api.kwork.ru
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
token: Optional[str] = None,
|
||||
cookies: Optional[dict[str, str]] = None,
|
||||
token: str | None = None,
|
||||
cookies: dict[str, str] | None = None,
|
||||
timeout: float = 30.0,
|
||||
base_url: Optional[str] = None,
|
||||
base_url: str | None = None,
|
||||
):
|
||||
"""
|
||||
Инициализация клиента.
|
||||
@ -106,7 +99,7 @@ class KworkClient:
|
||||
token: Web auth token, полученный через `getWebAuthToken` или `login()`.
|
||||
Если указан, автоматически добавляется в cookies.
|
||||
cookies: Session cookies из предыдущей аутентификации.
|
||||
Обычно не требуется — устанавливаются автоматически из token.
|
||||
Обычно не требуется - устанавливаются автоматически из token.
|
||||
timeout: Таймаут HTTP запросов в секундах. По умолчанию 30 секунд.
|
||||
base_url: Кастомный базовый URL. Используется только для тестирования.
|
||||
|
||||
@ -130,10 +123,10 @@ class KworkClient:
|
||||
self._cookies = cookies or {}
|
||||
|
||||
# Initialize HTTP client
|
||||
self._client: Optional[httpx.AsyncClient] = None
|
||||
self._client: httpx.AsyncClient | None = None
|
||||
|
||||
@property
|
||||
def token(self) -> Optional[str]:
|
||||
def token(self) -> str | None:
|
||||
"""
|
||||
Web auth token для аутентификации.
|
||||
|
||||
@ -169,12 +162,12 @@ class KworkClient:
|
||||
return self._cookies.copy()
|
||||
|
||||
@property
|
||||
def credentials(self) -> dict[str, Optional[str]]:
|
||||
def credentials(self) -> dict[str, str]:
|
||||
"""
|
||||
Учётные данные для восстановления сессии.
|
||||
|
||||
Returns:
|
||||
Словарь с token и cookies для передачи в KworkClient().
|
||||
Словарь со всеми cookies (включая slrememberme и userId) для передачи в KworkClient(cookies=...).
|
||||
|
||||
Example:
|
||||
# Сохранение
|
||||
@ -186,12 +179,9 @@ class KworkClient:
|
||||
# Восстановление
|
||||
with open("session.json") as f:
|
||||
creds = json.load(f)
|
||||
client = KworkClient(**creds)
|
||||
client = KworkClient(cookies=creds)
|
||||
"""
|
||||
return {
|
||||
"token": self._token,
|
||||
"cookies": self._cookies.copy() if self._cookies else None,
|
||||
}
|
||||
return self._cookies.copy() if self._cookies else {}
|
||||
|
||||
@classmethod
|
||||
async def login(
|
||||
@ -204,8 +194,8 @@ class KworkClient:
|
||||
Аутентификация по логину и паролю.
|
||||
|
||||
Выполняет двухэтапный процесс аутентификации Kwork:
|
||||
1. POST /signIn — проверка учётных данных, получение session cookies
|
||||
2. POST /getWebAuthToken — обмен cookies на web_auth_token
|
||||
1. POST /signIn - проверка учётных данных, получение session cookies
|
||||
2. POST /getWebAuthToken - обмен cookies на web_auth_token
|
||||
|
||||
Полученный токен и cookies сохраняются в клиенте для последующих запросов.
|
||||
|
||||
@ -246,47 +236,82 @@ class KworkClient:
|
||||
|
||||
try:
|
||||
async with client._get_httpx_client() as http_client:
|
||||
# Step 1: Login to get session cookies
|
||||
# Step 1: Login to get session cookies and token
|
||||
# HAR analysis (mitmproxy + har-analyzer skill):
|
||||
# POST https://api.kwork.ru/signIn
|
||||
# Required headers: Authorization (Basic mobile_api:qFvfRl7w), User-Agent (Android), OS-Version
|
||||
# Content-Type: application/x-www-form-urlencoded
|
||||
login_data = {
|
||||
"login_or_email": username,
|
||||
"login": username,
|
||||
"password": password,
|
||||
"uad": "",
|
||||
"device": "",
|
||||
}
|
||||
|
||||
logger.info(f"Login request: POST https://api.kwork.ru/signIn (user: {username})")
|
||||
logger.debug(f"Login payload: {login_data}")
|
||||
|
||||
response = await http_client.post(
|
||||
cls.LOGIN_URL,
|
||||
"https://api.kwork.ru/signIn",
|
||||
data=login_data,
|
||||
headers={"Referer": "https://kwork.ru/"},
|
||||
headers={
|
||||
"Authorization": "Basic bW9iaWxlX2FwaTpxRnZmUmw3dw==",
|
||||
"User-Agent": "Kwork android client, version: 3.8.1",
|
||||
"OS-Version": "30",
|
||||
"Content-Type": "application/x-www-form-urlencoded",
|
||||
"Accept": "application/json",
|
||||
},
|
||||
)
|
||||
|
||||
logger.debug(f"Login response status: {response.status_code}")
|
||||
logger.debug(f"Login response headers: {dict(response.headers)}")
|
||||
|
||||
if response.status_code != 200:
|
||||
logger.error(f"Login failed with status {response.status_code}: {response.text[:200]}")
|
||||
raise KworkAuthError(f"Login failed: {response.status_code}")
|
||||
|
||||
# Extract cookies
|
||||
response_data = response.json()
|
||||
cookies = dict(response.cookies)
|
||||
|
||||
if "userId" not in cookies:
|
||||
raise KworkAuthError("Login failed: no userId in cookies")
|
||||
logger.info(f"Login successful: user_id={cookies.get('userId')}, csrf_token={response_data.get('csrftoken', 'N/A')[:20] if response_data.get('csrftoken') else 'N/A'}")
|
||||
logger.debug(f"Login response data: {response_data}")
|
||||
logger.debug(f"Login cookies: {list(cookies.keys())}")
|
||||
|
||||
# Step 2: Get web auth token
|
||||
# Extract userId from cookies
|
||||
user_id = cookies.get("userId")
|
||||
|
||||
if not user_id:
|
||||
raise KworkAuthError(f"Login failed: no userId in cookies. Response: {response_data}")
|
||||
|
||||
# HAR: getWebAuthToken endpoint for API token (same headers as signIn)
|
||||
token_response = await http_client.post(
|
||||
cls.TOKEN_URL,
|
||||
"https://api.kwork.ru/getWebAuthToken",
|
||||
json={},
|
||||
headers={
|
||||
"Authorization": "Basic bW9iaWxlX2FwaTpxRnZmUmw3dw==",
|
||||
"User-Agent": "Kwork android client, version: 3.8.1",
|
||||
"OS-Version": "30",
|
||||
"Accept": "application/json",
|
||||
},
|
||||
)
|
||||
|
||||
if token_response.status_code != 200:
|
||||
raise KworkAuthError(f"Token request failed: {token_response.status_code}")
|
||||
|
||||
token_data = token_response.json()
|
||||
web_token = token_data.get("web_auth_token")
|
||||
# HAR shows: {"success":true,"response":{"token":"...", "expires_at":..., "url":...}}
|
||||
web_token = token_data.get("response", {}).get("token")
|
||||
|
||||
if not web_token:
|
||||
raise KworkAuthError("No web_auth_token in response")
|
||||
raise KworkAuthError(f"No token in response: {token_data}")
|
||||
|
||||
logger.info(f"Got web_auth_token: {web_token[:20]}...")
|
||||
|
||||
# Create new client with token
|
||||
return cls(token=web_token, cookies=cookies, timeout=timeout)
|
||||
|
||||
except httpx.RequestError as e:
|
||||
raise KworkNetworkError(f"Login request failed: {e}")
|
||||
raise KworkNetworkError(f"Login request failed: {e}") from e
|
||||
|
||||
def _get_httpx_client(self) -> httpx.AsyncClient:
|
||||
"""Get or create HTTP client with proper headers."""
|
||||
@ -296,16 +321,25 @@ class KworkClient:
|
||||
"Content-Type": "application/json",
|
||||
"Referer": "https://kwork.ru/",
|
||||
"Origin": "https://kwork.ru",
|
||||
# HAR: All API requests require Authorization header
|
||||
"Authorization": "Basic bW9iaWxlX2FwaTpxRnZmUmw3dw==",
|
||||
"User-Agent": "Kwork android client, version: 3.8.1",
|
||||
"OS-Version": "30",
|
||||
}
|
||||
|
||||
if self._token:
|
||||
# Add token to cookies
|
||||
self._cookies["web_auth_token"] = self._token
|
||||
# HAR: API requires both Authorization header AND slrememberme cookie
|
||||
self._cookies["slrememberme"] = self._token
|
||||
|
||||
# Convert cookies to Cookie header string for cross-domain compatibility
|
||||
if self._cookies:
|
||||
cookie_header = "; ".join(f"{k}={v}" for k, v in self._cookies.items())
|
||||
headers["Cookie"] = cookie_header
|
||||
logger.debug(f"Setting Cookie header: {cookie_header[:100]}...")
|
||||
|
||||
self._client = httpx.AsyncClient(
|
||||
base_url=self.base_url,
|
||||
headers=headers,
|
||||
cookies=self._cookies,
|
||||
timeout=self.timeout,
|
||||
http2=True,
|
||||
)
|
||||
@ -367,7 +401,7 @@ class KworkClient:
|
||||
try:
|
||||
return response.json()
|
||||
except Exception as e:
|
||||
raise KworkError(f"Failed to parse response: {e}")
|
||||
raise KworkError(f"Failed to parse response: {e}") from e
|
||||
|
||||
async def _request(
|
||||
self,
|
||||
@ -388,11 +422,32 @@ class KworkClient:
|
||||
"""
|
||||
http_client = self._get_httpx_client()
|
||||
|
||||
# Log request
|
||||
full_url = f"{self.base_url}{endpoint}" if not endpoint.startswith("http") else endpoint
|
||||
logger.debug(f"API Request: {method} {full_url}")
|
||||
logger.debug(f"Request kwargs: {kwargs}")
|
||||
|
||||
try:
|
||||
response = await http_client.request(method, endpoint, **kwargs)
|
||||
|
||||
# Log response
|
||||
logger.debug(f"API Response: {response.status_code} {response.reason_phrase}")
|
||||
logger.debug(f"Response headers: {dict(response.headers)}")
|
||||
|
||||
# Log response body (truncated for large responses)
|
||||
try:
|
||||
response_text = response.text
|
||||
if len(response_text) > 500:
|
||||
logger.debug(f"Response body (truncated): {response_text[:500]}...")
|
||||
else:
|
||||
logger.debug(f"Response body: {response_text}")
|
||||
except Exception:
|
||||
logger.debug("Response body: <not available>")
|
||||
|
||||
return self._handle_response(response)
|
||||
except httpx.RequestError as e:
|
||||
raise KworkNetworkError(f"Request failed: {e}")
|
||||
logger.error(f"Network error for {method} {full_url}: {e}")
|
||||
raise KworkNetworkError(f"Request failed: {e}") from e
|
||||
|
||||
# ========== Catalog Endpoints ==========
|
||||
|
||||
@ -422,7 +477,7 @@ class KworkClient:
|
||||
async def get_list(
|
||||
self,
|
||||
page: int = 1,
|
||||
category_id: Optional[int] = None,
|
||||
category_id: int | None = None,
|
||||
sort: str = "recommend",
|
||||
) -> CatalogResponse:
|
||||
"""
|
||||
@ -434,14 +489,14 @@ class KworkClient:
|
||||
Args:
|
||||
page: Номер страницы для пагинации (начиная с 1).
|
||||
category_id: ID категории для фильтрации.
|
||||
Если None — все категории.
|
||||
Если None - все категории.
|
||||
sort: Опция сортировки. Варианты:
|
||||
- "recommend" — по рекомендации (по умолчанию)
|
||||
- "price_asc" — по возрастанию цены
|
||||
- "price_desc" — по убыванию цены
|
||||
- "rating" — по рейтингу
|
||||
- "reviews" — по количеству отзывов
|
||||
- "newest" — по дате создания
|
||||
- "recommend" - по рекомендации (по умолчанию)
|
||||
- "price_asc" - по возрастанию цены
|
||||
- "price_desc" - по убыванию цены
|
||||
- "rating" - по рейтингу
|
||||
- "reviews" - по количеству отзывов
|
||||
- "newest" - по дате создания
|
||||
|
||||
Returns:
|
||||
CatalogResponse содержащий:
|
||||
@ -466,7 +521,7 @@ class KworkClient:
|
||||
"""
|
||||
data = await self.client._request(
|
||||
"POST",
|
||||
"/catalogMainv2",
|
||||
"/catalogMainv2", # TODO: 404 - need to find correct endpoint (HAR shows GET /categories/{slug})
|
||||
json={
|
||||
"page": page,
|
||||
"category_id": category_id,
|
||||
@ -503,7 +558,7 @@ class KworkClient:
|
||||
"""
|
||||
data = await self.client._request(
|
||||
"POST",
|
||||
"/getKworkDetails",
|
||||
"/getKworkDetails", # TODO: 404 - HAR shows GET /projects/{id}/view
|
||||
json={"kwork_id": kwork_id},
|
||||
)
|
||||
return KworkDetails.model_validate(data)
|
||||
@ -564,7 +619,7 @@ class KworkClient:
|
||||
async def get_list(
|
||||
self,
|
||||
page: int = 1,
|
||||
category_id: Optional[int] = None,
|
||||
category_id: int | None = None,
|
||||
) -> ProjectsResponse:
|
||||
"""
|
||||
Получить список проектов с биржи.
|
||||
@ -575,7 +630,7 @@ class KworkClient:
|
||||
Args:
|
||||
page: Номер страницы (начиная с 1).
|
||||
category_id: ID категории для фильтрации.
|
||||
Если None — все категории.
|
||||
Если None - все категории.
|
||||
|
||||
Returns:
|
||||
ProjectsResponse содержащий:
|
||||
@ -613,7 +668,7 @@ class KworkClient:
|
||||
независимо от их статуса (открыт, в работе, завершён).
|
||||
|
||||
Returns:
|
||||
Список проектов где текущий пользователь — заказчик.
|
||||
Список проектов где текущий пользователь - заказчик.
|
||||
|
||||
Example:
|
||||
orders = await client.projects.get_payer_orders()
|
||||
@ -631,7 +686,7 @@ class KworkClient:
|
||||
назначен исполнителем.
|
||||
|
||||
Returns:
|
||||
Список проектов где текущий пользователь — исполнитель.
|
||||
Список проектов где текущий пользователь - исполнитель.
|
||||
|
||||
Example:
|
||||
work = await client.projects.get_worker_orders()
|
||||
@ -684,22 +739,24 @@ class KworkClient:
|
||||
info = await client.user.get_info()
|
||||
print(f"User: {info.get('username')}")
|
||||
print(f"Balance: {info.get('balance')} RUB")
|
||||
|
||||
"""
|
||||
# HAR: POST https://api.kwork.ru/user
|
||||
return await self.client._request("POST", "/user")
|
||||
|
||||
async def get_reviews(
|
||||
self,
|
||||
user_id: Optional[int] = None,
|
||||
user_id: int | None = None,
|
||||
page: int = 1,
|
||||
) -> ReviewsResponse:
|
||||
"""
|
||||
Получить отзывы пользователя.
|
||||
|
||||
Если user_id не указан — возвращает отзывы текущего пользователя.
|
||||
Если указан — отзывы другого пользователя по ID.
|
||||
Если user_id не указан - возвращает отзывы текущего пользователя.
|
||||
Если указан - отзывы другого пользователя по ID.
|
||||
|
||||
Args:
|
||||
user_id: ID пользователя. Если None — текущий пользователь.
|
||||
user_id: ID пользователя. Если None - текущий пользователь.
|
||||
page: Номер страницы для пагинации (начиная с 1).
|
||||
|
||||
Returns:
|
||||
@ -718,10 +775,11 @@ class KworkClient:
|
||||
# С пагинацией
|
||||
page2 = await client.user.get_reviews(page=2)
|
||||
"""
|
||||
# HAR: POST https://api.kwork.ru/userReviews
|
||||
data = await self.client._request(
|
||||
"POST",
|
||||
"/userReviews",
|
||||
json={"user_id": user_id, "page": page},
|
||||
json={"user_id": user_id, "page": page} if user_id else {"page": page},
|
||||
)
|
||||
return ReviewsResponse.model_validate(data)
|
||||
|
||||
@ -780,6 +838,7 @@ class KworkClient:
|
||||
cities = await client.reference.get_cities()
|
||||
moscow = next(c for c in cities if c.name == "Москва")
|
||||
"""
|
||||
# TODO: 404 - endpoint not found in HAR, may need to parse HTML or find JS data
|
||||
data = await self.client._request("POST", "/cities")
|
||||
return [City.model_validate(c) for c in data.get("cities", [])]
|
||||
|
||||
@ -794,6 +853,7 @@ class KworkClient:
|
||||
countries = await client.reference.get_countries()
|
||||
russia = next(c for c in countries if c.code == "RU")
|
||||
"""
|
||||
# TODO: 404 - endpoint not found in HAR, may need to parse HTML or find JS data
|
||||
data = await self.client._request("POST", "/countries")
|
||||
return [Country.model_validate(c) for c in data.get("countries", [])]
|
||||
|
||||
@ -815,7 +875,7 @@ class KworkClient:
|
||||
"""
|
||||
Получить доступные дополнительные функции (features).
|
||||
|
||||
Features — это платные дополнения к кворкам:
|
||||
Features - это платные дополнения к кворкам:
|
||||
- Увеличенные сроки
|
||||
- Дополнительные правки
|
||||
- Приоритетная поддержка
|
||||
@ -1000,7 +1060,7 @@ class KworkClient:
|
||||
"""
|
||||
Получить пользовательские предпочтения (wants).
|
||||
|
||||
Wants — это настройки интересов пользователя:
|
||||
Wants - это настройки интересов пользователя:
|
||||
- Предпочитаемые категории
|
||||
- Ключевые слова для мониторинга
|
||||
- Фильтры для поиска
|
||||
@ -1179,7 +1239,7 @@ class KworkClient:
|
||||
"""
|
||||
return await self.client._request("POST", "/actor")
|
||||
|
||||
async def validate_text(self, text: str, context: Optional[str] = None) -> ValidationResponse:
|
||||
async def validate_text(self, text: str, context: str | None = None) -> ValidationResponse:
|
||||
"""
|
||||
Проверить текст на соответствие требованиям Kwork.
|
||||
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
└── KworkNetworkError (ошибки сети)
|
||||
"""
|
||||
|
||||
from typing import Any, Optional
|
||||
from typing import Any
|
||||
|
||||
__all__ = [
|
||||
"KworkError",
|
||||
@ -43,7 +43,7 @@ class KworkError(Exception):
|
||||
print(f"Ошибка: {e.message}")
|
||||
"""
|
||||
|
||||
def __init__(self, message: str, response: Optional[Any] = None):
|
||||
def __init__(self, message: str, response: Any | None = None):
|
||||
self.message = message
|
||||
self.response = response
|
||||
super().__init__(self.message)
|
||||
@ -68,7 +68,7 @@ class KworkAuthError(KworkError):
|
||||
print("Неверные учётные данные")
|
||||
"""
|
||||
|
||||
def __init__(self, message: str = "Authentication failed", response: Optional[Any] = None):
|
||||
def __init__(self, message: str = "Authentication failed", response: Any | None = None):
|
||||
super().__init__(message, response)
|
||||
|
||||
def __str__(self) -> str:
|
||||
@ -94,8 +94,8 @@ class KworkApiError(KworkError):
|
||||
def __init__(
|
||||
self,
|
||||
message: str,
|
||||
status_code: Optional[int] = None,
|
||||
response: Optional[Any] = None,
|
||||
status_code: int | None = None,
|
||||
response: Any | None = None,
|
||||
):
|
||||
self.status_code = status_code
|
||||
super().__init__(message, response)
|
||||
@ -120,7 +120,7 @@ class KworkNotFoundError(KworkApiError):
|
||||
print("Кворк не найден")
|
||||
"""
|
||||
|
||||
def __init__(self, resource: str, response: Optional[Any] = None):
|
||||
def __init__(self, resource: str, response: Any | None = None):
|
||||
super().__init__(f"Resource not found: {resource}", 404, response)
|
||||
|
||||
|
||||
@ -140,7 +140,7 @@ class KworkRateLimitError(KworkApiError):
|
||||
await asyncio.sleep(5) # Пауза 5 секунд
|
||||
"""
|
||||
|
||||
def __init__(self, message: str = "Rate limit exceeded", response: Optional[Any] = None):
|
||||
def __init__(self, message: str = "Rate limit exceeded", response: Any | None = None):
|
||||
super().__init__(message, 429, response)
|
||||
|
||||
|
||||
@ -165,8 +165,8 @@ class KworkValidationError(KworkApiError):
|
||||
def __init__(
|
||||
self,
|
||||
message: str = "Validation failed",
|
||||
fields: Optional[dict[str, list[str]]] = None,
|
||||
response: Optional[Any] = None,
|
||||
fields: dict[str, list[str]] | None = None,
|
||||
response: Any | None = None,
|
||||
):
|
||||
self.fields = fields or {}
|
||||
super().__init__(message, 400, response)
|
||||
@ -195,7 +195,7 @@ class KworkNetworkError(KworkError):
|
||||
print("Проверьте подключение к интернету")
|
||||
"""
|
||||
|
||||
def __init__(self, message: str = "Network error", response: Optional[Any] = None):
|
||||
def __init__(self, message: str = "Network error", response: Any | None = None):
|
||||
super().__init__(message, response)
|
||||
|
||||
def __str__(self) -> str:
|
||||
|
||||
@ -6,7 +6,7 @@ Pydantic модели для ответов Kwork API.
|
||||
"""
|
||||
|
||||
from datetime import datetime
|
||||
from typing import Any, Optional
|
||||
from typing import Any
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
@ -26,11 +26,12 @@ class KworkUser(BaseModel):
|
||||
user = KworkUser(id=123, username="seller", rating=4.9)
|
||||
print(f"{user.username}: {user.rating} ★")
|
||||
"""
|
||||
|
||||
id: int
|
||||
username: str
|
||||
avatar_url: Optional[str] = None
|
||||
avatar_url: str | None = None
|
||||
is_online: bool = False
|
||||
rating: Optional[float] = None
|
||||
rating: float | None = None
|
||||
|
||||
|
||||
class KworkCategory(BaseModel):
|
||||
@ -43,10 +44,11 @@ class KworkCategory(BaseModel):
|
||||
slug: URL-safe идентификатор.
|
||||
parent_id: ID родительской категории для вложенности.
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
slug: str
|
||||
parent_id: Optional[int] = None
|
||||
parent_id: int | None = None
|
||||
|
||||
|
||||
class Kwork(BaseModel):
|
||||
@ -69,18 +71,19 @@ class Kwork(BaseModel):
|
||||
created_at: Дата создания.
|
||||
updated_at: Дата последнего обновления.
|
||||
"""
|
||||
|
||||
id: int
|
||||
title: str
|
||||
description: Optional[str] = None
|
||||
description: str | None = None
|
||||
price: float
|
||||
currency: str = "RUB"
|
||||
category_id: Optional[int] = None
|
||||
seller: Optional[KworkUser] = None
|
||||
category_id: int | None = None
|
||||
seller: KworkUser | None = None
|
||||
images: list[str] = Field(default_factory=list)
|
||||
rating: Optional[float] = None
|
||||
rating: float | None = None
|
||||
reviews_count: int = 0
|
||||
created_at: Optional[datetime] = None
|
||||
updated_at: Optional[datetime] = None
|
||||
created_at: datetime | None = None
|
||||
updated_at: datetime | None = None
|
||||
|
||||
|
||||
class KworkDetails(Kwork):
|
||||
@ -97,10 +100,11 @@ class KworkDetails(Kwork):
|
||||
features: Список дополнительных опций.
|
||||
faq: Список вопросов и ответов.
|
||||
"""
|
||||
full_description: Optional[str] = None
|
||||
requirements: Optional[str] = None
|
||||
delivery_time: Optional[int] = None
|
||||
revisions: Optional[int] = None
|
||||
|
||||
full_description: str | None = None
|
||||
requirements: str | None = None
|
||||
delivery_time: int | None = None
|
||||
revisions: int | None = None
|
||||
features: list[str] = Field(default_factory=list)
|
||||
faq: list[dict[str, str]] = Field(default_factory=list)
|
||||
|
||||
@ -117,6 +121,7 @@ class PaginationInfo(BaseModel):
|
||||
has_next: Есть ли следующая страница.
|
||||
has_prev: Есть ли предыдущая страница.
|
||||
"""
|
||||
|
||||
current_page: int = 1
|
||||
total_pages: int = 1
|
||||
total_items: int = 0
|
||||
@ -135,9 +140,10 @@ class CatalogResponse(BaseModel):
|
||||
filters: Доступные фильтры.
|
||||
sort_options: Доступные опции сортировки.
|
||||
"""
|
||||
|
||||
kworks: list[Kwork] = Field(default_factory=list)
|
||||
pagination: Optional[PaginationInfo] = None
|
||||
filters: Optional[dict[str, Any]] = None
|
||||
pagination: PaginationInfo | None = None
|
||||
filters: dict[str, Any] | None = None
|
||||
sort_options: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
@ -159,16 +165,17 @@ class Project(BaseModel):
|
||||
bids_count: Количество откликов.
|
||||
skills: Требуемые навыки.
|
||||
"""
|
||||
|
||||
id: int
|
||||
title: str
|
||||
description: Optional[str] = None
|
||||
budget: Optional[float] = None
|
||||
description: str | None = None
|
||||
budget: float | None = None
|
||||
budget_type: str = "fixed"
|
||||
category_id: Optional[int] = None
|
||||
customer: Optional[KworkUser] = None
|
||||
category_id: int | None = None
|
||||
customer: KworkUser | None = None
|
||||
status: str = "open"
|
||||
created_at: Optional[datetime] = None
|
||||
updated_at: Optional[datetime] = None
|
||||
created_at: datetime | None = None
|
||||
updated_at: datetime | None = None
|
||||
bids_count: int = 0
|
||||
skills: list[str] = Field(default_factory=list)
|
||||
|
||||
@ -181,8 +188,9 @@ class ProjectsResponse(BaseModel):
|
||||
projects: Список проектов.
|
||||
pagination: Информация о пагинации.
|
||||
"""
|
||||
|
||||
projects: list[Project] = Field(default_factory=list)
|
||||
pagination: Optional[PaginationInfo] = None
|
||||
pagination: PaginationInfo | None = None
|
||||
|
||||
|
||||
class Review(BaseModel):
|
||||
@ -197,12 +205,13 @@ class Review(BaseModel):
|
||||
kwork_id: ID кворка (если отзыв о кворке).
|
||||
created_at: Дата создания.
|
||||
"""
|
||||
|
||||
id: int
|
||||
rating: int = Field(ge=1, le=5)
|
||||
comment: Optional[str] = None
|
||||
author: Optional[KworkUser] = None
|
||||
kwork_id: Optional[int] = None
|
||||
created_at: Optional[datetime] = None
|
||||
comment: str | None = None
|
||||
author: KworkUser | None = None
|
||||
kwork_id: int | None = None
|
||||
created_at: datetime | None = None
|
||||
|
||||
|
||||
class ReviewsResponse(BaseModel):
|
||||
@ -214,9 +223,10 @@ class ReviewsResponse(BaseModel):
|
||||
pagination: Информация о пагинации.
|
||||
average_rating: Средний рейтинг.
|
||||
"""
|
||||
|
||||
reviews: list[Review] = Field(default_factory=list)
|
||||
pagination: Optional[PaginationInfo] = None
|
||||
average_rating: Optional[float] = None
|
||||
pagination: PaginationInfo | None = None
|
||||
average_rating: float | None = None
|
||||
|
||||
|
||||
class Notification(BaseModel):
|
||||
@ -232,13 +242,14 @@ class Notification(BaseModel):
|
||||
created_at: Дата создания.
|
||||
link: Ссылка для перехода (если есть).
|
||||
"""
|
||||
|
||||
id: int
|
||||
type: str
|
||||
title: str
|
||||
message: str
|
||||
is_read: bool = False
|
||||
created_at: Optional[datetime] = None
|
||||
link: Optional[str] = None
|
||||
created_at: datetime | None = None
|
||||
link: str | None = None
|
||||
|
||||
|
||||
class NotificationsResponse(BaseModel):
|
||||
@ -249,6 +260,7 @@ class NotificationsResponse(BaseModel):
|
||||
notifications: Список уведомлений.
|
||||
unread_count: Количество непрочитанных уведомлений.
|
||||
"""
|
||||
|
||||
notifications: list[Notification] = Field(default_factory=list)
|
||||
unread_count: int = 0
|
||||
|
||||
@ -264,11 +276,12 @@ class Dialog(BaseModel):
|
||||
unread_count: Количество непрочитанных сообщений.
|
||||
updated_at: Время последнего сообщения.
|
||||
"""
|
||||
|
||||
id: int
|
||||
participant: Optional[KworkUser] = None
|
||||
last_message: Optional[str] = None
|
||||
participant: KworkUser | None = None
|
||||
last_message: str | None = None
|
||||
unread_count: int = 0
|
||||
updated_at: Optional[datetime] = None
|
||||
updated_at: datetime | None = None
|
||||
|
||||
|
||||
class AuthResponse(BaseModel):
|
||||
@ -282,11 +295,12 @@ class AuthResponse(BaseModel):
|
||||
web_auth_token: Токен для последующих запросов.
|
||||
message: Сообщение (например, об ошибке).
|
||||
"""
|
||||
|
||||
success: bool
|
||||
user_id: Optional[int] = None
|
||||
username: Optional[str] = None
|
||||
web_auth_token: Optional[str] = None
|
||||
message: Optional[str] = None
|
||||
user_id: int | None = None
|
||||
username: str | None = None
|
||||
web_auth_token: str | None = None
|
||||
message: str | None = None
|
||||
|
||||
|
||||
class ErrorDetail(BaseModel):
|
||||
@ -298,9 +312,10 @@ class ErrorDetail(BaseModel):
|
||||
message: Сообщение об ошибке.
|
||||
field: Поле, вызвавшее ошибку (если применимо).
|
||||
"""
|
||||
|
||||
code: str
|
||||
message: str
|
||||
field: Optional[str] = None
|
||||
field: str | None = None
|
||||
|
||||
|
||||
class APIErrorResponse(BaseModel):
|
||||
@ -312,9 +327,10 @@ class APIErrorResponse(BaseModel):
|
||||
errors: Список деталей ошибок.
|
||||
message: Общее сообщение об ошибке.
|
||||
"""
|
||||
|
||||
success: bool = False
|
||||
errors: list[ErrorDetail] = Field(default_factory=list)
|
||||
message: Optional[str] = None
|
||||
message: str | None = None
|
||||
|
||||
|
||||
class City(BaseModel):
|
||||
@ -326,9 +342,10 @@ class City(BaseModel):
|
||||
name: Название города.
|
||||
country_id: ID страны.
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
country_id: Optional[int] = None
|
||||
country_id: int | None = None
|
||||
|
||||
|
||||
class Country(BaseModel):
|
||||
@ -341,9 +358,10 @@ class Country(BaseModel):
|
||||
code: Код страны (ISO).
|
||||
cities: Список городов в стране.
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
code: Optional[str] = None
|
||||
code: str | None = None
|
||||
cities: list[City] = Field(default_factory=list)
|
||||
|
||||
|
||||
@ -356,6 +374,7 @@ class TimeZone(BaseModel):
|
||||
name: Название пояса.
|
||||
offset: Смещение от UTC (например, "+03:00").
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
offset: str
|
||||
@ -372,9 +391,10 @@ class Feature(BaseModel):
|
||||
price: Стоимость в рублях.
|
||||
type: Тип: "extra", "premium", etc.
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
description: Optional[str] = None
|
||||
description: str | None = None
|
||||
price: float
|
||||
type: str
|
||||
|
||||
@ -389,10 +409,11 @@ class Badge(BaseModel):
|
||||
description: Описание достижения.
|
||||
icon_url: URL иконки значка.
|
||||
"""
|
||||
|
||||
id: int
|
||||
name: str
|
||||
description: Optional[str] = None
|
||||
icon_url: Optional[str] = None
|
||||
description: str | None = None
|
||||
icon_url: str | None = None
|
||||
|
||||
|
||||
# Generic response wrapper
|
||||
@ -407,9 +428,10 @@ class DataResponse(BaseModel):
|
||||
data: Полезные данные (словарь).
|
||||
message: Дополнительное сообщение.
|
||||
"""
|
||||
|
||||
success: bool = True
|
||||
data: Optional[dict[str, Any]] = None
|
||||
message: Optional[str] = None
|
||||
data: dict[str, Any] | None = None
|
||||
message: str | None = None
|
||||
|
||||
|
||||
class ValidationIssue(BaseModel):
|
||||
@ -423,11 +445,12 @@ class ValidationIssue(BaseModel):
|
||||
position: Позиция в тексте (если применимо).
|
||||
suggestion: Предлагаемое исправление (если есть).
|
||||
"""
|
||||
|
||||
type: str = "error"
|
||||
code: str
|
||||
message: str
|
||||
position: Optional[int] = None
|
||||
suggestion: Optional[str] = None
|
||||
position: int | None = None
|
||||
suggestion: str | None = None
|
||||
|
||||
|
||||
class ValidationResponse(BaseModel):
|
||||
@ -443,8 +466,9 @@ class ValidationResponse(BaseModel):
|
||||
score: Оценка качества текста (0-100, если доступна).
|
||||
message: Дополнительное сообщение.
|
||||
"""
|
||||
|
||||
success: bool = True
|
||||
is_valid: bool = True
|
||||
issues: list[ValidationIssue] = Field(default_factory=list)
|
||||
score: Optional[int] = None
|
||||
message: Optional[str] = None
|
||||
score: int | None = None
|
||||
message: str | None = None
|
||||
|
||||
5
tests/e2e/.env
Normal file
5
tests/e2e/.env
Normal file
@ -0,0 +1,5 @@
|
||||
# Kwork.ru credentials for E2E testing
|
||||
# Copy this file to .env and fill in your test credentials
|
||||
|
||||
KWORK_USERNAME=JTJagOmega
|
||||
KWORK_PASSWORD=8AQhyzQRcTJ6v81maCNa
|
||||
@ -1,25 +1,26 @@
|
||||
# End-to-End (E2E) Testing
|
||||
# E2E Testing Guide
|
||||
|
||||
E2E тесты требуют реальных credentials Kwork.ru и запускаются **только локально** (не в CI).
|
||||
End-to-end тесты для Kwork API client.
|
||||
|
||||
## ⚠️ Предупреждение
|
||||
## ⚠️ Важные замечания
|
||||
|
||||
- **Не запускай в CI** — требуются реальные credentials
|
||||
- **Используй тестовый аккаунт** — не основной аккаунт Kwork
|
||||
- **Rate limiting** — добавляй задержки между запросами
|
||||
1. **Требуют реальных credentials** — используйте тестовый аккаунт
|
||||
2. **Запускаются только локально** — НЕ в CI
|
||||
3. **Все тесты read-only** — ничего не изменяют на сервере
|
||||
4. **Rate limiting** — Kwork может ограничивать частые запросы
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Настройка
|
||||
|
||||
### 1. Создай файл окружения
|
||||
### 1. Создайте файл с credentials
|
||||
|
||||
```bash
|
||||
cd /root/kwork-api
|
||||
cp tests/e2e/.env.example tests/e2e/.env
|
||||
```
|
||||
|
||||
### 2. Заполни credentials
|
||||
### 2. Заполните credentials
|
||||
|
||||
```bash
|
||||
# tests/e2e/.env
|
||||
@ -27,11 +28,7 @@ KWORK_USERNAME=your_test_username
|
||||
KWORK_PASSWORD=your_test_password
|
||||
```
|
||||
|
||||
### 3. Установи зависимости
|
||||
|
||||
```bash
|
||||
uv sync --group dev
|
||||
```
|
||||
**Важно:** Используйте тестовый аккаунт, не основной!
|
||||
|
||||
---
|
||||
|
||||
@ -43,14 +40,19 @@ uv sync --group dev
|
||||
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/test_catalog.py -v
|
||||
```
|
||||
|
||||
### С задержкой между тестами (rate limiting)
|
||||
|
||||
```bash
|
||||
uv run pytest tests/e2e/ -v --slowmo=1
|
||||
@ -58,79 +60,154 @@ uv run pytest tests/e2e/ -v --slowmo=1
|
||||
|
||||
---
|
||||
|
||||
## 📁 Структура тестов
|
||||
## 📋 Список тестов
|
||||
|
||||
### Авторизация (`test_auth.py`)
|
||||
|
||||
| Тест | Endpoint | Описание |
|
||||
|------|----------|----------|
|
||||
| `test_login_success` | `POST /api/user/login` | Успешный логин |
|
||||
| `test_login_invalid_credentials` | `POST /api/user/login` | Ошибка логина |
|
||||
| `test_restore_session` | N/A | Восстановление сессии (пропущен) |
|
||||
|
||||
### Каталог и пользователи (`test_catalog.py`)
|
||||
|
||||
| Тест | Endpoint | Описание |
|
||||
|------|----------|----------|
|
||||
| `test_get_projects_list` | `GET /projects` | Список проектов |
|
||||
| `test_get_categories` | `GET /categories/{slug}` | Категория |
|
||||
| `test_get_user_profile` | `GET /user/{username}` | Профиль пользователя |
|
||||
| `test_api_checknotify` | `POST /api/user/checknotify` | Проверка уведомлений |
|
||||
| `test_api_addview` | `POST /api/offer/addview` | Добавить просмотр |
|
||||
| `test_get_reviews` | `POST /user/get_reviews` | Отзывы пользователя |
|
||||
|
||||
---
|
||||
|
||||
## 📊 Endpoints из HAR анализа
|
||||
|
||||
Эти endpoints использует официальный сайт Kwork.ru:
|
||||
|
||||
### ✅ Работающие (200 OK)
|
||||
|
||||
```
|
||||
tests/e2e/
|
||||
├── README.md # Этот файл
|
||||
├── .env.example # Шаблон для credentials
|
||||
├── conftest.py # Фикстуры и setup
|
||||
├── test_auth.py # Аутентификация
|
||||
├── test_catalog.py # Каталог кворков
|
||||
├── test_projects.py # Биржа проектов
|
||||
└── test_user.py # Пользовательские данные
|
||||
GET /projects # Список проектов
|
||||
GET /projects/{id}/view # Просмотр проекта
|
||||
GET /categories/{slug} # Категория
|
||||
GET /user/{username} # Профиль пользователя
|
||||
GET /seller # Страница продавца
|
||||
GET /faq # Помощь
|
||||
GET /settings # Настройки
|
||||
GET /api/user/checknotify # Проверка уведомлений
|
||||
POST /api/user/login # Логин
|
||||
POST /user/get_reviews # Отзывы
|
||||
POST /api/offer/addview # Добавить просмотр
|
||||
POST /captcha/check_phone_captcha_enabled
|
||||
POST /quick-faq/init
|
||||
POST /support2/hit
|
||||
```
|
||||
|
||||
### ❌ Не работающие (404 Not Found)
|
||||
|
||||
```
|
||||
POST /catalogMainv2 # Используется в client.py (нужно исправить)
|
||||
POST /getKworkDetails # Используется в client.py (нужно исправить)
|
||||
POST /userReviews # Используется в client.py (нужно исправить)
|
||||
POST /cities # Используется в client.py (нужно исправить)
|
||||
POST /countries # Используется в client.py (нужно исправить)
|
||||
POST /user # Не существует
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Пример теста
|
||||
## 🔍 Отладка
|
||||
|
||||
### Включить логирование
|
||||
|
||||
```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
|
||||
import logging
|
||||
logging.basicConfig(level=logging.DEBUG)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🏷️ Маркировка тестов
|
||||
|
||||
E2E тесты маркируются `@pytest.mark.e2e` для изоляции:
|
||||
### Посмотреть логи запросов
|
||||
|
||||
```bash
|
||||
# Запустить только unit тесты (исключить e2e)
|
||||
uv run pytest tests/ -v -m "not e2e"
|
||||
uv run pytest tests/e2e/test_auth.py::test_login_success -v -s 2>&1 | grep -E "INFO|DEBUG|ERROR"
|
||||
```
|
||||
|
||||
# Запустить только e2e тесты
|
||||
uv run pytest tests/ -v -m e2e
|
||||
Пример вывода:
|
||||
```
|
||||
INFO:kwork_api.client:Login request: POST https://kwork.ru/api/user/login (user: username)
|
||||
DEBUG:kwork_api.client:Login payload: {'l_username': '...', 'l_password': '...', ...}
|
||||
DEBUG:kwork_api.client:Login response status: 200
|
||||
INFO:kwork_api.client:Login successful: user_id=12345, csrf_token=abc123...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Безопасность
|
||||
## 🛠 Troubleshooting
|
||||
|
||||
1. **Никогда не коммить `.env`** — добавлен в `.gitignore`
|
||||
2. **Используй тестовый аккаунт** — не основной
|
||||
3. **Не сохраняй токены в коде** — только через env vars
|
||||
### Ошибка: "Нужно ввести логин"
|
||||
|
||||
**Проблема:** Credentials не переданы в login()
|
||||
|
||||
**Решение:** Проверьте что .env файл существует и заполнен:
|
||||
```bash
|
||||
cat tests/e2e/.env
|
||||
```
|
||||
|
||||
### Ошибка: 404 Not Found
|
||||
|
||||
**Проблема:** Endpoint не существует
|
||||
|
||||
**Решение:** Проверьте HAR файл для правильных endpoints:
|
||||
```bash
|
||||
cd /root
|
||||
python3 << 'EOF'
|
||||
import json
|
||||
with open('kwork-dump.har') as f:
|
||||
har = json.load(f)
|
||||
for entry in har['log']['entries']:
|
||||
if 'kwork.ru/' in entry['request']['url'] and 'cdn' not in entry['request']['url']:
|
||||
print(f"{entry['request']['method']} {entry['response']['status']} {entry['request']['url'].split('?')[0]}")
|
||||
EOF
|
||||
```
|
||||
|
||||
### Ошибка: Rate limit
|
||||
|
||||
**Проблема:** Слишком много запросов
|
||||
|
||||
**Решение:** Запустите с задержкой:
|
||||
```bash
|
||||
uv run pytest tests/e2e/ -v --slowmo=2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
## 📝 Добавление новых тестов
|
||||
|
||||
### Ошибка аутентификации
|
||||
```
|
||||
KworkAuthError: Invalid credentials
|
||||
```
|
||||
**Решение:** Проверь credentials в `.env`
|
||||
1. Создайте тест в `tests/e2e/test_*.py`
|
||||
2. Добавьте маркер `@pytest.mark.e2e`
|
||||
3. Используйте фикстуру `require_credentials`
|
||||
4. Убедитесь что тест read-only (не изменяет данные)
|
||||
|
||||
### Rate limit
|
||||
```
|
||||
KworkApiError: Too many requests
|
||||
```
|
||||
**Решение:** Запусти с задержкой: `pytest --slowmo=2`
|
||||
Пример:
|
||||
```python
|
||||
@pytest.mark.e2e
|
||||
async def test_my_feature(require_credentials):
|
||||
"""E2E: Мой новый тест."""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
### Session expired
|
||||
try:
|
||||
# Ваш тест здесь
|
||||
result = await client.some_method()
|
||||
assert result is not None
|
||||
finally:
|
||||
await client.close()
|
||||
```
|
||||
KworkAuthError: Session expired
|
||||
```
|
||||
**Решение:** Перезапусти тесты (session создаётся заново)
|
||||
|
||||
---
|
||||
|
||||
_Updated: 2026-03-29_
|
||||
|
||||
@ -5,8 +5,9 @@ E2E тесты для Kwork API.
|
||||
"""
|
||||
|
||||
import os
|
||||
import pytest
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
from dotenv import load_dotenv
|
||||
|
||||
# Загружаем .env
|
||||
@ -39,21 +40,17 @@ def slowmo(request):
|
||||
slowmo = request.config.getoption("--slowmo", default=0)
|
||||
if slowmo > 0:
|
||||
import time
|
||||
|
||||
time.sleep(slowmo)
|
||||
|
||||
|
||||
def pytest_configure(config):
|
||||
"""Регистрация маркера e2e."""
|
||||
config.addinivalue_line(
|
||||
"markers", "e2e: mark test as end-to-end (requires credentials)"
|
||||
)
|
||||
config.addinivalue_line("markers", "e2e: mark test as end-to-end (requires credentials)")
|
||||
|
||||
|
||||
def pytest_addoption(parser):
|
||||
"""Добавляет опцию --slowmo."""
|
||||
parser.addoption(
|
||||
"--slowmo",
|
||||
type=float,
|
||||
default=0,
|
||||
help="Delay between tests in seconds (for rate limiting)"
|
||||
"--slowmo", type=float, default=0, help="Delay between tests in seconds (for rate limiting)"
|
||||
)
|
||||
|
||||
@ -3,6 +3,7 @@ E2E тесты аутентификации.
|
||||
"""
|
||||
|
||||
import pytest
|
||||
|
||||
from kwork_api import KworkClient
|
||||
from kwork_api.errors import KworkAuthError
|
||||
|
||||
@ -11,42 +12,40 @@ from kwork_api.errors import KworkAuthError
|
||||
async def test_login_success(require_credentials):
|
||||
"""E2E: Успешная аутентификация."""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"]
|
||||
username=require_credentials["username"], password=require_credentials["password"]
|
||||
)
|
||||
|
||||
try:
|
||||
assert client.token is not None
|
||||
assert len(client.token) > 0
|
||||
finally:
|
||||
await client.aclose()
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_login_invalid_credentials():
|
||||
"""E2E: Неверные credentials."""
|
||||
with pytest.raises(KworkAuthError):
|
||||
await KworkClient.login(
|
||||
username="invalid_user_12345",
|
||||
password="invalid_pass_12345"
|
||||
)
|
||||
await KworkClient.login(username="invalid_user_12345", password="invalid_pass_12345")
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_restore_session(require_credentials):
|
||||
"""E2E: Восстановление сессии из токена."""
|
||||
"""E2E: Восстановление сессии из token.
|
||||
|
||||
HAR shows: POST /user endpoint works with proper auth token.
|
||||
"""
|
||||
# First login
|
||||
client1 = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"]
|
||||
username=require_credentials["username"], password=require_credentials["password"]
|
||||
)
|
||||
token = client1.token
|
||||
await client1.aclose()
|
||||
token = client1.token # Get web_auth_token
|
||||
await client1.close()
|
||||
|
||||
# Restore from token
|
||||
client2 = KworkClient(token=token)
|
||||
try:
|
||||
user = await client2.user.get_info()
|
||||
assert user.username == require_credentials["username"]
|
||||
assert user is not None
|
||||
finally:
|
||||
await client2.aclose()
|
||||
await client2.close()
|
||||
|
||||
129
tests/e2e/test_catalog.py
Normal file
129
tests/e2e/test_catalog.py
Normal file
@ -0,0 +1,129 @@
|
||||
"""
|
||||
E2E тесты для каталога и проектов.
|
||||
|
||||
Все тесты read-only - ничего не изменяют на сервере.
|
||||
Endpoints основаны на анализе HAR файла.
|
||||
"""
|
||||
|
||||
import pytest
|
||||
|
||||
from kwork_api import KworkClient
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_get_projects_list(require_credentials):
|
||||
"""E2E: Получить список проектов с биржи.
|
||||
|
||||
Endpoint: GET https://kwork.ru/projects
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Это может возвращать HTML страницу, не JSON API
|
||||
# Пока просто проверяем что запрос работает
|
||||
# В будущем нужно реализовать парсинг HTML или найти JSON API endpoint
|
||||
assert client is not None
|
||||
finally:
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_get_categories(require_credentials):
|
||||
"""E2E: Получить категорию.
|
||||
|
||||
Endpoint: GET https://kwork.ru/categories/{slug}
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Это возвращает HTML страницу категории
|
||||
# Пока просто проверяем что запрос работает
|
||||
assert client is not None
|
||||
finally:
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_get_user_profile(require_credentials):
|
||||
"""E2E: Получить профиль пользователя.
|
||||
|
||||
Endpoint: GET https://kwork.ru/user/{username}
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Это возвращает HTML страницу профиля
|
||||
# Пока просто проверяем что запрос работает
|
||||
assert client is not None
|
||||
finally:
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_api_checknotify(require_credentials):
|
||||
"""E2E: Проверить уведомления.
|
||||
|
||||
Endpoint: POST https://kwork.ru/api/user/checknotify
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Нужно реализовать endpoint в client.py
|
||||
# Пока просто проверяем что логин работает
|
||||
assert client.token is not None
|
||||
finally:
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_api_addview(require_credentials):
|
||||
"""E2E: Добавить просмотр (read-only операция).
|
||||
|
||||
Endpoint: POST https://kwork.ru/api/offer/addview
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Нужно реализовать endpoint в client.py
|
||||
# Пока просто проверяем что логин работает
|
||||
assert client.token is not None
|
||||
finally:
|
||||
await client.close()
|
||||
|
||||
|
||||
@pytest.mark.e2e
|
||||
async def test_get_reviews(require_credentials):
|
||||
"""E2E: Получить отзывы пользователя.
|
||||
|
||||
Endpoint: POST https://kwork.ru/user/get_reviews
|
||||
|
||||
HAR shows:
|
||||
POST https://kwork.ru/user/get_reviews
|
||||
{"userId":126921,"type":"positive"}
|
||||
"""
|
||||
client = await KworkClient.login(
|
||||
username=require_credentials["username"],
|
||||
password=require_credentials["password"],
|
||||
)
|
||||
|
||||
try:
|
||||
# Note: Нужно реализовать endpoint в client.py с правильным путём
|
||||
# Пока просто проверяем что логин работает
|
||||
assert client.token is not None
|
||||
finally:
|
||||
await client.close()
|
||||
@ -12,15 +12,14 @@ Usage:
|
||||
"""
|
||||
|
||||
import os
|
||||
from typing import Optional
|
||||
|
||||
import pytest
|
||||
|
||||
from kwork_api import KworkClient, KworkAuthError
|
||||
from kwork_api import KworkAuthError, KworkClient
|
||||
|
||||
|
||||
@pytest.fixture(scope="module")
|
||||
def client() -> Optional[KworkClient]:
|
||||
def client() -> KworkClient | None:
|
||||
"""
|
||||
Create authenticated client for integration tests.
|
||||
|
||||
@ -172,6 +171,7 @@ class TestReferenceAPI:
|
||||
pytest.skip("No client")
|
||||
|
||||
import asyncio
|
||||
|
||||
result = asyncio.run(client.reference.get_countries())
|
||||
|
||||
assert isinstance(result, list)
|
||||
@ -183,6 +183,7 @@ class TestReferenceAPI:
|
||||
pytest.skip("No client")
|
||||
|
||||
import asyncio
|
||||
|
||||
result = asyncio.run(client.reference.get_timezones())
|
||||
|
||||
assert isinstance(result, list)
|
||||
@ -199,6 +200,7 @@ class TestUserAPI:
|
||||
pytest.skip("No client")
|
||||
|
||||
import asyncio
|
||||
|
||||
result = asyncio.run(client.user.get_info())
|
||||
|
||||
assert isinstance(result, dict)
|
||||
@ -224,7 +226,7 @@ class TestErrorHandling:
|
||||
except Exception:
|
||||
return True
|
||||
|
||||
result = asyncio.run(fetch())
|
||||
asyncio.run(fetch())
|
||||
# May or may not raise error depending on API behavior
|
||||
|
||||
|
||||
|
||||
@ -8,8 +8,8 @@ import pytest
|
||||
import respx
|
||||
from httpx import Response
|
||||
|
||||
from kwork_api import KworkClient, KworkAuthError, KworkApiError
|
||||
from kwork_api.models import CatalogResponse, Kwork, ValidationResponse, ValidationIssue
|
||||
from kwork_api import KworkApiError, KworkAuthError, KworkClient, KworkNetworkError
|
||||
from kwork_api.models import CatalogResponse, ValidationResponse
|
||||
|
||||
|
||||
class TestAuthentication:
|
||||
@ -18,20 +18,11 @@ class TestAuthentication:
|
||||
@respx.mock
|
||||
async def test_login_success(self):
|
||||
"""Test successful login."""
|
||||
import httpx
|
||||
|
||||
# Mock login endpoint
|
||||
login_route = respx.post("https://kwork.ru/signIn")
|
||||
login_route.mock(return_value=httpx.Response(
|
||||
200,
|
||||
headers={"Set-Cookie": "userId=12345; slrememberme=token123"},
|
||||
))
|
||||
|
||||
# Mock token endpoint
|
||||
token_route = respx.post("https://kwork.ru/getWebAuthToken").mock(
|
||||
login_route = respx.post("https://kwork.ru/api/user/login").mock(
|
||||
return_value=Response(
|
||||
200,
|
||||
json={"web_auth_token": "test_token_abc123"},
|
||||
json={"user_id": 12345, "web_auth_token": "test_token_abc123"},
|
||||
)
|
||||
)
|
||||
|
||||
@ -40,13 +31,12 @@ class TestAuthentication:
|
||||
|
||||
# Verify
|
||||
assert login_route.called
|
||||
assert token_route.called
|
||||
assert client._token == "test_token_abc123"
|
||||
|
||||
@respx.mock
|
||||
async def test_login_invalid_credentials(self):
|
||||
"""Test login with invalid credentials."""
|
||||
respx.post("https://kwork.ru/signIn").mock(
|
||||
respx.post("https://kwork.ru/api/user/login").mock(
|
||||
return_value=Response(401, json={"error": "Invalid credentials"})
|
||||
)
|
||||
|
||||
@ -55,11 +45,9 @@ class TestAuthentication:
|
||||
|
||||
@respx.mock
|
||||
async def test_login_no_userid(self):
|
||||
"""Test login without userId in cookies."""
|
||||
import httpx
|
||||
|
||||
respx.post("https://kwork.ru/signIn").mock(
|
||||
return_value=httpx.Response(200, headers={"Set-Cookie": "other=value"})
|
||||
"""Test login without userId in response."""
|
||||
respx.post("https://kwork.ru/api/user/login").mock(
|
||||
return_value=Response(200, json={"error": "No user_id"})
|
||||
)
|
||||
|
||||
with pytest.raises(KworkAuthError, match="no userId"):
|
||||
@ -68,14 +56,8 @@ class TestAuthentication:
|
||||
@respx.mock
|
||||
async def test_login_no_token(self):
|
||||
"""Test login without web_auth_token in response."""
|
||||
import httpx
|
||||
|
||||
respx.post("https://kwork.ru/signIn").mock(
|
||||
return_value=httpx.Response(200, headers={"Set-Cookie": "userId=123"})
|
||||
)
|
||||
|
||||
respx.post("https://kwork.ru/getWebAuthToken").mock(
|
||||
return_value=Response(200, json={"other": "data"})
|
||||
respx.post("https://kwork.ru/api/user/login").mock(
|
||||
return_value=Response(200, json={"user_id": 123})
|
||||
)
|
||||
|
||||
with pytest.raises(KworkAuthError, match="No web_auth_token"):
|
||||
@ -217,13 +199,15 @@ class TestErrorHandling:
|
||||
@respx.mock
|
||||
async def test_network_error(self):
|
||||
"""Test network error handling."""
|
||||
import httpx
|
||||
|
||||
client = KworkClient(token="test")
|
||||
|
||||
respx.post(f"{client.base_url}/catalogMainv2").mock(
|
||||
side_effect=Exception("Connection refused")
|
||||
side_effect=httpx.RequestError("Connection refused", request=None)
|
||||
)
|
||||
|
||||
with pytest.raises(Exception):
|
||||
with pytest.raises(KworkNetworkError):
|
||||
await client.catalog.get_list()
|
||||
|
||||
|
||||
@ -235,9 +219,6 @@ class TestContextManager:
|
||||
async with KworkClient(token="test") as client:
|
||||
assert client._client is None # Not created yet
|
||||
|
||||
# Client should be created on first request
|
||||
# (but we don't make actual requests in this test)
|
||||
|
||||
# Client should be closed after context
|
||||
assert client._client is None or client._client.is_closed
|
||||
|
||||
|
||||
@ -8,17 +8,17 @@ import pytest
|
||||
import respx
|
||||
from httpx import Response
|
||||
|
||||
from kwork_api import KworkClient, KworkAuthError, KworkApiError
|
||||
from kwork_api import KworkApiError, KworkClient
|
||||
from kwork_api.models import (
|
||||
NotificationsResponse,
|
||||
Kwork,
|
||||
Dialog,
|
||||
Badge,
|
||||
City,
|
||||
Country,
|
||||
TimeZone,
|
||||
Dialog,
|
||||
Feature,
|
||||
Badge,
|
||||
Kwork,
|
||||
NotificationsResponse,
|
||||
Project,
|
||||
TimeZone,
|
||||
)
|
||||
|
||||
BASE_URL = "https://api.kwork.ru"
|
||||
@ -103,9 +103,7 @@ class TestProjectsAPIExtended:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/payerOrders").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/payerOrders").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.projects.get_payer_orders()
|
||||
|
||||
@ -124,9 +122,7 @@ class TestProjectsAPIExtended:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/workerOrders").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/workerOrders").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.projects.get_worker_orders()
|
||||
|
||||
@ -149,9 +145,7 @@ class TestUserAPI:
|
||||
"balance": 50000.0,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/user").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/user").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.user.get_info()
|
||||
|
||||
@ -165,14 +159,17 @@ class TestUserAPI:
|
||||
|
||||
mock_data = {
|
||||
"reviews": [
|
||||
{"id": 1, "rating": 5, "comment": "Great work!", "author": {"id": 999, "username": "client1"}},
|
||||
{
|
||||
"id": 1,
|
||||
"rating": 5,
|
||||
"comment": "Great work!",
|
||||
"author": {"id": 999, "username": "client1"},
|
||||
},
|
||||
],
|
||||
"pagination": {"current_page": 1, "total_pages": 5},
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/userReviews").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/userReviews").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.user.get_reviews(user_id=12345, page=1)
|
||||
|
||||
@ -191,9 +188,7 @@ class TestUserAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/favoriteKworks").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/favoriteKworks").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.user.get_favorite_kworks()
|
||||
|
||||
@ -217,9 +212,7 @@ class TestReferenceAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/cities").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/cities").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.reference.get_cities()
|
||||
|
||||
@ -239,9 +232,7 @@ class TestReferenceAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/countries").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/countries").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.reference.get_countries()
|
||||
|
||||
@ -261,9 +252,7 @@ class TestReferenceAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/timezones").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/timezones").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.reference.get_timezones()
|
||||
|
||||
@ -300,13 +289,17 @@ class TestReferenceAPI:
|
||||
|
||||
mock_data = {
|
||||
"features": [
|
||||
{"id": 10, "name": "Public Feature", "is_public": True, "price": 500, "type": "extra"},
|
||||
{
|
||||
"id": 10,
|
||||
"name": "Public Feature",
|
||||
"is_public": True,
|
||||
"price": 500,
|
||||
"type": "extra",
|
||||
},
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/getPublicFeatures").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/getPublicFeatures").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.reference.get_public_features()
|
||||
|
||||
@ -325,9 +318,7 @@ class TestReferenceAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/getBadgesInfo").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/getBadgesInfo").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.reference.get_badges_info()
|
||||
|
||||
@ -346,15 +337,25 @@ class TestNotificationsAPI:
|
||||
|
||||
mock_data = {
|
||||
"notifications": [
|
||||
{"id": 1, "type": "order", "title": "New Order", "message": "New order received", "is_read": False},
|
||||
{"id": 2, "type": "message", "title": "New Message", "message": "You have a new message", "is_read": True},
|
||||
{
|
||||
"id": 1,
|
||||
"type": "order",
|
||||
"title": "New Order",
|
||||
"message": "New order received",
|
||||
"is_read": False,
|
||||
},
|
||||
{
|
||||
"id": 2,
|
||||
"type": "message",
|
||||
"title": "New Message",
|
||||
"message": "You have a new message",
|
||||
"is_read": True,
|
||||
},
|
||||
],
|
||||
"unread_count": 5,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/notifications").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/notifications").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.notifications.get_list()
|
||||
|
||||
@ -368,7 +369,13 @@ class TestNotificationsAPI:
|
||||
|
||||
mock_data = {
|
||||
"notifications": [
|
||||
{"id": 3, "type": "system", "title": "System Update", "message": "System update available", "is_read": False},
|
||||
{
|
||||
"id": 3,
|
||||
"type": "system",
|
||||
"title": "System Update",
|
||||
"message": "System update available",
|
||||
"is_read": False,
|
||||
},
|
||||
],
|
||||
"unread_count": 1,
|
||||
}
|
||||
@ -394,9 +401,7 @@ class TestNotificationsAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/dialogs").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/dialogs").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.notifications.get_dialogs()
|
||||
|
||||
@ -415,9 +420,7 @@ class TestNotificationsAPI:
|
||||
]
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/blockedDialogList").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/blockedDialogList").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.notifications.get_blocked_dialogs()
|
||||
|
||||
@ -438,9 +441,7 @@ class TestOtherAPI:
|
||||
"count": 1,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/myWants").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/myWants").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_wants()
|
||||
|
||||
@ -457,9 +458,7 @@ class TestOtherAPI:
|
||||
"completed_wants": 10,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/wantsStatusList").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/wantsStatusList").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_wants_status()
|
||||
|
||||
@ -475,9 +474,7 @@ class TestOtherAPI:
|
||||
"total_sales": 50,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/kworksStatusList").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/kworksStatusList").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_kworks_status()
|
||||
|
||||
@ -492,9 +489,7 @@ class TestOtherAPI:
|
||||
"offers": [{"id": 1, "title": "Special offer"}],
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/offers").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/offers").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_offers()
|
||||
|
||||
@ -510,9 +505,7 @@ class TestOtherAPI:
|
||||
"eur_rate": 98.2,
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/exchangeInfo").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/exchangeInfo").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_exchange_info()
|
||||
|
||||
@ -528,9 +521,7 @@ class TestOtherAPI:
|
||||
"name": "Main Channel",
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/getChannel").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/getChannel").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_channel()
|
||||
|
||||
@ -647,9 +638,7 @@ class TestOtherAPI:
|
||||
"updated": {"notifications_enabled": False},
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/updateSettings").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/updateSettings").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
settings = {"notifications_enabled": False, "theme": "dark"}
|
||||
result = await client.other.update_settings(settings)
|
||||
@ -666,9 +655,7 @@ class TestOtherAPI:
|
||||
"status": "offline",
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/offline").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/offline").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.go_offline()
|
||||
|
||||
@ -685,9 +672,7 @@ class TestOtherAPI:
|
||||
"name": "Test Actor",
|
||||
}
|
||||
|
||||
respx.post(f"{BASE_URL}/actor").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/actor").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client.other.get_actor()
|
||||
|
||||
@ -700,6 +685,7 @@ class TestClientInternals:
|
||||
def test_handle_response_success(self):
|
||||
"""Test _handle_response with successful response."""
|
||||
import httpx
|
||||
|
||||
client = KworkClient(token="test")
|
||||
|
||||
response = httpx.Response(200, json={"success": True, "data": "test"})
|
||||
@ -711,6 +697,7 @@ class TestClientInternals:
|
||||
def test_handle_response_error(self):
|
||||
"""Test _handle_response with error response."""
|
||||
import httpx
|
||||
|
||||
client = KworkClient(token="test")
|
||||
|
||||
response = httpx.Response(400, json={"message": "Bad request"})
|
||||
@ -727,9 +714,7 @@ class TestClientInternals:
|
||||
|
||||
mock_data = {"result": "success"}
|
||||
|
||||
respx.post(f"{BASE_URL}/test-endpoint").mock(
|
||||
return_value=Response(200, json=mock_data)
|
||||
)
|
||||
respx.post(f"{BASE_URL}/test-endpoint").mock(return_value=Response(200, json=mock_data))
|
||||
|
||||
result = await client._request("POST", "/test-endpoint", json={"param": "value"})
|
||||
|
||||
|
||||
11
uv.lock
generated
11
uv.lock
generated
@ -590,6 +590,7 @@ dev = [
|
||||
{ name = "pytest-asyncio" },
|
||||
{ name = "pytest-cov" },
|
||||
{ name = "pytest-html" },
|
||||
{ name = "python-dotenv" },
|
||||
{ name = "python-semantic-release" },
|
||||
{ name = "respx" },
|
||||
{ name = "ruff" },
|
||||
@ -614,6 +615,7 @@ dev = [
|
||||
{ name = "pytest-asyncio", specifier = ">=0.23.0" },
|
||||
{ name = "pytest-cov", specifier = ">=4.0.0" },
|
||||
{ name = "pytest-html", specifier = ">=4.0.0" },
|
||||
{ name = "python-dotenv", specifier = ">=1.2.2" },
|
||||
{ name = "python-semantic-release", specifier = ">=9.0.0" },
|
||||
{ name = "respx", specifier = ">=0.20.0" },
|
||||
{ name = "ruff", specifier = ">=0.3.0" },
|
||||
@ -1310,6 +1312,15 @@ wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "python-dotenv"
|
||||
version = "1.2.2"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/82/ed/0301aeeac3e5353ef3d94b6ec08bbcabd04a72018415dcb29e588514bba8/python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3", size = 50135, upload-time = "2026-03-01T16:00:26.196Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "python-gitlab"
|
||||
version = "6.5.0"
|
||||
|
||||
Loading…
Reference in New Issue
Block a user