Current File : //lib64/python2.7/site-packages/zmq/sugar/socket.pyo
�
+�{Wc @ s� d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m
Z
d d l m Z d d l
m Z d d l m Z m Z d d l m Z m Z m Z d d
l m Z m Z m Z m Z m Z m Z m Z y d d l Z e Z Wn e Z d d l Z n Xy
e j Z Wn e! k
rCe j" Z n Xy
e# Z$ Wn e% k
rge& Z$ n Xd e e f d � � YZ d g Z' d S(
s 0MQ Socket pure Python methods.i����N( t Socketi ( t Poller( t constants( t AttributeSetter( t ZMQErrort ZMQBindError( t bytest unicodet
basestring( t SNDMOREt ENOTSUPt POLLINt int64_sockopt_namest int_sockopt_namest bytes_sockopt_namest fd_sockopt_namesR c B s� e Z d Z e Z d" Z d � Z d � Z d � Z d � Z
d" d � Z e Z e
d � � Z e d � � Z d � Z e j Z e j Z d � Z d
� Z d � Z d d
� Z e Z Z d d � Z e Z Z d d d d � Z d � Z! d � Z" e e! e" d � Z# d e$ e d � Z% d e$ e d � Z& d e$ d d � Z' e' Z( d d d � Z) e) Z* d e+ d � Z, d d � Z- d d � Z. d d � Z/ e0 Z1 d" e2 d � Z3 d" d" d � Z4 d! � Z5 RS(# s� The ZMQ socket object
To create a Socket, first create a Context::
ctx = zmq.Context.instance()
then call ``ctx.socket(socket_type)``::
s = ctx.socket(zmq.ROUTER)
c O s> t t | � j | | � d | k r1 t | _ n t | _ d S( Nt shadow( t superR t __init__t Truet _shadowt False( t selft at kw( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR = s c C s | j s | j � n d S( N( R t close( R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt __del__D s c C s | S( sM Sockets are context managers
.. versionadded:: 14.4
( ( R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt __enter__I s c O s | j � d S( N( R ( R t argst kwargs( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt __exit__P s c C s | j j | j � S( s& Copying a Socket creates a shadow copy( t __class__R t
underlying( R t memo( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt __copy__W s c C s) d d l m } | | � } | d | � S( s� Shadow an existing libzmq socket
address is the integer address of the libzmq socket
or an FFI pointer to it.
.. versionadded:: 14.1
i����( t
cast_int_addrR ( t zmq.utils.interopR# ( t clst addressR# ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR ] s c C s t j d t � | j S( Ns1 Socket.socket_type is deprecated, use Socket.type( t warningst warnt DeprecationWarningt type( R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt socket_typen s c C s= t | j � } x' t t t t f D] } | j | � q" W| S( N( t dirR R R
R R t extend( R t keyst
collection( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt __dir__y s
c C s� | j � } | d k rr t | t � r9 | j d � } n | d k r[ | j t j | � n | j t j | � d St t | � j
| | � d S( sR override to allow setting zmq.[UN]SUBSCRIBE even though we have a subscribe methodt subscribet unsubscribet utf8N( s subscribes unsubscribe( t lowert
isinstanceR t encodet sett zmqt SUBSCRIBEt UNSUBSCRIBER R t __setattr__( R t keyt valuet _key( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR; � s c C s8 t | t � r! | j d � } n | j t j | � d S( s\ Subscribe to a topic
Only for SUB sockets.
.. versionadded:: 15.3
R3 N( R5 R R6 R7 R8 R9 ( R t topic( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR1 � s c C s8 t | t � r! | j d � } n | j t j | � d S( s` Unsubscribe from a topic
Only for SUB sockets.
.. versionadded:: 15.3
R3 N( R5 R R6 R7 R8 R: ( R R? ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR2 � s s utf-8c C s7 t | t � s t d � � n | j | | j | � � S( s3 set socket options with a unicode object
This is simply a wrapper for setsockopt to protect from encoding ambiguity.
See the 0MQ documentation for details on specific options.
Parameters
----------
option : int
The name of the option to set. Can be any of: SUBSCRIBE,
UNSUBSCRIBE, IDENTITY
optval : unicode string (unicode on py2, str on py3)
The value of the option to set.
encoding : str
The encoding to be used, default is utf8
s unicode strings only( R5 R t TypeErrorR7 R6 ( R t optiont optvalt encoding( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt
set_string� s c C s8 | t j k r" t d | � � n | j | � j | � S( sd get the value of a socket option
See the 0MQ documentation for details on specific options.
Parameters
----------
option : int
The option to retrieve.
Returns
-------
optval : unicode string (unicode on py2, str on py3)
The value of the option as a unicode string.
s0 option %i will not return a string to be decoded( R t bytes_sockoptsR@ t
getsockoptt decode( R RA RC ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt
get_string� s i � i id c C s" t t d � ro | d k ro | d k ro | j d | � | j j d d � } | j d d � \ } } t | � Sx� t | � D]� } y- t j | | � } | j d | | f � WnX t
k
r }
|
j } | t j
k r� q| qt j d
k r| t j k rq| q� q| X| Sq| Wt d � � d S(
s bind this socket to a random port in a range
If the port range is unspecified, the system will choose the port.
Parameters
----------
addr : str
The address string without the port to pass to ``Socket.bind()``.
min_port : int, optional
The minimum port in the range of ports to try (inclusive).
max_port : int, optional
The maximum port in the range of ports to try (exclusive).
max_tries : int, optional
The maximum number of bind attempts to make.
Returns
-------
port : int
The port the socket was bound to.
Raises
------
ZMQBindError
if `max_tries` reached before successful bind
t
LAST_ENDPOINTi � i s %s:0t asciit replacet :i s %s:%st win32s% Could not bind socket to random port.N( t hasattrR t bindt
last_endpointRG t rsplitt intt ranget randomt randrangeR t errnoR8 t
EADDRINUSEt syst platformt EACCESR ( R t addrt min_portt max_portt max_triest urlt _t port_st it portt exceptiont en( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt bind_to_random_port� s$ '
c C sm t j � d } | d k rY y | j t j � SWn t j k
rH } n X| j t j � S| j t j � Sd S( sr get the High Water Mark
On libzmq ≥ 3, this gets SNDHWM if available, otherwise RCVHWM
i i N( R8 t zmq_version_infoRF t SNDHWMR t RCVHWMt HWM( R t majort e( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt get_hwm
s c C s� t j � d } | d k r� d } y
| | _ Wn t k
rJ } | } n Xy
| | _ Wn t k
rs } | } n X| r� | � q� n | j t j | � Sd S( s� set the High Water Mark
On libzmq ≥ 3, this sets both SNDHWM and RCVHWM
.. warning::
New values only take effect for subsequent socket
bind/connects.
i i N( R8 Rg t Nonet sndhwmt Exceptiont rcvhwmt
setsockoptRj ( R R= Rk t raisedRl ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt set_hwm s
s� property for High Water Mark
Setting hwm sets both SNDHWM and RCVHWM as appropriate.
It gets SNDHWM if available, otherwise RCVHWM.
i c C s� x� t | � D]� \ } } t | t j t t f � r: q
n y t | � Wq
t k
r� } t | � } t | � d k r� | d d } n t d | | f � � q
Xq
Wx2 | d D]& } | j
| t | Bd | d | �q� W| j
| d | d | d | �S( s� send a sequence of buffers as a multipart message
The zmq.SNDMORE flag is added to all msg parts before the last.
Parameters
----------
msg_parts : iterable
A sequence of objects to send as a multipart message. Each element
can be any sendable object (Frame, bytes, buffer-providers)
flags : int, optional
SNDMORE is handled automatically for frames before the last.
copy : bool, optional
Should the frame(s) be sent in a copying or non-copying manner.
track : bool, optional
Should the frame(s) be tracked for notification that ZMQ has
finished with it (ignored if copy=True).
Returns
-------
None : if copy or not track
MessageTracker : if track and not copy
a MessageTracker object, whose `pending` property will
be True until the last send is completed.
i s ...s4 Frame %i (%s) does not support the buffer interface.i����t copyt track( t enumerateR5 R8 t FrameR t _buffer_typeRp t reprt lenR@ t sendR ( R t msg_partst flagsRu Rv Rb t msgRl t rmsg( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt send_multipartF s $c C sc | j | d | d | �g } x> | j t j � r^ | j | d | d | �} | j | � q! W| S( s� receive a multipart message as a list of bytes or Frame objects
Parameters
----------
flags : int, optional
Any supported flag: NOBLOCK. If NOBLOCK is set, this method
will raise a ZMQError with EAGAIN if a message is not ready.
If NOBLOCK is not set, then this method will block until a
message arrives.
copy : bool, optional
Should the message frame(s) be received in a copying or non-copying manner?
If False a Frame object is returned for each part, if True a copy of
the bytes is made for each frame.
track : bool, optional
Should the message frame(s) be tracked for notification that ZMQ has
finished with it? (ignored if copy=True)
Returns
-------
msg_parts : list
A list of frames in the multipart message; either Frames or bytes,
depending on `copy`.
Ru Rv ( t recvRF R8 t RCVMOREt append( R R~ Ru Rv t partst part( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt recv_multipartr s
c C s@ t | t � s t d � � n | j | j | � d | d | �S( s� send a Python unicode string as a message with an encoding
0MQ communicates with raw bytes, so you must encode/decode
text (unicode on py2, str on py3) around 0MQ.
Parameters
----------
u : Python unicode string (unicode on py2, str on py3)
The unicode string to send.
flags : int, optional
Any valid send flag.
encoding : str [default: 'utf-8']
The encoding to be used
s unicode/str objects onlyR~ Ru ( R5 R R@ R| R6 ( R t uR~ Ru RC ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt send_string� s c C s | j d | � } | j | � S( s� receive a unicode string, as sent by send_string
Parameters
----------
flags : int
Any valid recv flag.
encoding : str [default: 'utf-8']
The encoding to be used
Returns
-------
s : unicode string (unicode on py2, str on py3)
The Python unicode string that arrives as encoded bytes.
R~ ( R� RG ( R R~ RC t b( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt recv_string� s c C s" t j | | � } | j | | � S( s� send a Python object as a message using pickle to serialize
Parameters
----------
obj : Python object
The Python object to send.
flags : int
Any valid send flag.
protocol : int
The pickle protocol number to use. The default is pickle.DEFAULT_PROTOCOL
where defined, and pickle.HIGHEST_PROTOCOL elsewhere.
( t picklet dumpsR| ( R t objR~ t protocolR ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt
send_pyobj� s
c C s | j | � } t j | � S( s receive a Python object as a message using pickle to serialize
Parameters
----------
flags : int
Any valid recv flag.
Returns
-------
obj : Python object
The Python object that arrives as a message.
( R� R� t loads( R R~ t s( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt
recv_pyobj� s
c K s2 d d l m } | j | | � } | j | | � S( s& send a Python object as a message using json to serialize
Keyword arguments are passed on to json.dumps
Parameters
----------
obj : Python object
The Python object to send
flags : int
Any valid send flag
i����( t jsonapi( t zmq.utilsR� R� R| ( R R� R~ R R� R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt send_json� s c K s/ d d l m } | j | � } | j | | � S( sV receive a Python object as a message using json to serialize
Keyword arguments are passed on to json.loads
Parameters
----------
flags : int
Any valid recv flag.
Returns
-------
obj : Python object
The Python object that arrives as a message.
i����( R� ( R� R� R� R� ( R R~ R R� R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt recv_json� s c C sY | j r t t � � n | j � } | j | | � t | j | � � } | j | d � S( s� poll the socket for events
The default is to poll forever for incoming
events. Timeout is in milliseconds, if specified.
Parameters
----------
timeout : int [default: None]
The timeout (in milliseconds) to wait for an event. If unspecified
(or specified None), will wait forever for an event.
flags : bitfield (int) [default: POLLIN]
The event flags to poll for (any combination of POLLIN|POLLOUT).
The default is to check for incoming events (POLLIN).
Returns
-------
events : bitfield (int)
The events that are ready and waiting. Will be 0 if no events were ready
by the time timeout was reached.
i ( t closedR R
t
_poller_classt registert dictt pollt get( R t timeoutR~ t pt evts( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR� s c C s� t j � d k r+ t d t j � � � n | j rV | j j rL d | _ qV | j Sn | d k rr d | j } n | d k r� t j } n | j | | � | j
j t j � | _ | j j
| � | j S( s+ Return a connected PAIR socket ready to receive the event notifications.
.. versionadded:: libzmq-4.0
.. versionadded:: 14.0
Parameters
----------
events : bitfield (int) [default: ZMQ_EVENTS_ALL]
The bitmask defining which events are wanted.
addr : string [default: None]
The optional endpoint for the monitoring sockets.
Returns
-------
socket : (PAIR)
The socket is already connected and ready to receive messages.
i s0 get_monitor_socket requires libzmq >= 4, have %ss inproc://monitor.s-%d( i N( R8 Rg t NotImplementedErrort zmq_versiont _monitor_socketR� Rn t FDt EVENT_ALLt monitort contextt sockett PAIRt connect( R t eventsR[ ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt get_monitor_socket s
c C s d | _ | j d d � d S( s� Shutdown the PAIR socket (created using get_monitor_socket)
that is serving socket events.
.. versionadded:: 14.4
i N( Rn R� R� ( R ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt disable_monitorJ s N(6 t __name__t
__module__t __doc__R R Rn R� R R R R R" t __deepcopy__t classmethodR t propertyR+ R0 t
SocketBaseR7 Rr R� RF R; R1 R2 RD t setsockopt_unicodet setsockopt_stringRH t getsockopt_unicodet getsockopt_stringRf Rm Rt t hwmR R� R� R� t send_unicodeR� t recv_unicodet DEFAULT_PROTOCOLR� R� R� R� R R� R R� R� R� ( ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyR . sP
2 ,! *(( R� RV RT RX R' R8 t zmq.backendR R� R� R t R t attrsettrR t zmq.errorR R t zmq.utils.strtypesR R R R R
R R R
R R t cPickleR� Rn R� t AttributeErrort HIGHEST_PROTOCOLt
memoryviewRy t NameErrort buffert __all__( ( ( s6 /usr/lib64/python2.7/site-packages/zmq/sugar/socket.pyt <module> s< 4
� � (
Mini Shell