unicex 0.1.16__tar.gz → 0.1.18__tar.gz

{unicex-0.1.16/unicex.egg-info → unicex-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.1.16
+Version: 0.1.18
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License
@@ -34,6 +34,7 @@ License: BSD 3-Clause License
         
 Project-URL: Github, https://github.com/LoveBloodAndDiamonds/uni-cex-api
 Project-URL: Author, https://t.me/LoveBloodAndDiamonds
+Project-URL: Readthedocs, https://unicex.readthedocs.io/ru/latest/
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -71,26 +72,15 @@ Dynamic: license-file
 | Mexc     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
 | Gate     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
 
-## ❗️ Возможные проблемы:
-- Спот вебсокет на бинансе может отключиться и не переподключиться, потому что renew_listen_key не дает информации о том, когда ключ просрочен.
-
 ---
 
 ## Блок для разработчика:
 
 ### 📋 Todo
 - Добавить веса и рейт лимиты в документацию клиентов
-- Привести в порядок обработку ответа после запроса
 - Пересмотреть вопрос: должен ли быть адаптер интерфейсом?
-- Добавить генерацию ссылок в extra
-- Пересмотреть политику Literal в types
 - Прокидывать ошибку дальше: 2025-09-24 13:08:06.552 | ERROR    | unicex._base.sync.websocket:_on_error:212 - Websocket error: Message queue is overflow
-- Потестить bitget
-- AdapterError можно сделать красивее и удобнее
-- Может быть uni socket manager будет принимать тип рынка?
-- Добавить дефолтный overload для uniclient uniwebsoccketmanager
-- Добавить ссылку на доку во все вебсокет менеджер эндпоинты
-- Определить в каком порядке возвращать значения из адаптера (это касается всех методов)
+- Доделать BitgetClient
 - Проверить типы BitgetClient
 ```
 2025-09-24 13:14:03.812 | ERROR    | unicex._base.sync.websocket:_on_error:212 - Websocket error: Message queue is overflow
@@ -108,3 +98,17 @@ Dynamic: license-file
 ### 📋 Todo 24 september
 - Написать 1-2 examples
 - Написать октрытый интерес на бинанс uni
+
+
+### 📋 Todo 26 september
++ Убрали Literal's, добавили str в сигнатуры методов
++ Привести в порядок обработку ответа после запроса
++ Добавить генерацию ссылок в extra
++ Пересмотреть политику Literal в types
++ Потестить bitget
++ Может быть uni socket manager будет принимать тип рынка?
++ AdapterError можно сделать красивее и удобнее
++ Добавить дефолтный overload для uniclient uniwebsoccketmanager
++ Добавить ссылку на доку во все вебсокет менеджер эндпоинты
+- Добавить overload ко всем методам где None,None
+- Определить в каком порядке возвращать значения из адаптера (это касается всех методов)

{unicex-0.1.16 → unicex-0.1.18}/README.md

@@ -24,26 +24,15 @@
 | Mexc     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
 | Gate     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
 
-## ❗️ Возможные проблемы:
-- Спот вебсокет на бинансе может отключиться и не переподключиться, потому что renew_listen_key не дает информации о том, когда ключ просрочен.
-
 ---
 
 ## Блок для разработчика:
 
 ### 📋 Todo
 - Добавить веса и рейт лимиты в документацию клиентов
-- Привести в порядок обработку ответа после запроса
 - Пересмотреть вопрос: должен ли быть адаптер интерфейсом?
-- Добавить генерацию ссылок в extra
-- Пересмотреть политику Literal в types
 - Прокидывать ошибку дальше: 2025-09-24 13:08:06.552 | ERROR    | unicex._base.sync.websocket:_on_error:212 - Websocket error: Message queue is overflow
-- Потестить bitget
-- AdapterError можно сделать красивее и удобнее
-- Может быть uni socket manager будет принимать тип рынка?
-- Добавить дефолтный overload для uniclient uniwebsoccketmanager
-- Добавить ссылку на доку во все вебсокет менеджер эндпоинты
-- Определить в каком порядке возвращать значения из адаптера (это касается всех методов)
+- Доделать BitgetClient
 - Проверить типы BitgetClient
 ```
 2025-09-24 13:14:03.812 | ERROR    | unicex._base.sync.websocket:_on_error:212 - Websocket error: Message queue is overflow
@@ -61,3 +50,17 @@
 ### 📋 Todo 24 september
 - Написать 1-2 examples
 - Написать октрытый интерес на бинанс uni
+
+
+### 📋 Todo 26 september
++ Убрали Literal's, добавили str в сигнатуры методов
++ Привести в порядок обработку ответа после запроса
++ Добавить генерацию ссылок в extra
++ Пересмотреть политику Literal в types
++ Потестить bitget
++ Может быть uni socket manager будет принимать тип рынка?
++ AdapterError можно сделать красивее и удобнее
++ Добавить дефолтный overload для uniclient uniwebsoccketmanager
++ Добавить ссылку на доку во все вебсокет менеджер эндпоинты
+- Добавить overload ко всем методам где None,None
+- Определить в каком порядке возвращать значения из адаптера (это касается всех методов)

{unicex-0.1.16 → unicex-0.1.18}/pyproject.toml

@@ -4,7 +4,7 @@ name = "unicex"
 # •	PATCH (x.y.Z) → увеличивается при багфиксе, который не ломает совместимость.
 # •	MINOR (x.Y.z) → увеличивается при добавлении новой функциональности, но без ломающих изменений (backward-compatible).
 # •	MAJOR (X.y.z) → увеличивается при изменениях, которые ломают обратную совместимость.
-version = "0.1.16"
+version = "0.1.18"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"
@@ -25,10 +25,13 @@ dependencies = [
 [project.urls]
 Github = "https://github.com/LoveBloodAndDiamonds/uni-cex-api"
 Author = "https://t.me/LoveBloodAndDiamonds"
+Readthedocs = "https://unicex.readthedocs.io/ru/latest/"
 
 [dependency-groups]
 dev = [
     "build>=1.3.0",
     "pre-commit>=4.3.0",
+    "sphinx>=8.2.3",
+    "sphinx-rtd-theme>=3.0.2",
     "twine>=6.2.0",
 ]

{unicex-0.1.16 → unicex-0.1.18}/unicex/_abc/adapter.py

@@ -1,3 +1,5 @@
+__all__ = ["IAdapter"]
+
 from abc import ABC, abstractmethod
 from typing import Any
 

{unicex-0.1.16 → unicex-0.1.18}/unicex/_base/asyncio/websocket.py

@@ -183,7 +183,12 @@ class Websocket:
                 break
             except Exception as e:
                 self._logger.error(f"{self} Error({type(e)}) while processing message: {e}")
-            self._queue.task_done()
+
+            try:
+                self._queue.task_done()
+            except Exception as e:
+                if self._running:
+                    self._logger.error(f"{self} Error({type(e)}) while marking task done: {e}")
 
     def _generate_ws_kwargs(self) -> dict:
         """Генерирует аргументы для запуска вебсокета."""

{unicex-0.1.16 → unicex-0.1.18}/unicex/binance/_mixins/user_websocket.py

@@ -2,8 +2,7 @@ __all__ = ["UserWebsocketMixin"]
 
 
 from unicex.exceptions import NotSupported
-
-from ..types import AccountType
+from unicex.types import AccountType
 
 
 class UserWebsocketMixin:

{unicex-0.1.16 → unicex-0.1.18}/unicex/binance/adapter.py

@@ -2,14 +2,15 @@ __all__ = ["Adapter"]
 
 
 from unicex._abc import IAdapter
-from unicex.exceptions import AdapterError
 from unicex.types import AggTradeDict, KlineDict, TickerDailyDict, TradeDict
+from unicex.utils import catch_adapter_errors
 
 
 class Adapter(IAdapter):
     """Адаптер для унификации данных с Binance API."""
 
     @staticmethod
+    @catch_adapter_errors
     def tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
 
@@ -20,18 +21,12 @@ class Adapter(IAdapter):
         Возвращает:
             list[str]: Список тикеров.
         """
-        try:
-            return [
-                item["symbol"]
-                for item in raw_data
-                if not only_usdt or item["symbol"].endswith("USDT")
-            ]
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_data} to unified tickers."
-            ) from e
+        return [
+            item["symbol"] for item in raw_data if not only_usdt or item["symbol"].endswith("USDT")
+        ]
 
     @staticmethod
+    @catch_adapter_errors
     def futures_tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
 
@@ -45,6 +40,7 @@ class Adapter(IAdapter):
         return Adapter.tickers(raw_data, only_usdt)
 
     @staticmethod
+    @catch_adapter_errors
     def ticker_24h(raw_data: list[dict]) -> dict[str, TickerDailyDict]:
         """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
 
@@ -54,21 +50,17 @@ class Adapter(IAdapter):
         Возвращает:
             dict[str, TickerDailyDict]: Словарь, где ключ - тикер, а значение - статистика за последние 24 часа.
         """
-        try:
-            return {
-                item["symbol"]: TickerDailyDict(
-                    p=float(item["priceChangePercent"]),
-                    q=float(item["quoteVolume"]),  # объём в долларах
-                    v=float(item["volume"]),  # объём в монетах
-                )
-                for item in raw_data
-            }
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_data} to unified ticker 24h."
-            ) from e
+        return {
+            item["symbol"]: TickerDailyDict(
+                p=float(item["priceChangePercent"]),
+                q=float(item["quoteVolume"]),  # объём в долларах
+                v=float(item["volume"]),  # объём в монетах
+            )
+            for item in raw_data
+        }
 
     @staticmethod
+    @catch_adapter_errors
     def futures_ticker_24h(raw_data: list[dict]) -> dict[str, TickerDailyDict]:
         """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
 
@@ -81,6 +73,7 @@ class Adapter(IAdapter):
         return Adapter.ticker_24h(raw_data)
 
     @staticmethod
+    @catch_adapter_errors
     def last_price(raw_data: list[dict]) -> dict[str, float]:
         """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
 
@@ -90,14 +83,10 @@ class Adapter(IAdapter):
         Возвращает:
             dict[str, float]: Словарь, где ключ - тикер, а значение - последняя цена.
         """
-        try:
-            return {item["symbol"]: float(item["price"]) for item in raw_data}
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_data} to unified last price."
-            ) from e
+        return {item["symbol"]: float(item["price"]) for item in raw_data}
 
     @staticmethod
