tractor/piker/ipc.py

"""
Inter-process comms abstractions
"""
from typing import Coroutine, Tuple

import msgpack
import trio

from .log import get_logger
log = get_logger('ipc')


class StreamQueue:
    """Stream wrapped as a queue that delivers ``msgpack`` serialized objects.
    """
    def __init__(self, stream):
        self.stream = stream
        self._agen = self._iter_packets()
        self._laddr = self.stream.socket.getsockname()[:2]
        self._raddr = self.stream.socket.getpeername()[:2]
        self._send_lock = trio.Lock()

    async def _iter_packets(self):
        """Yield packets from the underlying stream.
        """
        unpacker = msgpack.Unpacker(raw=False, use_list=False)
        while True:
            try:
                data = await self.stream.receive_some(2**10)
                log.trace(f"received {data}")
            except trio.BrokenStreamError:
                log.error(f"Stream connection {self.raddr} broke")
                return

            if data == b'':
                log.debug(f"Stream connection {self.raddr} was closed")
                return

            unpacker.feed(data)
            for packet in unpacker:
                yield packet

    @property
    def laddr(self):
        return self._laddr

    @property
    def raddr(self):
        return self._raddr

    async def put(self, data):
        async with self._send_lock:
            return await self.stream.send_all(
                msgpack.dumps(data, use_bin_type=True))

    async def get(self):
        return await self._agen.asend(None)

    async def __aiter__(self):
        return self._agen

    def connected(self):
        return self.stream.socket.fileno() != -1


class Channel:
    """A channel to actors in other processes.

    Use this to talk to any micro-service daemon or other client(s) over a
    a transport managed by ``trio``.
    """
    def __init__(
        self,
        destaddr: tuple = None,
        on_reconnect: Coroutine = None,
        auto_reconnect: bool = False,
        stream: trio.SocketStream = None,  # expected to be active
    ) -> None:
        self._recon_seq = on_reconnect
        self._autorecon = auto_reconnect
        self.squeue = StreamQueue(stream) if stream else None
        if self.squeue and destaddr:
            raise ValueError(
                f"A stream was provided with local addr {self.laddr}"
            )
        self._destaddr = destaddr or self.squeue.raddr
        # set after handshake - always uid of far end
        self.uid = None
        self.event = None

    def __repr__(self):
        if self.squeue:
            return repr(
                self.squeue.stream.socket._sock).replace(
                        "socket.socket", "Channel")
        return object.__repr__(self)

    @property
    def laddr(self):
        return self.squeue.laddr if self.squeue else (None, None)

    @property
    def raddr(self):
        return self.squeue.raddr if self.squeue else (None, None)

    async def connect(self, destaddr: Tuple[str, int] = None, **kwargs):
        if self.connected():
            raise RuntimeError("channel is already connected?")
        destaddr = destaddr or self._destaddr
        stream = await trio.open_tcp_stream(*destaddr, **kwargs)
        self.squeue = StreamQueue(stream)
        return stream

    async def send(self, item):
        log.trace(f"send `{item}`")
        await self.squeue.put(item)

    async def recv(self):
        try:
            return await self.squeue.get()
        except trio.BrokenStreamError:
            if self._autorecon:
                await self._reconnect()
                return await self.recv()
            self.squeue = None

    async def aclose(self, *args):
        log.debug(f"Closing {self}")
        await self.squeue.stream.aclose()
        self.squeue = None

    async def __aenter__(self):
        await self.connect()
        return self

    async def __aexit__(self, *args):
        await self.aclose(*args)

    async def __aiter__(self):
        return self.aiter_recv()

    async def _reconnect(self):
        """Handle connection failures by polling until a reconnect can be
        established.
        """
        down = False
        while True:
            try:
                with trio.move_on_after(3) as cancel_scope:
                    await self.connect()
                cancelled = cancel_scope.cancelled_caught
                if cancelled:
                    log.warn(
                        "Reconnect timed out after 3 seconds, retrying...")
                    continue
                else:
                    log.warn("Stream connection re-established!")
                    # run any reconnection sequence
                    on_recon = self._recon_seq
                    if on_recon:
                        await on_recon(self)
                    break
            except (OSError, ConnectionRefusedError):
                if not down:
                    down = True
                    log.warn(
                        f"Connection to {self.raddr} went down, waiting"
                        " for re-establishment")
                await trio.sleep(1)

    async def aiter_recv(self):
        """Async iterate items from underlying stream.
        """
        while True:
            try:
                async for item in self.squeue:
                    yield item
                    # sent = yield item
                    # if sent is not None:
                    #     # optimization, passing None through all the
                    #     # time is pointless
                    #     await self.squeue.put(sent)
            except trio.BrokenStreamError:
                if not self._autorecon:
                    raise
            await self.aclose()
            self.squeue = None
            if self._autorecon:  # attempt reconnect
                await self._reconnect()
                continue
            else:
                return

    def connected(self):
        return self.squeue.connected() if self.squeue else False