cloudtips 0.1.1__tar.gz → 0.3.0__tar.gz

{cloudtips-0.1.1 → cloudtips-0.3.0}/PKG-INFO

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

{cloudtips-0.1.1 → cloudtips-0.3.0}/cloudtips/__init__.py

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

{cloudtips-0.1.1 → cloudtips-0.3.0}/cloudtips/client.py

@@ -8,7 +8,7 @@ from typing import Callable, Iterator, List, Optional
 import requests
 
 from .auth import CloudTipsAuth
-from .models import Donation
+from .models import Donation, Card, PayoutFeeInfo, AccumulationSummary, ReceiverProfile
 
 _BASE_URL = "https://api.cloudtips.ru/api"
 _MSK = timezone(timedelta(hours=3))
@@ -38,12 +38,9 @@ class CloudTipsClient:
         )
         client = CloudTipsClient(auth)
 
-        # Получить донаты за последние 30 дней
-        donations = client.get_all_donations(since=datetime.now() - timedelta(days=30))
-
-        # Поллинг новых донатов каждые 30 секунд
-        for donation in client.poll(interval=30):
-            print(donation)
+        donations = client.get_all_donations()
+        cards = client.get_cards()
+        summary = client.get_accumulation_summary()
     """
 
     def __init__(self, auth: CloudTipsAuth, base_url: str = _BASE_URL) -> None:
@@ -52,7 +49,7 @@ class CloudTipsClient:
         self._session = requests.Session()
 
     # ------------------------------------------------------------------
-    # Основные методы
+    # Донаты
     # ------------------------------------------------------------------
 
     def get_donations(
@@ -130,9 +127,6 @@ class CloudTipsClient:
         """
         Генератор: бесконечный поллинг новых донатов.
 
-        Каждые ``interval`` секунд опрашивает API и отдаёт только **новые**
-        донаты (те, что появились после последнего запроса).
-
         Использование как генератора::
 
             for donation in client.poll(interval=15):
@@ -149,7 +143,6 @@ class CloudTipsClient:
         last_seen_ids: set = set()
         cursor = _ensure_tz(since or datetime.now(_MSK))
 
-        # Первый запрос — запоминаем уже существующие, не отдаём как «новые»
         for d in self.get_all_donations(since=cursor):
             last_seen_ids.add(d.transaction_id)
 
@@ -159,7 +152,6 @@ class CloudTipsClient:
             try:
                 fresh = self.get_all_donations(since=cursor)
             except Exception as exc:
-                # Не падаем при временных ошибках, пробуем снова
                 print(f"[cloudtips] Ошибка при поллинге: {exc}")
                 continue
 
@@ -173,7 +165,117 @@ class CloudTipsClient:
                         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", {}))