+    @catch_adapter_errors
     def futures_last_price(raw_data: list[dict]) -> dict[str, float]:
         """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
 
@@ -110,6 +99,7 @@ class Adapter(IAdapter):
         return Adapter.last_price(raw_data)
 
     @staticmethod
+    @catch_adapter_errors
     def klines(raw_data: list[list]) -> list[KlineDict]:
         """Преобразует сырой ответ, в котором содержатся данные о котировках тикеров в унифицированный формат.
 
@@ -119,28 +109,24 @@ class Adapter(IAdapter):
         Возвращает:
             list[KlineDict]: Список словарей, где каждый словарь содержит данные о свече.
         """
-        try:
-            return [
-                KlineDict(
-                    s="",
-                    t=item[0],
-                    o=float(item[1]),
-                    h=float(item[2]),
-                    l=float(item[3]),
-                    c=float(item[4]),
-                    v=float(item[5]),
-                    q=float(item[7]),
-                    T=item[6],
-                    x=None,
-                )
-                for item in raw_data
-            ]
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_data} to unified kline."
-            ) from e
+        return [
+            KlineDict(
+                s="",
+                t=item[0],
+                o=float(item[1]),
+                h=float(item[2]),
+                l=float(item[3]),
+                c=float(item[4]),
+                v=float(item[5]),
+                q=float(item[7]),
+                T=item[6],
+                x=None,
+            )
+            for item in raw_data
+        ]
 
     @staticmethod
+    @catch_adapter_errors
     def futures_klines(raw_data: list[list]) -> list[KlineDict]:
         """Преобразует сырой ответ, в котором содержатся данные о котировках тикеров в унифицированный формат.
 
