bitfinex-api-py/bfxapi/websocket/_connection.py

from typing import \
    TYPE_CHECKING, Optional, cast

from bfxapi.websocket.exceptions import \
    ConnectionNotOpen, ActionRequiresAuthentication

if TYPE_CHECKING:
    from websockets.client import WebSocketClientProtocol

class Connection:
    HEARTBEAT = "hb"

    def __init__(self, host: str) -> None:
        self._host = host

        self._authentication: bool = False

        self.__protocol: Optional["WebSocketClientProtocol"] = None

    @property
    def open(self) -> bool:
        return self.__protocol is not None and \
            self.__protocol.open

    @property
    def authentication(self) -> bool:
        return self._authentication

    @property
    def _websocket(self) -> "WebSocketClientProtocol":
        return cast("WebSocketClientProtocol", self.__protocol)

    @_websocket.setter
    def _websocket(self, protocol: "WebSocketClientProtocol") -> None:
        self.__protocol = protocol

    @staticmethod
    def require_websocket_connection(function):
        async def wrapper(self, *args, **kwargs):
            if self.open:
                return await function(self, *args, **kwargs)

            raise ConnectionNotOpen("No open connection with the server.")

        return wrapper

    @staticmethod
    def require_websocket_authentication(function):
        async def wrapper(self, *args, **kwargs):
            if not self.authentication:
                raise ActionRequiresAuthentication("To perform this action you need to " \
                    "authenticate using your API_KEY and API_SECRET.")

            internal = Connection.require_websocket_connection(function)

            return await internal(self, *args, **kwargs)

        return wrapper