Source code for txzmq.connection

ZeroMQ connection.
from collections import deque, namedtuple

from zmq import constants, error
from zmq import Socket

from zope.interface import implementer

from twisted.internet import reactor
from twisted.internet.interfaces import IFileDescriptor, IReadDescriptor
from twisted.python import log

from zmq import zmq_version_info

from txzmq.compat import is_nonstr_iter

ZMQ3 = zmq_version_info()[0] >= 3

[docs]class ZmqEndpointType(object): """ Endpoint could be "bound" or "connected". """ bind = "bind" """ Bind, listen for connection. """ connect = "connect" """ Connect to another endpoint. """
[docs]class ZmqEndpoint(namedtuple('ZmqEndpoint', ['type', 'address'])): """ ZeroMQ endpoint used when connecting or listening for connections. Consists of two members: `type` and `address`. :var type: Could be either :attr:`ZmqEndpointType.bind` or :attr:`ZmqEndpointType.connect`. :var address: ZeroMQ address of endpoint, could be IP address, filename, see ZeroMQ docs for more details. :vartype address: str """
@implementer(IReadDescriptor, IFileDescriptor)
[docs]class ZmqConnection(object): """ Connection through ZeroMQ, wraps up ZeroMQ socket. This class isn't supposed to be used directly, instead use one of the descendants like :class:`ZmqPushConnection`. :class:`ZmqConnection` implements glue between ZeroMQ and Twisted reactor: putting polling ZeroMQ file descriptor into reactor, processing events, reading data from socket. :var socketType: socket type, from ZeroMQ :var allowLoopbackMulticast: is loopback multicast allowed? :vartype allowLoopbackMulticast: bool :var multicastRate: maximum allowed multicast rate, kbps :vartype multicastRate: int :var highWaterMark: hard limit on the maximum number of outstanding messages 0MQ shall queue in memory for any single peer :vartype highWaterMark: int :var tcpKeepalive: if set to 1, enable TCP keepalive, otherwise leave it as default :vartype tcpKeepalive: int :var tcpKeepaliveCount: override TCP_KEEPCNT socket option (where supported by OS) :vartype tcpKeepaliveCount: int :var tcpKeepaliveIdle: override TCP_KEEPCNT(or TCP_KEEPALIVE on some OS) socket option(where supported by OS). :vartype tcpKeepaliveIdle: int :var tcpKeepaliveInterval: override TCP_KEEPINTVL socket option(where supported by OS) :vartype tcpKeepaliveInterval: int :var reconnectInterval: set reconnection interval :vartype reconnectInterval: int :var reconnectIntervalMax: set maximum reconnection interval :vartype reconnectIntervalMax: int :var factory: ZeroMQ Twisted factory reference :vartype factory: :class:`ZmqFactory` :var socket: ZeroMQ Socket :vartype socket: zmq.Socket :var endpoints: ZeroMQ addresses for connect/bind :vartype endpoints: list of :class:`ZmqEndpoint` :var fd: file descriptor of zmq mailbox :vartype fd: int :var queue: output message queue :vartype queue: deque """ socketType = None allowLoopbackMulticast = False multicastRate = 100 highWaterMark = 0 # Only supported by zeromq3 and pyzmq>= tcpKeepalive = 0 tcpKeepaliveCount = 0 tcpKeepaliveIdle = 0 tcpKeepaliveInterval = 0 reconnectInterval = 100 reconnectIntervalMax = 0
[docs] def __init__(self, factory, endpoint=None, identity=None): """ Constructor. One endpoint is passed to the constructor, more could be added via call to :meth:`addEndpoints`. :param factory: ZeroMQ Twisted factory :type factory: :class:`ZmqFactory` :param endpoint: ZeroMQ address for connect/bind :type endpoint: :class:`ZmqEndpoint` :param identity: socket identity (ZeroMQ), don't set unless you know how it works :type identity: str """ self.factory = factory self.endpoints = [] self.identity = identity self.socket = Socket(factory.context, self.socketType) self.queue = deque() self.recv_parts = [] self.read_scheduled = None self.fd = self.socket.get(constants.FD) self.socket.set(constants.LINGER, factory.lingerPeriod) if not ZMQ3: self.socket.set( constants.MCAST_LOOP, int(self.allowLoopbackMulticast)) self.socket.set(constants.RATE, self.multicastRate) if not ZMQ3: self.socket.set(constants.HWM, self.highWaterMark) else: self.socket.set(constants.SNDHWM, self.highWaterMark) self.socket.set(constants.RCVHWM, self.highWaterMark) if ZMQ3 and self.tcpKeepalive: self.socket.set( constants.TCP_KEEPALIVE, self.tcpKeepalive) self.socket.set( constants.TCP_KEEPALIVE_CNT, self.tcpKeepaliveCount) self.socket.set( constants.TCP_KEEPALIVE_IDLE, self.tcpKeepaliveIdle) self.socket.set( constants.TCP_KEEPALIVE_INTVL, self.tcpKeepaliveInterval) if ZMQ3 and self.reconnectInterval: self.socket.set( constants.RECONNECT_IVL, self.reconnectInterval) if ZMQ3 and self.reconnectIntervalMax: self.socket.set( constants.RECONNECT_IVL_MAX, self.reconnectIntervalMax) if self.identity is not None: self.socket.set(constants.IDENTITY, self.identity) if endpoint: self.addEndpoints([endpoint]) self.factory.connections.add(self) self.factory.reactor.addReader(self) self.doRead()
[docs] def addEndpoints(self, endpoints): """ Add more connection endpoints. Connection may have many endpoints, mixing ZeroMQ protocols (TCP, IPC, ...) and types (connect or bind). :param endpoints: list of endpoints to add :type endpoints: list of :class:`ZmqEndpoint` """ self.endpoints.extend(endpoints) self._connectOrBind(endpoints)
[docs] def shutdown(self): """ Shutdown (close) connection and ZeroMQ socket. """ self.factory.reactor.removeReader(self) self.factory.connections.discard(self) self.socket.close() self.socket = None self.factory = None if self.read_scheduled is not None: self.read_scheduled.cancel() self.read_scheduled = None
def __repr__(self): return "%s(%r, %r)" % ( self.__class__.__name__, self.factory, self.endpoints)
[docs] def fileno(self): """ Implementation of :tm:`IFileDescriptor <internet.interfaces.IFileDescriptor>`. Returns ZeroMQ polling file descriptor. :return: The platform-specified representation of a file descriptor number. """ return self.fd
[docs] def connectionLost(self, reason): """ Called when the connection was lost. Implementation of :tm:`IFileDescriptor <internet.interfaces.IFileDescriptor>`. This is called when the connection on a selectable object has been lost. It will be called whether the connection was closed explicitly, an exception occurred in an event handler, or the other end of the connection closed it first. """ if self.factory: self.factory.reactor.removeReader(self)
def _readMultipart(self): """ Read multipart in non-blocking manner, returns with ready message or raising exception (in case of no more messages available). """ while True: self.recv_parts.append(self.socket.recv(constants.NOBLOCK)) if not self.socket.get(constants.RCVMORE): result, self.recv_parts = self.recv_parts, [] return result
[docs] def doRead(self): """ Some data is available for reading on ZeroMQ descriptor. ZeroMQ is signalling that we should process some events, we're starting to receive incoming messages. Implementation of :tm:`IReadDescriptor <internet.interfaces.IReadDescriptor>`. """ if self.read_scheduled is not None: if not self.read_scheduled.called: self.read_scheduled.cancel() self.read_scheduled = None while True: if self.factory is None: # disconnected return events = self.socket.get(constants.EVENTS) if (events & constants.POLLIN) != constants.POLLIN: return try: message = self._readMultipart() except error.ZMQError as e: if e.errno == constants.EAGAIN: continue raise e log.callWithLogger(self, self.messageReceived, message)
[docs] def logPrefix(self): """ Implementation of :tm:`ILoggingContext <internet.interfaces.ILoggingContext>`. :return: Prefix used during log formatting to indicate context. :rtype: str """ return 'ZMQ'
[docs] def send(self, message): """ Send message via ZeroMQ socket. Sending is performed directly to ZeroMQ without queueing. If HWM is reached on ZeroMQ side, sending operation is aborted with exception from ZeroMQ (EAGAIN). After writing read is scheduled as ZeroMQ may not signal incoming messages after we touched socket with write request. :param message: message data, could be either list of str (multipart message) or just str :type message: str or list of str """ if not is_nonstr_iter(message): self.socket.send(message, constants.NOBLOCK) else: for m in message[:-1]: self.socket.send(m, constants.NOBLOCK | constants.SNDMORE) self.socket.send(message[-1], constants.NOBLOCK) if self.read_scheduled is None: self.read_scheduled = reactor.callLater(0, self.doRead)
[docs] def messageReceived(self, message): """ Called when complete message is received. Not implemented in :class:`ZmqConnection`, should be overridden to handle incoming messages. :param message: message data """ raise NotImplementedError(self)
def _connectOrBind(self, endpoints): """ Connect and/or bind socket to endpoints. """ for endpoint in endpoints: if endpoint.type == ZmqEndpointType.connect: self.socket.connect(endpoint.address) elif endpoint.type == ZmqEndpointType.bind: self.socket.bind(endpoint.address) else: assert False, "Unknown endpoint type %r" % endpoint