3
Õ@q^k(  ã               @   s°   d Z ddlZddlZddlZddlmZ ddlmZ G dd„ deƒZddl	m
Z
 G d	d
„ d
ƒZG dd„ dƒZG dd„ dƒZdd„ Zdd„ Zddd„Zdd„ Zdd„ Zdd„ ZdS )z"
Python interface to ZIO messages
é    N)Ú
namedtuple)ÚEnumc               @   s0   e Zd ZdZdZdZdZdZdZdZ	dZ
d	Zd
S )ÚMessageLevelr   é   é   é   é   é   é   é   é   N)Ú__name__Ú
__module__Ú__qualname__Ú	undefinedZtraceÚverboseÚdebugÚinfoZsummaryÚwarningÚerrorÚfatal© r   r   ú(/home/yuhw/zmq/zio/python/zio/message.pyr      s   r   r   )Úbyteify_listc               @   sH   e Zd ZdZejZdZdZddddœdd„Z	d	d
„ Z
dd„ Zdd„ ZdS )ÚPrefixHeaderzs
    A ZIO message prefix header.

    It is a triplet of (level, form, label) with a "ZIO" leading
    magic.
    ú r   Ú r   )ÚlevelÚformÚlabelc            G   s.  t t|ƒƒ| _d| | _|| _|s&dS t|d ƒtkrxt |d ƒ| _t|ƒdkr^d|d  | _t|ƒdkrt|d | _dS t|d ƒtkrôt|d ƒdkrô|d }|jdƒr¶|dd… }t t|d ƒƒ| _|dd… }d|dd	…  | _|d	d… | _t|d ƒt	k�r*t
|d ƒ\}| _| _t t|ƒƒ| _dS )
zš
        Create a prefix header

        >>> PrefixHeader(0, "FLOW", json.dumps(dict(flow="DAT")))
        >>> PrefixHeader(form="TEXT", level=3)
        z%-4sNr   r   r   r	   ZZIOr   r   )r   Úintr   r   r   ÚtypeÚlenÚstrÚ
startswithÚbytesÚdecode_header_prefix)Úselfr   r   r   ÚargsZphsr   r   r   Ú__init__$   s.    

 
zPrefixHeader.__init__c             C   s   d| j j| j| jf S )Nz	ZIO%d%s%s)r   Úvaluer   r   )r'   r   r   r   Ú__str__F   s    zPrefixHeader.__str__c             C   s   dt | ƒ S )Nz<zio.message.PrefixHeader %s>)r%   )r'   r   r   r   Ú__repr__I   s    zPrefixHeader.__repr__c             C   s0   d| j j }t| jdƒ}t| jdƒ}|| | S )Ns   ZIO%dzutf-8)r   r*   r%   r   r   )r'   ÚaÚbÚcr   r   r   Ú	__bytes__L   s    zPrefixHeader.__bytes__Nz    z    )r   r   r   Ú__doc__r   r   r   r   r   r)   r+   r,   r0   r   r   r   r   r      s   "r   c               @   sB   e Zd ZdZdZdZddddœdd„Zdd„ Zdd„ Zd	d
„ Z	dS )ÚCoordHeaderr   )ÚoriginÚgranuleÚseqnoc            G   sr   || _ || _|| _t|ƒdkr"d S t|ƒdkrB|\| _ | _| _d S t|d ƒtkrnt|d ƒ\| _ | _| _d S d S )Nr   r   )r3   r4   r5   r"   r!   r%   Údecode_header_coord)r'   r3   r4   r5   r(   r   r   r   r)   W   s    zCoordHeader.__init__c             C   s   t | j| j| jƒS )N)Úencode_header_coordr3   r4   r5   )r'   r   r   r   r0   d   s    zCoordHeader.__bytes__c             C   s   d| j | j| jf S )Nz[0x%x,%ld,%ld])r3   r4   r5   )r'   r   r   r   r+   g   s    zCoordHeader.__str__c             C   s   dt | ƒ S )Nz<zio.message.CoordHeader %s>)r%   )r'   r   r   r   r,   j   s    zCoordHeader.__repr__N)
r   r   r   r3   r4   r5   r)   r0   r+   r,   r   r   r   r   r2   R   s   r2   c               @   s2  e Zd ZdZdZdZdZf Zd,dd„Ze	dd„ ƒZ
e
jdd„ ƒZ
e	d	d
„ ƒZejdd
„ ƒZe	dd„ ƒZejdd„ ƒZe	dd„ ƒZejdd„ ƒZe	dd„ ƒZejdd„ ƒZe	dd„ ƒZejdd„ ƒZe	dd„ ƒZejdd„ ƒZe	dd„ ƒZejdd„ ƒZdd„ Zd d!„ Zd"d#„ Zd$d%„ Zd&d'„ Zd(d)„ Zd*d+„ ZdS )-ÚMessagezg
    A zio.Message fixes some of the message schema.

    It is equivalent to a C++ zio::Message.

    r   Nc             C   sÖ   t ƒ | _tƒ | _|dk	r"| j|ƒ |dk	r4| j|ƒ |dk	rF| j|ƒ |