@@ -153,6 +139,7 @@ class Adapter(IAdapter):
         return Adapter.klines(raw_data)
 
     @staticmethod
+    @catch_adapter_errors
     def funding_rate(raw_data: list[dict]) -> dict[str, float]:
         """Преобразует сырой ответ, в котором содержатся данные о ставках финансирования тикеров в унифицированный формат.
 
@@ -162,14 +149,10 @@ class Adapter(IAdapter):
         Возвращает:
             dict[str, float]: Словарь, где ключ - тикер, а значение - ставка финансирования.
         """
-        try:
-            return {item["symbol"]: float(item["lastFundingRate"]) * 100 for item in raw_data}
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_data} to unified funding rate."
-            ) from e
+        return {item["symbol"]: float(item["lastFundingRate"]) * 100 for item in raw_data}
 
     @staticmethod
+    @catch_adapter_errors
     def klines_message(raw_msg: dict) -> list[KlineDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         свече/свечах в унифицированный вид.
@@ -180,29 +163,25 @@ class Adapter(IAdapter):
         Возвращает:
             list[KlineDict]: Список словарей, где каждый словарь содержит данные о свече.
         """
-        try:
-            # Обрабатываем обертку в случае с multiplex stream
-            kline = raw_msg.get("data", raw_msg)["k"]
-            return [
-                KlineDict(
-                    s=kline["s"],
-                    t=kline["t"],
-                    o=float(kline["o"]),
-                    h=float(kline["h"]),
-                    l=float(kline["l"]),
-                    c=float(kline["c"]),
-                    v=float(kline["v"]),  # Используем quote volume (в USDT)
-                    q=float(kline["q"]),  # Используем quote volume (в USDT)
-                    T=kline["T"],
-                    x=kline["x"],
-                )
-            ]
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_msg} to unified kline."
-            ) from e
+        # Обрабатываем обертку в случае с multiplex stream
+        kline = raw_msg.get("data", raw_msg)["k"]
+        return [
+            KlineDict(
+                s=kline["s"],
+                t=kline["t"],
+                o=float(kline["o"]),
+                h=float(kline["h"]),
+                l=float(kline["l"]),
+                c=float(kline["c"]),
+                v=float(kline["v"]),  # Используем quote volume (в USDT)
+                q=float(kline["q"]),  # Используем quote volume (в USDT)
+                T=kline["T"],
+                x=kline["x"],
+            )
+        ]
 
     @staticmethod
+    @catch_adapter_errors
     def futures_klines_message(raw_msg: dict) -> list[KlineDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         свече/свечах в унифицированный вид.
@@ -216,6 +195,7 @@ class Adapter(IAdapter):
         return Adapter.klines_message(raw_msg)
 
     @staticmethod
+    @catch_adapter_errors
     def aggtrades_message(raw_msg: dict) -> list[AggTradeDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         аггрегированных сделке/сделках в унифицированный вид.
@@ -226,23 +206,19 @@ class Adapter(IAdapter):
         Возвращает:
             list[KlineDict]: Список словарей, где каждый словарь содержит данные о сделке.
         """
-        try:
-            msg = raw_msg.get("data", raw_msg)
-            return [
-                AggTradeDict(
-                    t=int(msg["T"]),
-                    s=str(msg["s"]),
-                    S="SELL" if bool(msg["m"]) else "BUY",
-                    p=float(msg["p"]),
-                    v=float(msg["q"]),
-                )
-            ]
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_msg} to unified aggtrade."
-            ) from e
+        msg = raw_msg.get("data", raw_msg)
+        return [
+            AggTradeDict(
+                t=int(msg["T"]),
+                s=str(msg["s"]),
+                S="SELL" if bool(msg["m"]) else "BUY",
+                p=float(msg["p"]),
+                v=float(msg["q"]),
+            )
+        ]
 
     @staticmethod
