HEX

File: //opt/saltstack/salt/lib/python3.10/site-packages/zmq/sugar/__pycache__/frame.cpython-310.pyc
o

�N�g�
�@sNdZddlZddlmZddlmZdd�ZGdd	�d	ee�ZeZd	d
gZ	dS)z0MQ Frame pure Python methods.�N)�Frame�)�AttributeSettercCs$tj�||�tjstd|��dS)Nz8libzmq and pyzmq must be built with draft support for %s)�zmq�errorZ_check_versionZ	DRAFT_API�RuntimeError)�vZfeature�r	�C/opt/saltstack/salt/lib/python3.10/site-packages/zmq/sugar/frame.py�_drafts��rc@sLeZdZdZdd�Zedd��Zejdd��Zedd��Zejd	d��Zd
S)ra�Frame(data=None, track=False, copy=None, copy_threshold=zmq.COPY_THRESHOLD)

    A zmq message Frame class for non-copying send/recvs and access to message properties.

    A ``zmq.Frame`` wraps an underlying ``zmq_msg_t``.

    Message *properties* can be accessed by treating a Frame like a dictionary (``frame["User-Id"]``).

    .. versionadded:: 14.4, libzmq 4

        Frames created by ``recv(copy=False)`` can be used to access message properties and attributes,
        such as the CURVE User-Id.

        For example::

            frames = socket.recv_multipart(copy=False)
            user_id = frames[0]["User-Id"]

    This class is used if you want to do non-copying send and recvs.
    When you pass a chunk of bytes to this class, e.g. ``Frame(buf)``, the
    ref-count of `buf` is increased by two: once because the Frame saves `buf` as
    an instance attribute and another because a ZMQ message is created that
    points to the buffer of `buf`. This second ref-count increase makes sure
    that `buf` lives until all messages that use it have been sent.
    Once 0MQ sends all the messages and it doesn't need the buffer of ``buf``,
    0MQ will call ``Py_DECREF(s)``.

    Parameters
    ----------

    data : object, optional
        any object that provides the buffer interface will be used to
        construct the 0MQ message data.
    track : bool [default: False]
        whether a MessageTracker_ should be created to track this object.
        Tracking a message has a cost at creation, because it creates a threadsafe
        Event object.
    copy : bool [default: use copy_threshold]
        Whether to create a copy of the data to pass to libzmq
        or share the memory with libzmq.
        If unspecified, copy_threshold is used.
    copy_threshold: int [default: zmq.COPY_THRESHOLD]
        If copy is unspecified, messages smaller than this many bytes
        will be copied and messages larger than this will be shared with libzmq.
    cCs
|�|�S)N)�get)�self�keyr	r	r
�__getitem__Cs
zFrame.__getitem__cC�tdd�|�d�S)z�The RADIO-DISH group of the message.

        Requires libzmq >= 4.2 and pyzmq built with draft APIs enabled.

        .. versionadded:: 17
        ����
RADIO-DISH�group�rr�r
r	r	r
rG�

zFrame.groupcC�tdd�|�d|�dS)Nrrr�r�set)r
rr	r	r
rR�
cCr)z�The CLIENT-SERVER routing id of the message.

        Requires libzmq >= 4.2 and pyzmq built with draft APIs enabled.

        .. versionadded:: 17
        r�
CLIENT-SERVER�
routing_idrrr	r	r
rWrzFrame.routing_idcCr)Nrrrr)r
rr	r	r
rbrN)	�__name__�
__module__�__qualname__�__doc__r�propertyr�setterrr	r	r	r
rs.




r�Message)
r"rZzmq.backendrZ	FrameBaseZ	attrsettrrrr%�__all__r	r	r	r
�<module>sU