dk	rT|
| _|	dk	rb|	| _|dk	rp|| _|dk	r~|| _|dk	rŒ|| _	|dk	rš|| _
|dk	r¨|| _|dk	r¶|| _|dk	rÄ|| _|dk	rÒ|| _dS )a,  Construct a zio.Message.

        Construction applies arguments in reverse order.  Thus one
        may, eg, construct a message with a frame and then override
        the payload and label.  The ingredients may be considered
        deconstructed as:

            frame = encoding + routing_id

            encoding = packing of parts

            parts = [prefix, coord, ...payloads]
        
        A frame should be used when the zio.Message will be used with
        a SERVER socket.  Or else the routing_id must be explicitly
        set.

        N)r   Úprefixr2   ÚcoordÚ	fromframeÚdecodeÚ	frompartsÚpayloadÚ
routing_idr   r   r   r3   r4   r5   )r'   r   r   r   r?   r3   r4   r5   r9   r:   r>   ÚpartsÚencodedÚframer   r   r   r)   |   s:    


zMessage.__init__c             C   s   | j jS )N)r9   r   )r'   r   r   r   r   ²   s    zMessage.formc             C   s   || j _d S )N)r9   r   )r'   Úvalr   r   r   r   µ   s    c             C   s   | j jS )N)r9   r   )r'   r   r   r   r   ¹   s    zMessage.levelc             C   s   || j _d S )N)r9   r   )r'   rC   r   r   r   r   ¼   s    c             C   s   | j jS )N)r9   r   )r'   r   r   r   r   À   s    zMessage.labelc             C   s   || j _d S )N)r9   r   )r'   rC   r   r   r   r   Ã   s    c             C   s6   | j stƒ S t| j ƒtkr*tj| jdƒƒS tj| j ƒS )Nzutf-8)r   Údictr!   r%   ÚjsonÚloadsr<   )r'   r   r   r   Úlabel_objectÇ   s
    zMessage.label_objectc             C   s   t j|ƒ| _d S )N)rE   Údumpsr   )r'   rC   r   r   r   rG   Ï   s    c             C   s   | j jS )N)r:   r3   )r'   r   r   r   r3   Ó   s    zMessage.originc             C   s   || j _d S )N)r:   r3   )r'   rC   r   r   r   r3   Ö   s    c             C   s   | j jS )N)r:   r4   )r'   r   r   r   r4   Ú   s    zMessage.granulec             C   s   || j _d S )N)r:   r4   )r'   rC   r   r   r   r4   Ý   s    c             C   s   | j jS )N)r:   r5   )r'   r   r   r   r5   á   s    zMessage.seqnoc             C   s   || j _d S )N)r:   r5   )r'   rC   r   r   r   r5   ä   s    c             C   s   | j p
tƒ S )N)Ú_payloadÚlist)r'   r   r   r   r>   é   s    zMessage.payloadc             C   s   t |ƒ| _d S )N)r   rI   )r'   Úplr   r   r   r>   í   s    c             C   s   t j| jƒ ƒ}| jrt|_|S )z)
        Return self as a frame.
        )ÚzmqÚFrameÚencoder?   )r'   rB   r   r   r   Útoframeñ   s    zMessage.toframec             C   s   |j | _ | j|jƒ dS )z'
        Set self from a frame
        N)r?   r<   r%   )r'   rB   r   r   r   r;   ú   s    zMessage.fromframec             C   s   | j ƒ }t|ƒS )zs
        Return encoded byte array of self.

        It is suitable for use as the data arg to a zmq.Frame
        )ÚtopartsÚencode_message)r'   r@   r   r   r   rN     s    zMessage.encodec             C   s   t |ƒ}| j|ƒ dS )z!
        Decode to self.
        N)Údecode_messager=   )r'   rA   r@   r   r   r   r<   
  s    
