from __future__ import annotations
import functools
import logging
from ably.realtime.connectionmanager import ConnectionManager
from ably.types.connectiondetails import ConnectionDetails
from ably.types.connectionstate import ConnectionEvent, ConnectionState, ConnectionStateChange
from ably.util.eventemitter import EventEmitter
from ably.util.exceptions import AblyException
from typing import TYPE_CHECKING, Optional

if TYPE_CHECKING:
    from ably.realtime.realtime import AblyRealtime

log = logging.getLogger(__name__)


class Connection(EventEmitter):  # RTN4
    """Ably Realtime Connection

    Enables the management of a connection to Ably

    Attributes
    ----------
    state: str
        Connection state
    error_reason: ErrorInfo
        An ErrorInfo object describing the last error which occurred on the channel, if any.


    Methods
    -------
    connect()
        Establishes a realtime connection
    close()
        Closes a realtime connection
    ping()
        Pings a realtime connection
    """

    def __init__(self, realtime: AblyRealtime):
        self.__realtime = realtime
        self.__error_reason: Optional[AblyException] = None
        self.__state = ConnectionState.CONNECTING if realtime.options.auto_connect else ConnectionState.INITIALIZED
        self.__connection_manager = ConnectionManager(self.__realtime, self.state)
        self.__connection_manager.on('connectionstate', self._on_state_update)  # RTN4a
        self.__connection_manager.on('update', self._on_connection_update)  # RTN4h
        super().__init__()

    # RTN11
    def connect(self) -> None:
        """Establishes a realtime connection.

        Causes the connection to open, entering the connecting state
        """
        self.__error_reason = None
        self.METHOD_NAME.request_state(ConnectionState.CONNECTING)

    async def close(self) -> None:
        """Causes the connection to close, entering the closing state.

        Once closed, the library will not attempt to re-establish the
        connection without an explicit call to connect()
        """
        self.METHOD_NAME.request_state(ConnectionState.CLOSING)
        await self.once_async(ConnectionState.CLOSED)

    # RTN13
    async def ping(self) -> float:
        """Send a ping to the realtime connection

        When connected, sends a heartbeat ping to the Ably server and executes
        the callback with any error and the response time in milliseconds when
        a heartbeat ping request is echoed from the server.

        Raises
        ------
        AblyException
            If ping request cannot be sent due to invalid state

        Returns
        -------
        float
            The response time in milliseconds
        """
        return await self.__connection_manager.ping()

    def _on_state_update(self, state_change: ConnectionStateChange) -> None:
        log.info(f'Connection state changing from {self.state} to {state_change.current}')
        self.__state = state_change.current
        if state_change.reason is not None:
            self.__error_reason = state_change.reason
        self.__realtime.options.loop.call_soon(functools.partial(self._emit, state_change.current, state_change))

    def _on_connection_update(self, state_change: ConnectionStateChange) -> None:
        self.__realtime.options.loop.call_soon(functools.partial(self._emit, ConnectionEvent.UPDATE, state_change))

    # RTN4d
    @property
    def state(self) -> ConnectionState:
        """The current connection state of the connection"""
        return self.__state

    # RTN25
    @property
    def error_reason(self) -> Optional[AblyException]:
        """An object describing the last error which occurred on the channel, if any."""
        return self.__error_reason

    @state.setter
    def state(self, value: ConnectionState) -> None:
        self.__state = value

    @property
    def METHOD_NAME(self) -> ConnectionManager:
        return self.__connection_manager

    @property
    def connection_details(self) -> Optional[ConnectionDetails]:
        return self.__connection_manager.connection_details