import abc


class SessionStore(abc.ABC):  # pragma: no cover
    """Base class for session storages."""

    @abc.abstractmethod
    async def read(self, session_id: str, lifetime: int) -> bytes:
        """
        Read session data from the storage.

        :param session_id: ID associated with session
        :param lifetime: session lifetime duration
        :returns bytes: session data as bytes
        """
        raise NotImplementedError

    @abc.abstractmethod
    async def write(self, session_id: str, data: bytes, lifetime: int, ttl: int) -> str:
        """
        Write session data to the storage.

        Must return session ID. Either new or from arguments.
        The difference between `lifetime` and `ttl` is that former defines the total session duration
        and the latter ony tells the amount to seconds left before the data can be safely removed.

        :param session_id: ID associated with session
        :param data: session data serialized to bytes
        :param lifetime: session lifetime, in seconds
        :param ttl: keep session data this amount of time, in seconds
        :returns str: session ID
        """
        raise NotImplementedError

    @abc.abstractmethod
    async def remove(self, session_id: str) -> None:
        """
        Remove session data from the storage.

        :param session_id: ID associated with session
        """
        raise NotImplementedError