+    @catch_adapter_errors
     def futures_aggtrades_message(raw_msg: dict) -> list[AggTradeDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         аггрегированных сделке/сделках в унифицированный вид.
@@ -256,6 +232,7 @@ class Adapter(IAdapter):
         return Adapter.aggtrades_message(raw_msg)
 
     @staticmethod
+    @catch_adapter_errors
     def trades_message(raw_msg: dict) -> list[TradeDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         сделке/сделках в унифицированный вид.
@@ -266,23 +243,19 @@ class Adapter(IAdapter):
         Возвращает:
             list[KlineDict]: Список словарей, где каждый словарь содержит данные о сделке.
         """
-        try:
-            msg = raw_msg.get("data", raw_msg)
-            return [
-                TradeDict(
-                    t=int(msg["T"]),
-                    s=str(msg["s"]),
-                    S="SELL" if bool(msg["m"]) else "BUY",
-                    p=float(msg["p"]),
-                    v=float(msg["q"]),
-                )
-            ]
-        except Exception as e:
-            raise AdapterError(
-                f"({type(e)}): {e}. Can not convert {raw_msg} to unified trade."
-            ) from e
+        msg = raw_msg.get("data", raw_msg)
+        return [
+            TradeDict(
+                t=int(msg["T"]),
+                s=str(msg["s"]),
+                S="SELL" if bool(msg["m"]) else "BUY",
+                p=float(msg["p"]),
+                v=float(msg["q"]),
+            )
+        ]
 
     @staticmethod
+    @catch_adapter_errors
     def futures_trades_message(raw_msg: dict) -> list[TradeDict]:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         сделке/сделках в унифицированный вид.
@@ -296,6 +269,7 @@ class Adapter(IAdapter):
         return Adapter.trades_message(raw_msg)
 
     @staticmethod
+    @catch_adapter_errors
     def open_interest(raw_data: dict) -> float:
         """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
         объеме открытых позиций в унифицированный вид.
@@ -306,9 +280,4 @@ class Adapter(IAdapter):
         Возвращает:
             float: Объем открытых позиций в монетах.
         """
-        try:
-            return float(raw_data["openInterest"])
-        except Exception as e:
-            raise AdapterError(
-                f"{type(e)}: {e}. Can not convert {raw_data} to unified open interest."
-            ) from e
+        return float(raw_data["openInterest"])