zMessage.decodec             C   s   t | jƒt | jƒg| j S )z@
        Return self as a multipart set of encoded data
        )r%   r9   r:   r>   )r'   r   r   r   rP     s    zMessage.topartsc             C   sB   t |ƒdk rtdƒ‚t|d ƒ| _t|d ƒ| _|dd… | _dS )zJ
        Set self from multipart message / array of encoded data.
        r   zmust have at least two partsr   r   N)r"   Ú
ValueErrorr   r9   r2   r:   r>   )r'   r@   r   r   r   r=     s
    zMessage.frompartsc             C   s   d| j | jt| jƒf S )Nzzio.Message: "%s" + %s + [%d])r9   r:   r"   r>   )r'   r   r   r   r+   "  s    zMessage.__str__)NNNNNNNNNNNNN)r   r   r   r1   r?   r9   r:   rI   r)   Úpropertyr   Úsetterr   r   rG   r3   r4   r5   r>   rO   r;   rN   r<   rP   r=   r+   r   r   r   r   r8   n   s@      
2		
r8   c             C   s2   d}x(| D ] }t jdt|ƒƒ}||| 7 }q
W |S )a*  
    Return a binary encoded concatenation of parts in the input
    sequence.  Result is suitable for use as a single-part message.
    For ZIO messages the first two parts should be encoded header
    prefix and coord, respectively.  Subseqent parts can be payload of
    arbitrary encoding.
    ó    ÚI)ÚstructÚpackr"   )r@   ÚretÚpÚsr   r   r   rQ   '  s
    
rQ   c             C   s†   t | ƒ}tƒ }d}xn||k r€|d }||kr4tdƒ‚tjd| ||… ƒd }|}|| }||krhtdƒ‚|j| ||… ƒ |}qW |S )zÙ
    Unpack an encoded single-part ZIO message such as returned by
    socket.recv() on a SERVER socket.  It's the moral opposite of
    zio::Message::encode().  What is returned is sequence of message
    parts.
    r   r   zcorrupt ZIO message in sizeÚizcorrupt ZIO message in data)r"   rJ   rS   rX   ÚunpackÚappend)rA   ÚtotrZ   ÚbegÚendÚsizer   r   r   rR   5  s    
rR   ÚFLOWr   c             C   s8   d|| dd… f }||7 }|j ƒ }tjdt|ƒƒ| S )zW
    Return a binary encoded header prefix suitable for use as a
    message part.
    z	ZIO%d%-4sNr   rW   )rN   rX   rY   r"   )Úmformr   r   Zprer   r   r   Úencode_header_prefixL  s    rf   c             C   s^   | dd… dkrdS t | ƒdk r$dS | d tdƒ }| dd… jƒ }| dd… jƒ }|||fS )zô
    Parse the bytes of one encoded message part into a ZIO message
    header prefix.  This is usually the first part of a multipart
    message or as returned by decode().  Returns tuple (level, format,
    label) or None if parse error.
    Nr   s   ZIOr   Ú0r   )r"   Úordr<   )Úhencr   re   r   r   r   r   r&   V  s    r&   c             C   s   t jd| ||ƒS )z‡
    Return a binary encoded header coord suitable for use as a message
    part.  Arguments are taken to be 64 bit unsigned ints.
    ÚLLL)rX   rY   )r3   r4   r5   r   r   r   r7   f  s    r7   c             C   s   t | ƒdkrdS tjd| ƒS )z÷
    Parse the bytes of one encoded message part into a ZIO message
    header coord.  This is ususally the second part of a multipart
    message or as returend by decode().  Returns tuple (origin,
    granule, seqno) or None if parse error.
    é   Nrj   )r"   rX   r^   )ri   r   r   r   r6   n  s    r6   )rd   r   r   )r1   rL   rE   rX   Úcollectionsr   Úenumr   r   Úutilr   r   r2   r8   rQ   rR   rf   r&   r7   r6   r   r   r   r   Ú<module>   s"   9 :