+
+    # ------------------------------------------------------------------
+    # Карты
+    # ------------------------------------------------------------------
+
+    def get_cards(self) -> List[Card]:
+        """
+        Получить список привязанных карт.
+
+        :return: список :class:`Card`
+
+        Пример::
+
+            for card in client.get_cards():
+                print(card)         # MIR *3742 (T-BANK (TINKOFF), до 08/34) [по умолчанию]
+                print(card.token)   # tk_89e6b3c6827afd4e9ccc36db2d22f
+        """
+        data = self._get("/cards")
+        return [Card.from_dict(item) for item in data.get("data", [])]
+
+    def delete_card(self, card_token: str) -> bool:
+        """
+        Удалить привязанную карту.
+
+        :param card_token: токен карты (``card.token``)
+        :return: ``True`` если удаление прошло успешно
+
+        Пример::
+
+            for card in client.get_cards():
+                client.delete_card(card.token)
+        """
+        data = self._delete("/cards", json={"cardToken": card_token})
+        return data.get("succeed", False)
+
+    # ------------------------------------------------------------------
+    # Выплаты и баланс
+    # ------------------------------------------------------------------
+
+    def get_payout_fee_info(self) -> PayoutFeeInfo:
+        """
+        Получить информацию о комиссиях при выводе средств.
+
+        :return: :class:`PayoutFeeInfo`
+
+        Пример::
+
+            fee = client.get_payout_fee_info()
+            print(fee.text)
+            # Стоимость вывода денег на карты Т-Банка — 5%
+            # Стоимость вывода денег на карты других банков — 7%*
+        """
+        data = self._get("/payout/fee/info")
+        return PayoutFeeInfo.from_dict(data.get("data", {}))
+
+    def get_accumulation_summary(self) -> AccumulationSummary:
+        """
+        Получить сводку по накопленным средствам (баланс к выводу).
+
+        :return: :class:`AccumulationSummary`
+
+        Пример::
+
+            s = client.get_accumulation_summary()
+            print(f"Накоплено: {s.accumulated_amount}₽")
+            print(f"Комиссия: {s.commission_percent}%")
+            print(f"Следующая выплата: {s.next_payout_date or 'не запланирована'}")
+        """
+        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`` если успешно
+        """
+        data = self._post("/receivers/payout-method", json={"payoutMethod": method})
+        return data.get("succeed", False)
+
+    # ------------------------------------------------------------------
+    # Внутренние HTTP-методы
     # ------------------------------------------------------------------
 
     def _get(self, path: str, params: Optional[dict] = None) -> dict:
@@ -187,6 +289,28 @@ class CloudTipsClient:
         _raise_for_status(response)
         return response.json()
 
+    def _post(self, path: str, json: Optional[dict] = None) -> dict:
+        headers = {**HEADERS_BASE, **self._auth.headers()}
+        response = self._session.post(
+            self._base_url + path,
+            headers=headers,
+            json=json,
+            timeout=15,
+        )
+        _raise_for_status(response)
+        return response.json()
+
+    def _delete(self, path: str, json: Optional[dict] = None) -> dict:
+        headers = {**HEADERS_BASE, **self._auth.headers()}
+        response = self._session.delete(
+            self._base_url + path,
+            headers=headers,
+            json=json,
+            timeout=15,
+        )
+        _raise_for_status(response)
+        return response.json()
+
 
 class CloudTipsAPIError(Exception):
     """Ошибка запроса к CloudTips API."""

cloudtips-0.3.0/cloudtips/models.py

@@ -0,0 +1,161 @@
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Optional
+
+
+@dataclass
+class Donation:
+    transaction_id: int
+    name: str
+    amount: int          # рубли
+    tg_id: int
+    comment: str
+    date: datetime
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Donation":
+        raw_date = data["date"]
+        try:
+            dt = datetime.fromisoformat(raw_date)
+        except ValueError:
+            dt = datetime.fromisoformat(raw_date[:19])
+
+        return cls(
+            transaction_id=data["transaction_id"],
+            name=data.get("name", ""),
+            amount=data["amount"],
+            tg_id=data.get("tg_id", 0),
+            comment=data.get("comment", ""),
+            date=dt,
+        )
+
+    def __str__(self) -> str:
+        comment_part = f' — "{self.comment}"' if self.comment else ""
+        return (
+            f"[{self.date.strftime('%Y-%m-%d %H:%M')}] "
+            f"{self.name} → {self.amount}₽{comment_part}"
+        )
+
+
+@dataclass
+class Card:
+    token: str              # токен для удаления и операций
+    first_six: str          # первые 6 цифр (BIN)
+    last_four: str          # последние 4 цифры
+    card_type: str          # MIR / VISA / MASTERCARD
+    expiration_date: str    # MM/YY
+    issuer_code: str        # название банка
+    is_default: bool        # карта по умолчанию для выплат
+    commission_hint: str    # текст подсказки о комиссии
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Card":
+        return cls(
+            token=data["token"],
+            first_six=data.get("firstSix", ""),
+            last_four=data.get("lastFour", ""),
+            card_type=data.get("cardType", ""),
+            expiration_date=data.get("cardExpirationDate", ""),
+            issuer_code=data.get("issuerCode", ""),
+            is_default=data.get("isDefault", False),
+            commission_hint=data.get("commissionHint", ""),
+        )
+
+    def __str__(self) -> str:
+        default = " [по умолчанию]" if self.is_default else ""
+        return (
+            f"{self.card_type} *{self.last_four} "
+            f"({self.issuer_code}, до {self.expiration_date}){default}"
+        )
+
+
+@dataclass
+class PayoutFeeInfo:
+    text: str                        # текст с описанием комиссий
+    downgrade_condition: str
+    tinkoff_commission_hint: str
+    instant_payout_commission_text: str
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "PayoutFeeInfo":
+        return cls(
+            text=data.get("text", ""),
+            downgrade_condition=data.get("downGradeCondition", ""),
+            tinkoff_commission_hint=data.get("tinkoffCommissionHint", ""),
+            instant_payout_commission_text=data.get("instantPayoutCommissionText", ""),
+        )
+
+
+@dataclass
+class AccumulationSummary:
+    accumulated_amount: float    # накоплено (ещё не выведено)
+    amount_to_deposit: float     # к зачислению
+    commission: float            # сумма комиссии
+    commission_percent: float    # процент комиссии
+    next_payout_date: Optional[str]  # дата следующей выплаты (None если не запланирована)
+    commission_hint: str         # текст подсказки
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "AccumulationSummary":
+        return cls(
+            accumulated_amount=data.get("accumulatedAmount", 0.0),
+            amount_to_deposit=data.get("amountToDeposit", 0.0),
+            commission=data.get("commission", 0.0),
+            commission_percent=data.get("commissionPercent", 0.0),
+            next_payout_date=data.get("nextPayoutDate"),
+            commission_hint=data.get("commissionHint", ""),
+        )
+
+
+@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}₽"
+        )
+
+
+    """Новые токены, которые библиотека передаёт в on_token_refresh."""
+    access_token: str
+    refresh_token: str
+    expires_at: float   # unix timestamp

{cloudtips-0.1.1 → cloudtips-0.3.0}/pyproject.toml

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

cloudtips-0.1.1/cloudtips/models.py

@@ -1,48 +0,0 @@
-from dataclasses import dataclass, field
-from datetime import datetime
-from typing import Optional
-
-
-@dataclass
-class Donation:
-    transaction_id: int
-    name: str
-    amount: int          # рубли
-    tg_id: int
-    comment: str
-    date: datetime
-
-    @classmethod
-    def from_dict(cls, data: dict) -> "Donation":
-        raw_date = data["date"]
-        # Убираем offset вида +03:00 → datetime aware через fromisoformat (3.11+)
-        # или ручной парсинг для 3.9/3.10
-        try:
-            dt = datetime.fromisoformat(raw_date)
-        except ValueError:
-            # fallback: обрезаем offset
-            dt = datetime.fromisoformat(raw_date[:19])
-
-        return cls(
-            transaction_id=data["transaction_id"],
-            name=data.get("name", ""),
-            amount=data["amount"],
-            tg_id=data.get("tg_id", 0),
-            comment=data.get("comment", ""),
-            date=dt,
-        )
-
-    def __str__(self) -> str:
-        comment_part = f' — "{self.comment}"' if self.comment else ""
-        return (
-            f"[{self.date.strftime('%Y-%m-%d %H:%M')}] "
-            f"{self.name} → {self.amount}₽{comment_part}"
-        )
-
-
-@dataclass
-class TokenData:
-    """Новые токены, которые библиотека передаёт в on_token_refresh."""
-    access_token: str
-    refresh_token: str
-    expires_at: float   # unix timestamp