unicex 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

unicex/__init__.py

@@ -1,4 +1,4 @@
-"""`unicex` - библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс для работы с различными криптовалютными биржами."""
+"""unicex - библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс для работы с различными криптовалютными биржами."""
 
 __all__ = [
     # Mappers
@@ -19,7 +19,6 @@ __all__ = [
     # Interfaces
     "IUniClient",
     "IUniWebsocketManager",
-    "IAdapter",
     # Base clients and websockets
     "Websocket",
     "BaseClient",
@@ -28,23 +27,229 @@ __all__ = [
     "BinanceUniClient",
     "BinanceWebsocketManager",
     "BinanceUniWebsocketManager",
+    "BinanceUserWebsocket",
     # Bitget
     "BitgetClient",
     "BitgetUniClient",
     "BitgetUniWebsocketManager",
     "BitgetWebsocketManager",
+    "BitgetUserWebsocket",
+    # Bitrue
+    "BitrueClient",
+    "BitrueUniClient",
+    "BitrueUniWebsocketManager",
+    "BitrueWebsocketManager",
+    "BitrueUserWebsocket",
+    # Mexc
+    "MexcClient",
+    "MexcUniClient",
+    "MexcUniWebsocketManager",
+    "MexcWebsocketManager",
+    "MexcUserWebsocket",
+    # Bybit
+    "BybitClient",
+    "BybitUniClient",
+    "BybitUniWebsocketManager",
+    "BybitWebsocketManager",
+    "BybitUserWebsocket",
+    # Okx
+    "OkxClient",
+    "OkxUniClient",
+    "OkxUniWebsocketManager",
+    "OkxWebsocketManager",
+    "OkxUserWebsocket",
+    # Hyperliquid
+    "HyperliquidClient",
+    "HyperliquidUniClient",
+    "HyperliquidUniWebsocketManager",
+    "HyperliquidWebsocketManager",
+    "HyperliquidUserWebsocket",
+    # Gateio
+    "GateioClient",
+    "GateioUniClient",
+    "GateioUniWebsocketManager",
+    "GateioWebsocketManager",
+    "GateioUserWebsocket",
+    # Bitunix
+    "BitunixClient",
+    "BitunixUniClient",
+    "BitunixUniWebsocketManager",
+    "BitunixWebsocketManager",
+    "BitunixUserWebsocket",
+    # Btse
+    "BtseClient",
+    "BtseUniClient",
+    "BtseUniWebsocketManager",
+    "BtseWebsocketManager",
+    "BtseUserWebsocket",
+    # Kcex
+    "KcexClient",
+    "KcexUniClient",
+    "KcexUniWebsocketManager",
+    "KcexWebsocketManager",
+    "KcexUserWebsocket",
+    # Kraken
+    "KrakenClient",
+    "KrakenUniClient",
+    "KrakenUniWebsocketManager",
+    "KrakenWebsocketManager",
+    "KrakenUserWebsocket",
+    # Kucoin
+    "KucoinClient",
+    "KucoinUniClient",
+    "KucoinUniWebsocketManager",
+    "KucoinWebsocketManager",
+    "KucoinUserWebsocket",
+    # Weex
+    "WeexClient",
+    "WeexUniClient",
+    "WeexUniWebsocketManager",
+    "WeexWebsocketManager",
+    "WeexUserWebsocket",
+    # Xt
+    "XtClient",
+    "XtUniClient",
+    "XtUniWebsocketManager",
+    "XtWebsocketManager",
+    "XtUserWebsocket",
 ]
 
-from ._abc import IAdapter, IUniClient, IUniWebsocketManager
+# ruff: noqa
+
+# abstract & base
+from ._abc import IUniClient, IUniWebsocketManager
 from ._base import BaseClient, Websocket
-from .binance import Client as BinanceClient
-from .binance import UniClient as BinanceUniClient
-from .binance import UniWebsocketManager as BinanceUniWebsocketManager
-from .binance import WebsocketManager as BinanceWebsocketManager
-from .bitget import Client as BitgetClient
-from .bitget import UniClient as BitgetUniClient
-from .bitget import UniWebsocketManager as BitgetUniWebsocketManager
-from .bitget import WebsocketManager as BitgetWebsocketManager
+
+# enums, mappers, types
 from .enums import Exchange, MarketType, Side, Timeframe
 from .mapper import get_uni_client, get_uni_websocket_manager
-from .types import AggTradeDict, KlineDict, LoggerLike, RequestMethod, TickerDailyDict, TradeDict
+from .types import (
+    AggTradeDict,
+    KlineDict,
+    LoggerLike,
+    RequestMethod,
+    TickerDailyDict,
+    TradeDict,
+)
+
+# exchanges
+
+from .binance import (
+    Client as BinanceClient,
+    UniClient as BinanceUniClient,
+    UniWebsocketManager as BinanceUniWebsocketManager,
+    UserWebsocket as BinanceUserWebsocket,
+    WebsocketManager as BinanceWebsocketManager,
+)
+
+from .bitget import (
+    Client as BitgetClient,
+    UniClient as BitgetUniClient,
+    UniWebsocketManager as BitgetUniWebsocketManager,
+    UserWebsocket as BitgetUserWebsocket,
+    WebsocketManager as BitgetWebsocketManager,
+)
+
+from .bitrue import (
+    Client as BitrueClient,
+    UniClient as BitrueUniClient,
+    UniWebsocketManager as BitrueUniWebsocketManager,
+    UserWebsocket as BitrueUserWebsocket,
+    WebsocketManager as BitrueWebsocketManager,
+)
+
+from .bitunix import (
+    Client as BitunixClient,
+    UniClient as BitunixUniClient,
+    UniWebsocketManager as BitunixUniWebsocketManager,
+    UserWebsocket as BitunixUserWebsocket,
+    WebsocketManager as BitunixWebsocketManager,
+)
+
+from .btse import (
+    Client as BtseClient,
+    UniClient as BtseUniClient,
+    UniWebsocketManager as BtseUniWebsocketManager,
+    UserWebsocket as BtseUserWebsocket,
+    WebsocketManager as BtseWebsocketManager,
+)
+
+from .bybit import (
+    Client as BybitClient,
+    UniClient as BybitUniClient,
+    UniWebsocketManager as BybitUniWebsocketManager,
+    UserWebsocket as BybitUserWebsocket,
+    WebsocketManager as BybitWebsocketManager,
+)
+
+from .gateio import (
+    Client as GateioClient,
+    UniClient as GateioUniClient,
+    UniWebsocketManager as GateioUniWebsocketManager,
+    UserWebsocket as GateioUserWebsocket,
+    WebsocketManager as GateioWebsocketManager,
+)
+
+from .hyperliquid import (
+    Client as HyperliquidClient,
+    UniClient as HyperliquidUniClient,
+    UniWebsocketManager as HyperliquidUniWebsocketManager,
+    UserWebsocket as HyperliquidUserWebsocket,
+    WebsocketManager as HyperliquidWebsocketManager,
+)
+
+from .kcex import (
+    Client as KcexClient,
+    UniClient as KcexUniClient,
+    UniWebsocketManager as KcexUniWebsocketManager,
+    UserWebsocket as KcexUserWebsocket,
+    WebsocketManager as KcexWebsocketManager,
+)
+
+from .kraken import (
+    Client as KrakenClient,
+    UniClient as KrakenUniClient,
+    UniWebsocketManager as KrakenUniWebsocketManager,
+    UserWebsocket as KrakenUserWebsocket,
+    WebsocketManager as KrakenWebsocketManager,
+)
+
+from .kucoin import (
+    Client as KucoinClient,
+    UniClient as KucoinUniClient,
+    UniWebsocketManager as KucoinUniWebsocketManager,
+    UserWebsocket as KucoinUserWebsocket,
+    WebsocketManager as KucoinWebsocketManager,
+)
+
+from .mexc import (
+    Client as MexcClient,
+    UniClient as MexcUniClient,
+    UniWebsocketManager as MexcUniWebsocketManager,
+    UserWebsocket as MexcUserWebsocket,
+    WebsocketManager as MexcWebsocketManager,
+)
+
+from .okx import (
+    Client as OkxClient,
+    UniClient as OkxUniClient,
+    UniWebsocketManager as OkxUniWebsocketManager,
+    UserWebsocket as OkxUserWebsocket,
+    WebsocketManager as OkxWebsocketManager,
+)
+
+from .weex import (
+    Client as WeexClient,
+    UniClient as WeexUniClient,
+    UniWebsocketManager as WeexUniWebsocketManager,
+    UserWebsocket as WeexUserWebsocket,
+    WebsocketManager as WeexWebsocketManager,
+)
+
+from .xt import (
+    Client as XtClient,
+    UniClient as XtUniClient,
+    UniWebsocketManager as XtUniWebsocketManager,
+    UserWebsocket as XtUserWebsocket,
+    WebsocketManager as XtWebsocketManager,
+)

unicex/_abc/__init__.py

@@ -1,9 +1,7 @@
 __all__ = [
     "IUniClient",
-    "IAdapter",
     "IUniWebsocketManager",
 ]
 
-from .adapter import IAdapter
 from .uni_client import IUniClient
 from .uni_websocket_manager import IUniWebsocketManager

unicex/_abc/uni_client.py

@@ -1,18 +1,15 @@
 __all__ = ["IUniClient"]
 
 from abc import ABC, abstractmethod
-from functools import cached_property
 from typing import Generic, Self, TypeVar, overload
 
 import aiohttp
 
 from unicex._base import BaseClient
 from unicex.enums import Timeframe
-from unicex.types import KlineDict, LoggerLike, TickerDailyDict
+from unicex.types import KlineDict, LoggerLike, OpenInterestDict, OpenInterestItem, TickerDailyDict
 from unicex.utils import batched_list
 
-from .adapter import IAdapter
-
 TClient = TypeVar("TClient", bound="BaseClient")
 
 
@@ -149,17 +146,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `type[TClient]`: Класс клиента.
         """
-        pass
-
-    @cached_property
-    @abstractmethod
-    def adapter(self) -> IAdapter:
-        """Возвращает реализацию адаптера под конкретную биржу.
-
-        Возвращает:
-            `IAdapter`: Реализация адаптера.
-        """
-        pass
+        ...
 
     @abstractmethod
     async def tickers(self, only_usdt: bool = True) -> list[str]:
@@ -171,7 +158,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[str]`: Список тикеров.
         """
-        pass
+        ...
 
     async def tickers_batched(
         self, only_usdt: bool = True, batch_size: int = 20
@@ -198,7 +185,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[str]`: Список тикеров.
         """
-        pass
+        ...
 
     async def futures_tickers_batched(
         self, only_usdt: bool = True, batch_size: int = 20
@@ -222,7 +209,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `dict[str, float]`: Словарь с последними ценами для каждого тикера.
         """
-        pass
+        ...
 
     @abstractmethod
     async def futures_last_price(self) -> dict[str, float]:
@@ -231,31 +218,31 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `dict[str, float]`: Словарь с последними ценами для каждого тикера.
         """
-        pass
+        ...
 
     @abstractmethod
-    async def ticker_24h(self) -> dict[str, TickerDailyDict]:
+    async def ticker_24hr(self) -> TickerDailyDict:
         """Возвращает статистику за последние 24 часа для каждого тикера.
 
         Возвращает:
-            `dict[str, TickerDailyDict]`: Словарь с статистикой за последние 24 часа для каждого тикера.
+            `TickerDailyDict`: Словарь с статистикой за последние 24 часа для каждого тикера.
         """
-        pass
+        ...
 
     @abstractmethod
-    async def futures_ticker_24h(self) -> dict[str, TickerDailyDict]:
+    async def futures_ticker_24hr(self) -> TickerDailyDict:
         """Возвращает статистику за последние 24 часа для каждого тикера.
 
         Возвращает:
-            `dict[str, TickerDailyDict]`: Словарь с статистикой за последние 24 часа для каждого тикера.
+            `TickerDailyDict`: Словарь с статистикой за последние 24 часа для каждого тикера.
         """
-        pass
+        ...
 
     @abstractmethod
     async def klines(
         self,
         symbol: str,
-        interval: Timeframe,
+        interval: Timeframe | str,
         limit: int | None = None,
         start_time: int | None = None,
         end_time: int | None = None,
@@ -272,13 +259,13 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[KlineDict]`: Список свечей.
         """
-        pass
+        ...
 
     @abstractmethod
     async def futures_klines(
         self,
         symbol: str,
-        interval: Timeframe,
+        interval: Timeframe | str,
         limit: int | None = None,
         start_time: int | None = None,
         end_time: int | None = None,
@@ -295,32 +282,48 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[KlineDict]`: Список свечей.
         """
-        pass
+        ...
+
+    @overload
+    async def funding_rate(self, symbol: str) -> float: ...
+
+    @overload
+    async def funding_rate(self, symbol: None) -> dict[str, float]: ...
+
+    @overload
+    async def funding_rate(self) -> dict[str, float]: ...
 
     @abstractmethod
-    async def funding_rate(self) -> dict[str, float]:
-        """Возвращает ставку финансирования для всех тикеров.
+    async def funding_rate(self, symbol: str | None = None) -> dict[str, float] | float:
+        """Возвращает ставку финансирования для тикера или всех тикеров, если тикер не указан.
+
+        Параметры:
+            symbol (`str | None`): Название тикера (Опционально).
 
         Возвращает:
-            `dict[str, float]`: Ставка финансирования для каждого тикера.
+            `dict[str, float] | float`: Ставка финансирования для тикера или словарь со ставками для всех тикеров.
         """
-        pass
+        ...
+
+    @overload
+    async def open_interest(self, symbol: str) -> OpenInterestItem: ...
 
     @overload
-    async def open_interest(self, symbol: str) -> float: ...
+    async def open_interest(self, symbol: None) -> OpenInterestDict: ...
 
     @overload
-    async def open_interest(self, symbol: None) -> dict[str, float]: ...
+    async def open_interest(self) -> OpenInterestDict: ...
 
     @abstractmethod
-    async def open_interest(self, symbol: str | None) -> float | dict[str, float]:
-        """Возвращает объем открытого интереса для тикера или всех тикеров,
-        если тикер не указан.
+    async def open_interest(self, symbol: str | None = None) -> OpenInterestItem | OpenInterestDict:
+        """Возвращает объем открытого интереса для тикера или всех тикеров, если тикер не указан.
 
         Параметры:
-            symbol (`str | None`): Название тикера (Опционально).
+            symbol (`str | None`): Название тикера (Опционально, но обязателен для следующих бирж: BINANCE).
 
         Возвращает:
-            `float`: Объем открытых позиций в монетах.
+            `OpenInterestItem | OpenInterestDict`: Если тикер передан - словарь со временем и объемом
+                открытого интереса в монетах. Если нет передан - то словарь, в котором ключ - тикер,
+                а значение - словарь с временем и объемом открытого интереса в монетах.
         """
-        pass
+        ...

unicex/_abc/uni_websocket_manager.py

@@ -92,7 +92,7 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета для управления соединением.
         """
-        pass
+        ...
 
     @overload
     def futures_klines(
@@ -135,7 +135,7 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        pass
+        ...
 
     @overload
     def trades(
@@ -174,7 +174,7 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        pass
+        ...
 
     @overload
     def aggtrades(
@@ -213,7 +213,7 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        pass
+        ...
 
     @overload
     def futures_trades(
@@ -252,7 +252,7 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        pass
+        ...
 
     @overload
     def futures_aggtrades(
@@ -291,4 +291,4 @@ class IUniWebsocketManager(ABC):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        pass
+        ...

unicex/_base/websocket.py

@@ -125,11 +125,15 @@ class Websocket:
 
             # Проверяем размер очереди сообщений и выбрасываем ошибку, если он превышает максимальный размер
             self._check_queue_size()
+        except QueueOverflowError:
+            self._logger.error("Message queue is overflow")
         except orjson.JSONDecodeError as e:
             if message in ["ping", "pong"]:
-                self._logger.debug(f"{self} Received ping message: {message}")
+                self._logger.debug(f"Received ping message: {message}")
             else:
                 self._logger.error(f"Failed to decode JSON message: {message}, error: {e}")
+        except Exception as e:
+            self._logger.error(f"Unexpected error: {e}")
 
     def _check_queue_size(self) -> None:
         """Проверяет размер очереди и выбрасывает ошибку при переполнении."""
@@ -182,13 +186,9 @@ class Websocket:
             except asyncio.exceptions.CancelledError:
                 break
             except Exception as e:
-                self._logger.error(f"{self} Error({type(e)}) while processing message: {e}")
+                self._logger.error(f"Error({type(e)}) while processing message: {e}")
 
-            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}")
+            self._queue.task_done()
 
     def _generate_ws_kwargs(self) -> dict:
         """Генерирует аргументы для запуска вебсокета."""

unicex/binance/__init__.py

@@ -1,6 +1,12 @@
 """Пакет, содержащий реализации клиентов и менеджеров для работы с биржей Binance."""
 
-__all__ = ["Client", "UniClient", "UserWebsocket", "WebsocketManager", "UniWebsocketManager"]
+__all__ = [
+    "Client",
+    "UniClient",
+    "UserWebsocket",
+    "WebsocketManager",
+    "UniWebsocketManager",
+]
 
 from .client import Client
 from .uni_client import UniClient