refactor: вернул OtherAPI как отдельный класс
OtherAPI остаётся отдельным классом с property accessor: - client.other.get_wants() - client.other.get_kworks_status() - client.other.go_offline() - и т.д.
This commit is contained in:
parent
127e5927bc
commit
6ad63ee3e0
Binary file not shown.
@ -907,7 +907,32 @@ class KworkClient:
|
|||||||
data = await self.client._request("POST", "/blockedDialogList")
|
data = await self.client._request("POST", "/blockedDialogList")
|
||||||
return [Dialog.model_validate(d) for d in data.get("dialogs", [])]
|
return [Dialog.model_validate(d) for d in data.get("dialogs", [])]
|
||||||
|
|
||||||
# ========== User Settings & Preferences ==========
|
# ========== Other Endpoints ==========
|
||||||
|
|
||||||
|
class OtherAPI:
|
||||||
|
"""
|
||||||
|
Прочее API.
|
||||||
|
|
||||||
|
Вспомогательные эндпоинты которые не вошли в другие категории:
|
||||||
|
- Пользовательские настройки и предпочтения (wants)
|
||||||
|
- Статусы кворков и заказов
|
||||||
|
- Персональные предложения (offers)
|
||||||
|
- Настройки профиля
|
||||||
|
- Статус онлайн/оффлайн
|
||||||
|
|
||||||
|
Example:
|
||||||
|
# Пользовательские предпочтения
|
||||||
|
wants = await client.other.get_wants()
|
||||||
|
|
||||||
|
# Статус кворков
|
||||||
|
status = await client.other.get_kworks_status()
|
||||||
|
|
||||||
|
# Установить статус оффлайн
|
||||||
|
await client.other.go_offline()
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self, client: "KworkClient"):
|
||||||
|
self.client = client
|
||||||
|
|
||||||
async def get_wants(self) -> dict[str, Any]:
|
async def get_wants(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -922,10 +947,10 @@ class KworkClient:
|
|||||||
Словарь с настройками предпочтений.
|
Словарь с настройками предпочтений.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
wants = await client.get_wants()
|
wants = await client.other.get_wants()
|
||||||
print(wants)
|
print(wants)
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/myWants")
|
return await self.client._request("POST", "/myWants")
|
||||||
|
|
||||||
async def get_wants_status(self) -> dict[str, Any]:
|
async def get_wants_status(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -934,7 +959,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Статус wants с метаданными.
|
Статус wants с метаданными.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/wantsStatusList")
|
return await self.client._request("POST", "/wantsStatusList")
|
||||||
|
|
||||||
async def get_kworks_status(self) -> dict[str, Any]:
|
async def get_kworks_status(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -947,10 +972,10 @@ class KworkClient:
|
|||||||
Словарь со статусами кворков.
|
Словарь со статусами кворков.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
status = await client.get_kworks_status()
|
status = await client.other.get_kworks_status()
|
||||||
print(status)
|
print(status)
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/kworksStatusList")
|
return await self.client._request("POST", "/kworksStatusList")
|
||||||
|
|
||||||
async def get_offers(self) -> dict[str, Any]:
|
async def get_offers(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -959,7 +984,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Список персональных предложений от Kwork.
|
Список персональных предложений от Kwork.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/offers")
|
return await self.client._request("POST", "/offers")
|
||||||
|
|
||||||
async def get_exchange_info(self) -> dict[str, Any]:
|
async def get_exchange_info(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -968,7 +993,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Информация о курсах валют и обмене.
|
Информация о курсах валют и обмене.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/exchangeInfo")
|
return await self.client._request("POST", "/exchangeInfo")
|
||||||
|
|
||||||
async def get_channel(self) -> dict[str, Any]:
|
async def get_channel(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -977,7 +1002,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Данные канала (если есть).
|
Данные канала (если есть).
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/getChannel")
|
return await self.client._request("POST", "/getChannel")
|
||||||
|
|
||||||
async def get_in_app_notification(self) -> dict[str, Any]:
|
async def get_in_app_notification(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -986,7 +1011,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Данные in-app уведомления.
|
Данные in-app уведомления.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/getInAppNotification")
|
return await self.client._request("POST", "/getInAppNotification")
|
||||||
|
|
||||||
async def get_security_user_data(self) -> dict[str, Any]:
|
async def get_security_user_data(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -995,7 +1020,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Информация о безопасности аккаунта.
|
Информация о безопасности аккаунта.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/getSecurityUserData")
|
return await self.client._request("POST", "/getSecurityUserData")
|
||||||
|
|
||||||
async def is_dialog_allow(self, user_id: int) -> bool:
|
async def is_dialog_allow(self, user_id: int) -> bool:
|
||||||
"""
|
"""
|
||||||
@ -1008,11 +1033,11 @@ class KworkClient:
|
|||||||
True если диалог разрешён, False иначе.
|
True если диалог разрешён, False иначе.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
allowed = await client.is_dialog_allow(12345)
|
allowed = await client.other.is_dialog_allow(12345)
|
||||||
if allowed:
|
if allowed:
|
||||||
print("Можно написать сообщение")
|
print("Можно написать сообщение")
|
||||||
"""
|
"""
|
||||||
data = await self._request(
|
data = await self.client._request(
|
||||||
"POST",
|
"POST",
|
||||||
"/isDialogAllow",
|
"/isDialogAllow",
|
||||||
json={"user_id": user_id},
|
json={"user_id": user_id},
|
||||||
@ -1030,10 +1055,10 @@ class KworkClient:
|
|||||||
Список просмотренных кворков.
|
Список просмотренных кворков.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
viewed = await client.get_viewed_kworks()
|
viewed = await client.other.get_viewed_kworks()
|
||||||
print(f"Просмотрено: {len(viewed)} кворков")
|
print(f"Просмотрено: {len(viewed)} кворков")
|
||||||
"""
|
"""
|
||||||
data = await self._request("POST", "/viewedCatalogKworks")
|
data = await self.client._request("POST", "/viewedCatalogKworks")
|
||||||
return [Kwork.model_validate(k) for k in data.get("kworks", [])]
|
return [Kwork.model_validate(k) for k in data.get("kworks", [])]
|
||||||
|
|
||||||
async def get_favorite_categories(self) -> list[int]:
|
async def get_favorite_categories(self) -> list[int]:
|
||||||
@ -1044,10 +1069,10 @@ class KworkClient:
|
|||||||
Список ID категорий, добавленных в избранное.
|
Список ID категорий, добавленных в избранное.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
cats = await client.get_favorite_categories()
|
cats = await client.other.get_favorite_categories()
|
||||||
print(f"Избранные категории: {cats}")
|
print(f"Избранные категории: {cats}")
|
||||||
"""
|
"""
|
||||||
data = await self._request("POST", "/favoriteCategories")
|
data = await self.client._request("POST", "/favoriteCategories")
|
||||||
return data.get("categories", [])
|
return data.get("categories", [])
|
||||||
|
|
||||||
async def update_settings(self, settings: dict[str, Any]) -> dict[str, Any]:
|
async def update_settings(self, settings: dict[str, Any]) -> dict[str, Any]:
|
||||||
@ -1062,12 +1087,12 @@ class KworkClient:
|
|||||||
Ответ API с подтверждением обновления.
|
Ответ API с подтверждением обновления.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
await client.update_settings({
|
await client.other.update_settings({
|
||||||
"email_notifications": True,
|
"email_notifications": True,
|
||||||
"language": "ru"
|
"language": "ru"
|
||||||
})
|
})
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/updateSettings", json=settings)
|
return await self.client._request("POST", "/updateSettings", json=settings)
|
||||||
|
|
||||||
async def go_offline(self) -> dict[str, Any]:
|
async def go_offline(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -1079,9 +1104,9 @@ class KworkClient:
|
|||||||
Подтверждение изменения статуса.
|
Подтверждение изменения статуса.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
await client.go_offline()
|
await client.other.go_offline()
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/offline")
|
return await self.client._request("POST", "/offline")
|
||||||
|
|
||||||
async def get_actor(self) -> dict[str, Any]:
|
async def get_actor(self) -> dict[str, Any]:
|
||||||
"""
|
"""
|
||||||
@ -1090,7 +1115,7 @@ class KworkClient:
|
|||||||
Returns:
|
Returns:
|
||||||
Данные актёра/пользователя.
|
Данные актёра/пользователя.
|
||||||
"""
|
"""
|
||||||
return await self._request("POST", "/actor")
|
return await self.client._request("POST", "/actor")
|
||||||
|
|
||||||
# ========== API Property Accessors ==========
|
# ========== API Property Accessors ==========
|
||||||
|
|
||||||
@ -1118,3 +1143,8 @@ class KworkClient:
|
|||||||
def notifications(self) -> NotificationsAPI:
|
def notifications(self) -> NotificationsAPI:
|
||||||
"""API уведомлений."""
|
"""API уведомлений."""
|
||||||
return self.NotificationsAPI(self)
|
return self.NotificationsAPI(self)
|
||||||
|
|
||||||
|
@property
|
||||||
|
def other(self) -> OtherAPI:
|
||||||
|
"""Прочее API."""
|
||||||
|
return self.OtherAPI(self)
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user