cloudtips 0.2.0__tar.gz → 0.3.1__tar.gz

{cloudtips-0.2.0 → cloudtips-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudtips
-Version: 0.2.0
+Version: 0.3.1
 Summary: Неофициальная Python-библиотека для CloudTips (получение донатов, поллинг, обновление токенов)
 Project-URL: Repository, https://github.com/IRRatium/cloudtips-api
 Project-URL: Issues, https://github.com/IRRatium/cloudtips-api/issues

{cloudtips-0.2.0 → cloudtips-0.3.1}/cloudtips/__init__.py

@@ -4,9 +4,9 @@ cloudtips — неофициальная Python-библиотека для Clou
 
 from .auth import CloudTipsAuth, CloudTipsAuthError
 from .client import CloudTipsAPIError, CloudTipsClient
-from .models import AccumulationSummary, Card, Donation, PayoutFeeInfo, TokenData
+from .models import AccumulationSummary, Card, Donation, PayoutFeeInfo, ReceiverProfile, TokenData
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"
 __all__ = [
     "CloudTipsAuth",
     "CloudTipsAuthError",
@@ -16,5 +16,6 @@ __all__ = [
     "Card",
     "PayoutFeeInfo",
     "AccumulationSummary",
+    "ReceiverProfile",
     "TokenData",
 ]

{cloudtips-0.2.0 → cloudtips-0.3.1}/cloudtips/client.py

@@ -8,7 +8,7 @@ from typing import Callable, Iterator, List, Optional
 import requests
 
 from .auth import CloudTipsAuth
-from .models import Donation, Card, PayoutFeeInfo, AccumulationSummary
+from .models import Donation, Card, PayoutFeeInfo, AccumulationSummary, ReceiverProfile
 
 _BASE_URL = "https://api.cloudtips.ru/api"
 _MSK = timezone(timedelta(hours=3))
@@ -164,6 +164,28 @@ class CloudTipsClient:
                     else:
                         yield donation
 
+    # ------------------------------------------------------------------
+    # Профиль
+    # ------------------------------------------------------------------
+
+    def get_me(self) -> ReceiverProfile:
+        """
+        Получить профиль текущего пользователя.
+
+        Содержит имя, телефон, метод выплат, лимиты сумм и другие данные.
+
+        :return: :class:`ReceiverProfile`
+
+        Пример::
+
+            me = client.get_me()
+            print(me.full_name)       # IRRing
+            print(me.payout_method)   # Accumulation
+            print(me.available_amount_min, me.available_amount_max)  # 49.0 3000.0
+        """
+        data = self._get("/receivers/me")
+        return ReceiverProfile.from_dict(data.get("data", {}))
+
     # ------------------------------------------------------------------
     # Карты
     # ------------------------------------------------------------------
@@ -234,18 +256,22 @@ class CloudTipsClient:
         data = self._get("/accumulations/summary")
         return AccumulationSummary.from_dict(data.get("data", {}))
 
+    def get_payout_method(self) -> str:
+        """
+        Получить текущий метод выплат.
+
+        :return: ``"Instant"`` или ``"Accumulation"``
+        """
+        return self.get_me().payout_method
+
     def set_payout_method(self, method: str = "Instant") -> bool:
         """
         Установить метод выплат.
 
         :param method: ``"Instant"`` (мгновенно) или ``"Accumulation"`` (накопительно)
         :return: ``True`` если успешно
-
-        Пример::
-
-            client.set_payout_method("Instant")
         """
-        data = self._put("/receivers/payout-method", json={"payoutMethod": method})
+        data = self._post("/receivers/payout-method", json={"payoutMethod": method})
         return data.get("succeed", False)
 
     # ------------------------------------------------------------------
@@ -263,9 +289,9 @@ class CloudTipsClient:
         _raise_for_status(response)
         return response.json()
 
-    def _delete(self, path: str, json: Optional[dict] = None) -> dict:
+    def _post(self, path: str, json: Optional[dict] = None) -> dict:
         headers = {**HEADERS_BASE, **self._auth.headers()}
-        response = self._session.delete(
+        response = self._session.post(
             self._base_url + path,
             headers=headers,
             json=json,
@@ -274,9 +300,9 @@ class CloudTipsClient:
         _raise_for_status(response)
         return response.json()
 
-    def _put(self, path: str, json: Optional[dict] = None) -> dict:
+    def _delete(self, path: str, json: Optional[dict] = None) -> dict:
         headers = {**HEADERS_BASE, **self._auth.headers()}
-        response = self._session.put(
+        response = self._session.delete(
             self._base_url + path,
             headers=headers,
             json=json,

{cloudtips-0.2.0 → cloudtips-0.3.1}/cloudtips/models.py

@@ -107,6 +107,54 @@ class AccumulationSummary:
         )
 
 
+@dataclass
+class ReceiverProfile:
+    user_id: str
+    full_name: str
+    phone_number: str
+    photo_url: str
+    payout_method: str          # "Instant" или "Accumulation"
+    instant_payout_enabled: bool
+    is_premium: bool
+    onboarding_passed: bool
+    gender: str
+    work_place: Optional[str]
+    work_position: Optional[str]
+    birthday: Optional[str]
+    created_date: str
+    available_amount_min: float
+    available_amount_max: float
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "ReceiverProfile":
+        available = data.get("availableAmount") or {}
+        return cls(
+            user_id=data.get("userId", ""),
+            full_name=data.get("fullName", ""),
+            phone_number=data.get("phoneNumber", ""),
+            photo_url=data.get("photoUrl", ""),
+            payout_method=data.get("payoutMethod", "Instant"),
+            instant_payout_enabled=data.get("instantPayoutEnabled", False),
+            is_premium=data.get("isPremium", False),
+            onboarding_passed=data.get("onboardingPassed", False),
+            gender=data.get("gender", "NotSpecified"),
+            work_place=data.get("workPlace"),
+            work_position=data.get("workPosition"),
+            birthday=data.get("birthday"),
+            created_date=data.get("createdDate", ""),
+            available_amount_min=available.get("minimal", 0.0),
+            available_amount_max=available.get("maximal", 0.0),
+        )
+
+    def __str__(self) -> str:
+        return (
+            f"{self.full_name} ({self.phone_number})\n"
+            f"Метод выплат: {self.payout_method} | "
+            f"Премиум: {'да' if self.is_premium else 'нет'} | "
+            f"Лимиты: {self.available_amount_min}₽ — {self.available_amount_max}₽"
+        )
+
+
 @dataclass
 class TokenData:
     """Новые токены, которые библиотека передаёт в on_token_refresh."""

{cloudtips-0.2.0 → cloudtips-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cloudtips"
-version = "0.2.0"
+version = "0.3.1"
 description = "Неофициальная Python-библиотека для CloudTips (получение донатов, поллинг, обновление токенов)"
 readme = "README.md"
 license = { text = "MIT" }