HEX

File: //home/arjun/projects/env/lib64/python3.10/site-packages/redis/__pycache__/client.cpython-310.pyc
o

$we���@s�ddlZddlZddlZddlZddlZddlmZddlmZm	Z	m
Z
mZmZm
Z
mZddlmZddlmZmZmZmZddlmZmZmZmZddlmZmZmZddlm Z dd	l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(dd
l)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0m1Z1m2Z2d
Z3dZ4dZ5Gdd�de6�Z7Gdd�d�Z8Gdd�deee�Z9e9Z:Gdd�d�Z;Gdd�d�Z<Gdd�dej=�Z>Gdd�de9�Z?dS)�N)�chain)�Any�Callable�Dict�List�Optional�Type�Union)�Encoder)�_RedisCallbacks�_RedisCallbacksRESP2�_RedisCallbacksRESP3�bool_ok)�CoreCommands�RedisModuleCommands�SentinelCommands�list_or_args)�ConnectionPool�
SSLConnection�UnixDomainSocketConnection)�CredentialProvider)�ConnectionError�ExecAbortError�PubSubError�
RedisError�
ResponseError�TimeoutError�
WatchError��Lock)�Retry)�HIREDIS_AVAILABLE�_set_info_logger�get_lib_version�safe_str�str_if_bytes��EMPTY_RESPONSE�NEVER_DECODEcsxeZdZdZdeeefddfdd�Z�fdd�Z�fd	d
�Z�fdd�Z	d�fd
d�	Z
�fdd�Z�fdd�Z�Z
S)�CaseInsensitiveDictz?Case insensitive dict implementation. Assumes string keys only.�data�returnNcCs"|��D]
\}}|||��<qdS�N)�items�upper)�selfr*�k�v�r2�E/home/arjun/projects/env/lib/python3.10/site-packages/redis/client.py�__init__5s�zCaseInsensitiveDict.__init__c�t��|���Sr,)�super�__contains__r.�r/r0��	__class__r2r3r79�z CaseInsensitiveDict.__contains__cst��|���dSr,)r6�__delitem__r.r8r9r2r3r<<szCaseInsensitiveDict.__delitem__cr5r,)r6�__getitem__r.r8r9r2r3r=?r;zCaseInsensitiveDict.__getitem__cst��|��|�Sr,)r6�getr.)r/r0�defaultr9r2r3r>BszCaseInsensitiveDict.getcst��|��|�dSr,)r6�__setitem__r.)r/r0r1r9r2r3r@EszCaseInsensitiveDict.__setitem__cst|�}t��|�dSr,)r)r6�update�r/r*r9r2r3rAHszCaseInsensitiveDict.updater,)�__name__�
__module__�__qualname__�__doc__r�strr4r7r<r=r>r@rA�
__classcell__r2r2r9r3r)2sr)c@seZdZdS)�
AbstractRedisN)rCrDrEr2r2r2r3rIMsrIc)@s�eZdZdZededdfdd��Zededdeddfd	d
��Z	ddd
dddddddddddddddddddddddddddddd
dde
�dddddf)deedee
ddfdd�Zdefdd�ZdRdd�Zdefdd�Zdedfd d!�ZdSd#d$�Zd%ed&eddfd'd(�ZdTd)d*�ZdUdVd-d.�Zd/ed,gdfddfd0d1�Z		2	+			+dWd3ed4eed5ed6ed7eed8edefd9efd:d;�Zd<d=�Zd>d?�Z d@dA�Z!dBdC�Z"dDdE�Z#dFdG�Z$dHdI�Z%dJdK�Z&dLdM�Z'dNdO�Z(dPdQ�Z)dS)X�Redisa�
    Implementation of the Redis protocol.

    This abstract class provides a Python interface to all Redis commands
    and an implementation of the Redis protocol.

    Pipelines derive from this, implementing how
    the commands are sent and received to the Redis server. Based on
    configuration, an instance will either use a ConnectionPool, or
    Connection object to talk to redis.

    It is not safe to pass PubSub or Pipeline objects between threads.
    �urlr+NcKs4|�dd�}tj|fi|��}|||d�}d|_|S)a
        Return a Redis client object configured from the given URL

        For example::

            redis://[[username]:[password]]@localhost:6379/0
            rediss://[[username]:[password]]@localhost:6379/0
            unix://[username@]/path/to/socket.sock?db=0[&password=password]

        Three URL schemes are supported:

        - `redis://` creates a TCP socket connection. See more at:
          <https://www.iana.org/assignments/uri-schemes/prov/redis>
        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
        - ``unix://``: creates a Unix Domain Socket connection.

        The username, password, hostname, path and all querystring values
        are passed through urllib.parse.unquote in order to replace any
        percent-encoded values with their corresponding characters.

        There are several ways to specify a database number. The first value
        found will be used:

            1. A ``db`` querystring option, e.g. redis://localhost?db=0
            2. If using the redis:// or rediss:// schemes, the path argument
               of the url, e.g. redis://localhost/0
            3. A ``db`` keyword argument to this function.

        If none of these options are specified, the default db=0 is used.

        All querystring options are cast to their appropriate Python types.
        Boolean arguments can be specified with string values "True"/"False"
        or "Yes"/"No". Values that cannot be properly cast cause a
        ``ValueError`` to be raised. Once parsed, the querystring arguments
        and keyword arguments are passed to the ``ConnectionPool``'s
        class initializer. In the case of conflicting arguments, querystring
        arguments always win.

        �single_connection_clientF��connection_poolrLT)�popr�from_url�auto_close_connection_pool)�clsrK�kwargsrLrN�clientr2r2r3rP`s*�zRedis.from_urlrRrNcCs||d�}d|_|S)z�
        Return a Redis client from the given connection pool.
        The Redis client will take ownership of the connection pool and
        close it when the Redis client is closed.
        )rNT)rQ)rRrNrTr2r2r3�	from_pool�s

�zRedis.from_pool�	localhosti�rzutf-8�strictF�requiredzredis-py��credential_provider�protocolc*+Cs�|	s�|
durt�td��|
}|durt�td��|}|s g}|dur)|�t�id|�d|%�d|�d|�d	|�d
|�d|�d|�d
t�|&��d|�d|!�d|"�d|#�d|$�d|'�d|(�d|)�}*|
durn|*�|
td��n |*�|||||d��|r�|*�t	||||||||||||d�
�t
di|*��}	d|_nd|_|	|_d|_
| r�|j�d�|_
tt�|_|jj�d�dvr�|j�t�dS|j�t�dS)a�
        Initialize a new Redis client.
        To specify a retry policy for specific errors, first set
        `retry_on_error` to a list of the error/s to retry on, then set
        `retry` to a valid `Retry` object.
        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.

        Args:

        single_connection_client:
            if `True`, connection pool is not used. In that case `Redis`
            instance use is not thread safe.
        Nz/"charset" is deprecated. Use "encoding" insteadz5"errors" is deprecated. Use "encoding_errors" insteadT�db�username�password�socket_timeout�encoding�encoding_errors�decode_responses�retry_on_error�retry�max_connections�health_check_interval�client_name�lib_name�lib_version�redis_connect_funcrZr[)�path�connection_class)�host�port�socket_connect_timeout�socket_keepalive�socket_keepalive_options)
rl�ssl_keyfile�ssl_certfile�
ssl_cert_reqs�ssl_ca_certs�ssl_ca_data�ssl_check_hostname�ssl_password�ssl_ca_path�ssl_validate_ocsp_stapled�ssl_validate_ocsp�ssl_ocsp_context�ssl_ocsp_expected_certF�_)�3�r2)�warnings�warn�DeprecationWarning�appendr�copy�deepcopyrArrrrQrN�
connection�get_connectionr)r�response_callbacks�connection_kwargsr>r
r)+r/rmrnr\r^r_rorprqrN�unix_socket_pathr`ra�charset�errorsrb�retry_on_timeoutrc�sslrrrsrtruryrvrwrxr{rzr|r}rerLrfrgrhrir]rdrjrZr[rSr2r2r3r4�s�9����
��������
	�
���
���������
��
zRedis.__init__cCst|�j�dt|j��d�S)N�<�>)�typerC�reprrN�r/r2r2r3�__repr__9szRedis.__repr__r
cC�
|j��S)z!Get the connection pool's encoder)rN�get_encoderr�r2r2r3r�<s
zRedis.get_encodercCs|jjS)z'Get the connection's key-word arguments)rNr�r�r2r2r3�get_connection_kwargs@szRedis.get_connection_kwargsr cCs|���d�S�Nrd)r�r>r�r2r2r3�	get_retryDszRedis.get_retryrdcCs"|���d|i�|j�|�dSr�)r�rArN�	set_retry)r/rdr2r2r3r�GszRedis.set_retry�command�callbackcCs||j|<dS)zSet a custom Response CallbackN)r�)r/r�r�r2r2r3�set_response_callbackKszRedis.set_response_callbackcCst|||�dS)a
        This function can be used to add externally defined redis modules,
        and their namespaces to the redis client.

        funcname - A string containing the name of the function to create
        func - The function, being added to this class.

        ex: Assume that one has a custom redis module named foomod that
        creates command named 'foo.dothing' and 'foo.anotherthing' in redis.
        To load function functions into this namespace:

        from redis import Redis
        from foomodule import F
        r = Redis()
        r.load_external_module("foo", F)
        r.foo().dothing('your', 'arguments')

        For a concrete example see the reimport of the redisjson module in
        tests/test_connection.py::test_loading_external_modules
        N)�setattr)r/�funcname�funcr2r2r3�load_external_moduleOszRedis.load_external_moduleT�PipelinecCst|j|j||�S)a_
        Return a new pipeline object that can queue multiple commands for
        later execution. ``transaction`` indicates whether all commands
        should be executed atomically. Apart from making a group of operations
        atomic, pipelines are useful for reducing the back-and-forth overhead
        between the client and server.
        )r�rNr�)r/�transaction�
shard_hintr2r2r3�pipelinefs�zRedis.pipeliner�c
	Os�|�dd�}|�dd�}|�dd�}|�d|��6}	z|r"|j|�||�}|��}	|r.|n|	WWd�StyM|durK|dkrKt�|�Yqw1sQwYdS)z�
        Convenience method for executing the callable `func` as a transaction
        while watching all keys specified in `watches`. The 'func' callable
        should expect a single argument which is a Pipeline object.
        r�N�value_from_callableF�watch_delayTr)rOr��watch�executer�time�sleep)
r/r��watchesrSr�r�r��pipe�
func_value�
exec_valuer2r2r3r�rs$
�
��zRedis.transaction皙�����?�name�timeoutr��blocking�blocking_timeout�
lock_class�thread_localc	Cs"|durt}||||||||d�S)aL
        Return a new Lock object using key ``name`` that mimics
        the behavior of threading.Lock.

        If specified, ``timeout`` indicates a maximum life for the lock.
        By default, it will remain locked until release() is called.

        ``sleep`` indicates the amount of time to sleep per loop iteration
        when the lock is in blocking mode and another client is currently
        holding the lock.

        ``blocking`` indicates whether calling ``acquire`` should block until
        the lock has been acquired or to fail immediately, causing ``acquire``
        to return False and the lock not being acquired. Defaults to True.
        Note this value can be overridden by passing a ``blocking``
        argument to ``acquire``.

        ``blocking_timeout`` indicates the maximum amount of time in seconds to
        spend trying to acquire the lock. A value of ``None`` indicates
        continue trying forever. ``blocking_timeout`` can be specified as a
        float or integer, both representing the number of seconds to wait.

        ``lock_class`` forces the specified lock implementation. Note that as
        of redis-py 3.0, the only lock class we implement is ``Lock`` (which is
        a Lua-based lock). So, it's unlikely you'll need this parameter, unless
        you have created your own custom lock class.

        ``thread_local`` indicates whether the lock token is placed in
        thread-local storage. By default, the token is placed in thread local
        storage so that a thread only sees its token, not a token set by
        another thread. Consider the following timeline:

            time: 0, thread-1 acquires `my-lock`, with a timeout of 5 seconds.
                     thread-1 sets the token to "abc"
            time: 1, thread-2 blocks trying to acquire `my-lock` using the
                     Lock instance.
            time: 5, thread-1 has not yet completed. redis expires the lock
                     key.
            time: 5, thread-2 acquired `my-lock` now that it's available.
                     thread-2 sets the token to "xyz"
            time: 6, thread-1 finishes its work and calls release(). if the
                     token is *not* stored in thread local storage, then
                     thread-1 would see the token value as "xyz" and would be
                     able to successfully release the thread-2's lock.

        In some use cases it's necessary to disable thread local storage. For
        example, if you have code where one thread acquires a lock and passes
        that lock instance to a worker thread to release later. If thread
        local storage isn't disabled in this case, the worker thread won't see
        the token set by the thread that acquired the lock. Our assumption
        is that these cases aren't common and as such default to using
        thread local storage.N)r�r�r�r�r�r)r/r�r�r�r�r�r�r�r2r2r3�lock�s>�z
Redis.lockcKst|jfi|��S)z�
        Return a Publish/Subscribe object. With this object, you can
        subscribe to channels and listen for messages that get published to
        them.
        )�PubSubrN)r/rSr2r2r3�pubsub�szRedis.pubsubcC�
t|j�Sr,)�MonitorrNr�r2r2r3�monitor��
z
Redis.monitorcCs|j|jdd�S)NTrM)r:rNr�r2r2r3rT�s�zRedis.clientcC�|Sr,r2r�r2r2r3�	__enter__��zRedis.__enter__cC�|��dSr,��close�r/�exc_type�	exc_value�	tracebackr2r2r3�__exit__��zRedis.__exit__cCr�r,r�r�r2r2r3�__del__�r�z
Redis.__del__cCsBt|d�sdS|j}|rd|_|j�|�|jr|j��dSdS)Nr�)�hasattrr�rN�releaserQ�
disconnect�r/�connr2r2r3r��s
�zRedis.closecOs|j|�|j||fi|��S)z7
        Send a command and parse the response
        )�send_command�parse_response)r/r��command_name�args�optionsr2r2r3�_send_command_parse_response�s
z"Redis._send_command_parse_responsecCs.|��|jdust|t|j��dur|�dS)z�
        Close the connection and raise an exception
        if retry_on_error is not set or the error
        is not one of the specified error types
        NF)r�rc�
isinstance�tuple�r/r��errorr2r2r3�_disconnect_raises

�zRedis._disconnect_raisec	sx�j}�d��jp|j�fi����z�j������fdd���fdd��W�js1|���SS�js;|���ww)z.Execute a command and return a parsed responserc��j��g��Ri���Sr,�r�r2�r�r�r�r�r/r2r3�<lambda>����z'Redis.execute_command.<locals>.<lambda>c����|�Sr,)r��r��r�r/r2r3r��)rNr�r�rd�call_with_retryr�)r/r�r��poolr2r�r3�execute_commands���zRedis.execute_commandcKs�zt|vr|jdd�}|�t�n|��}Wnty(t|vr'|tYS�wt|vr2|�t�||jvrB|j||fi|��S|S)z'Parses a response from the Redis serverT)�disable_decoding)r(�
read_responserOrr'r�)r/r�r�r��responser2r2r3r�"s ��

zRedis.parse_response)r+r
)rdr r+N�r+N)TN�r+r�)Nr�TNNT)*rCrDrErF�classmethodrGrPrrrUr#rr�intr4r�r�rr�r�r�rr�r�r�r��float�boolr	rr�r�r�rTr�r�r�r�r�r�r�r�r2r2r2r3rJQs�2����)�*�+
�


�
�������
�
�JrJc@sLeZdZdZe�d�Ze�d�Zdd�Zdd�Z	dd	�Z
d
d�Zdd
�ZdS)r�z�
    Monitor is useful for handling the MONITOR command to the redis server.
    next_command() method returns one command from monitor
    listen() method yields commands from monitor.
    z\[(\d+) (.*?)\] (.*)z"(.*?)(?<!\\)"cCs||_|j�d�|_dS)N�MONITOR)rNr�r�)r/rNr2r2r3r4DszMonitor.__init__cCs0|j�d�|j��}t|�std|����|S)Nr�zMONITOR failed: )r�r�r�rr�r/r�r2r2r3r�Hs

zMonitor.__enter__cGs|j��|j�|j�dSr,)r�r�rNr�)r/r�r2r2r3r�Ps
zMonitor.__exit__cCs�|j��}t|t�r|jjj|dd�}|�dd�\}}|j�|�}|�	�\}}}d�
|j�|��}|�
dd�}|dkrBd}d}	d}
n|�d	�rRd	}|d
d�}	d	}
n
|�dd�\}}	d
}
t|�t|�||	|
|d�S)z)Parse the response from a monitor commandT��force� �z\"�"�lua��unix�N�:�tcp)r�r\�client_address�client_port�client_typer�)r�r�r��bytes�encoder�decode�split�
monitor_re�match�groups�join�
command_re�findall�replace�
startswith�rsplitr�r�)r/r��command_time�command_data�m�db_id�client_infor�r�r�rr2r2r3�next_commandTs2


�zMonitor.next_commandccs�	|��Vq)z)Listen for commands coming to the server.)rr�r2r2r3�listenws�
�zMonitor.listenN)
rCrDrErF�re�compilerr	r4r�r�rrr2r2r2r3r�:s

#r�c@s�eZdZdZdZdZdZ				dLdeded	d
e	de
egdfffdd�ZdMdd�Z
dNdd�ZdNdd�ZdNdd�ZdNdd�ZdNdd�Zed
efdd��Zdd�ZdNdd�ZdNd d!�Zd"d#�ZdOd&d'�Zd
efd(d)�ZdNd*d+�Zd
efd,d-�Zd.d/�Zd0d1�Zd2d3�Z d4d5�Z!dd6�d7d8�Z"dd6�d9d:�Z#d;d<�Z$	=dPded>e%fd?d@�Z&e&Z'dQdAe	edfd
efdBdC�Z(dRdDdE�Z)	%		dSdFe*dGedHee
d
dIfdJdK�Z+dS)Tr�a*
    PubSub provides publish, subscribe and listen support to Redis channels.

    After subscribing to one or more channels, the listen() method will block
    until a message arrives on one of the subscribed channels. That message
    will be returned and it's safe to start listening again.
    )�message�pmessage�smessage)�unsubscribe�punsubscribe�sunsubscribezredis-py-health-checkNF�ignore_subscribe_messagesrr
�push_handler_funccCs�||_||_||_d|_t��|_||_||_|jdur"|j�	�|_|j�
|j�|_|jj
r5d|jg|_nd|jg|_|jdurCt�|��dS)N�pong�pong)rNr�rr��	threading�Event�subscribed_eventrrr��encode�HEALTH_CHECK_MESSAGE�health_check_response_brb�health_check_responser"�reset)r/rNr�rrrr2r2r3r4�s 


zPubSub.__init__r+cCr�r,r2r�r2r2r3r��r�zPubSub.__enter__cCr�r,�r(r�r2r2r3r��r�zPubSub.__exit__cC�$z|��WdStyYdSwr,�r(�	Exceptionr�r2r2r3r��s
�zPubSub.__del__cCsp|jr|j��|j�|j�|j�|j�d|_d|_i|_t�|_	i|_
t�|_i|_t�|_
|j��dS)Nr)r�r��_deregister_connect_callback�
on_connectrNr��health_check_response_counter�channels�set�pending_unsubscribe_channels�shard_channels�"pending_unsubscribe_shard_channels�patterns�pending_unsubscribe_patternsr#�clearr�r2r2r3r(�s
zPubSub.resetcCr�r,r)r�r2r2r3r��r�zPubSub.closecs��j���j���j���jr&�fdd��j��D�}�jdi|���jr=�fdd��j��D�}�jdi|���j	rV�fdd��j	��D�}�j
di|��dSdS)zBRe-subscribe to any channels and patterns previously subscribed toc�"i|]
\}}�jj|dd�|�qS�Tr��rr��.0r0r1r�r2r3�
<dictcomp>���z%PubSub.on_connect.<locals>.<dictcomp>cr8r9r:r;r�r2r3r=�r>cr8r9r:r;r�r2r3r=�s��Nr2)r2r7r6r4r0r-�	subscriber5�
psubscriber3�
ssubscribe)r/r�r0r5r3r2r�r3r.�s&



�
�
��zPubSub.on_connectcCr�)z@Indicates if there are subscriptions to any channels or patterns)r#�is_setr�r2r2r3�
subscribed�s
zPubSub.subscribedcGs�|jdur$|j�d|j�|_|j�|j�|jdur$ts$|jj�	|j�|j}d|j
i}|j
s4|��|j||j
g|�Ri|��dS)z#Execute a publish/subscribe commandNr��check_health)r�rNr�r��_register_connect_callbackr.rr!�_parser�set_push_handlerrC�clean_health_check_responses�_executer�)r/r�r�rSr2r2r3r��s
� zPubSub.execute_commandcCs�d}|j}|jdkrB|dkrD|j||j|jd�r3|�||j�}|�|�r,|jd8_ntd�|���|d8}|jdkrF|dksdSdSdSdS)zG
        If any health check responses are present, clean them
        �
r�r�r�z?A non health check response was cleaned by execute_command: {0}N)	r�r/rI�can_readr_r��is_health_check_responser�format)r/�ttlr�r�r2r2r3rH�s
�"�z#PubSub.clean_health_check_responsescCs(|��|jrt|t�s|�|��dS)z�
        Close the connection and raise an exception
        if retry_on_timeout is not set or the error
        is not a TimeoutError. Otherwise, try to reconnect
        N)r�r�r�r�connectr�r2r2r3�_disconnect_raise_connect
sz PubSub._disconnect_raise_connectcs$�j����fdd���fdd��S)aU
        Connect manually upon disconnection. If the Redis server is down,
        this will fail and raise a ConnectionError as desired.
        After reconnection, the ``on_connect`` callback should have been
        called by the # connection to resubscribe us to any channels and
        patterns we were previously listening to
        cs��i���Sr,r2r2)r�r�rSr2r3r�!sz!PubSub._execute.<locals>.<lambda>cr�r,)rQr�r�r2r3r�"r�)rdr�)r/r�r�r�rSr2)r�r�r�rSr/r3rIs�zPubSub._executeTrcsZ|j��durtd��|�����fdd�}|��|�}|�|�r+|jd8_dS|S)z3Parse the response from a publish/subscribe commandN�Npubsub connection not set: did you forget to call subscribe() or psubscribe()?cs,�s�j�d�s
dSn����jddd�S)NrKFT)�disconnect_on_error�push_request)rLrPr�r2��blockr�r�r2r3�try_read0s�z'PubSub.parse_response.<locals>.try_readr�)r��RuntimeErrorrDrIrMr/)r/rVr�rWr�r2rUr3r�%s�
zPubSub.parse_responsecCs||j|jfvS)z�
        Check if the response is a health check response.
        If there are no subscriptions redis responds to PING command with a
        bulk response, instead of a multi-bulk with "pong" and the response.
        )r'r&r�r2r2r3rM@s�zPubSub.is_health_check_responsecCsV|j}|durtd��|jr't��|jkr)|jd|jdd�|jd7_dSdSdS)NrR�PINGF)rDr�)r�rXrfr��next_health_checkr�r%r/r�r2r2r3rDKs��zPubSub.check_healthcs(|jj�|jj���fdd�|��D�S)z�
        normalize channel/pattern names to be either bytes or strings
        based on whether responses are automatically decoded. this saves us
        from coercing the value for each message coming in.
        csi|]\}}��|��|�qSr2r2r;�rr$r2r3r=_sz*PubSub._normalize_keys.<locals>.<dictcomp>)rr$rr-rBr2r[r3�_normalize_keysWszPubSub._normalize_keyscO�|r
t|d|dd��}t�|�}|�|�|jdg|���R�}|�|�}|j�|�|js8|j	�
�d|_|j�
|�|S)aE
        Subscribe to channel patterns. Patterns supplied as keyword arguments
        expect a pattern name as the key and a callable as the value. A
        pattern's callable will be invoked automatically when a message is
        received on that pattern rather than producing a message via
        ``listen()``.
        rr�N�
PSUBSCRIBE)r�dict�fromkeysrAr��keysr\r5rCr#r1r/r6�difference_update)r/r�rS�new_patterns�ret_valr2r2r3r@a�



zPubSub.psubscribecG�P|rt|d|dd��}|�t�|��}n|j}|j�|�|jdg|�R�S)zj
        Unsubscribe from the supplied patterns. If empty, unsubscribe from
        all patterns.
        rr�N�PUNSUBSCRIBE)rr\r_r`r5r6rAr�)r/r�r5r2r2r3r{�zPubSub.punsubscribecOr])aR
        Subscribe to channels. Channels supplied as keyword arguments expect
        a channel name as the key and a callable as the value. A channel's
        callable will be invoked automatically when a message is received on
        that channel rather than producing a message via ``listen()`` or
        ``get_message()``.
        rr�N�	SUBSCRIBE)rr_r`rAr�rar\r0rCr#r1r/r2rb)r/r�rS�new_channelsrdr2r2r3r?�rezPubSub.subscribecGrf)zi
        Unsubscribe from the supplied channels. If empty, unsubscribe from
        all channels
        rr�N�UNSUBSCRIBE)rr\r_r`r0r2rAr�)r/r�r0r2r2r3r�rhzPubSub.unsubscribe)�target_nodecOs�|r
t|d|dd��}t�|�}|�|�|jdg|���R�}|�|�}|j�|�|js8|j	�
�d|_|j�
|�|S)az
        Subscribes the client to the specified shard channels.
        Channels supplied as keyword arguments expect a channel name as the key
        and a callable as the value. A channel's callable will be invoked automatically
        when a message is received on that channel rather than producing a message via
        ``listen()`` or ``get_sharded_message()``.
        rr�N�
SSUBSCRIBE)rr_r`rAr�rar\r3rCr#r1r/r4rb)r/rlr�rS�new_s_channelsrdr2r2r3rA�rezPubSub.ssubscribecGsP|rt|d|dd��}|�t�|��}n|j}|j�|�|jdg|�R�S)zu
        Unsubscribe from the supplied shard_channels. If empty, unsubscribe from
        all shard_channels
        rr�N�SUNSUBSCRIBE)rr\r_r`r3r4rAr�)r/rlr��
s_channelsr2r2r3r�rhzPubSub.sunsubscribeccs6�|jr|�|jdd��}|dur|V|jsdSdS)zBListen for messages on channels this client has been subscribed toT)rVN)rC�handle_messager�r�r2r2r3r�s��z
PubSub.listen�r�cCsd|jst��}|j�|�durt��|}td||�}ndS|j|du|d�}|r0|�||�SdS)a
        Get the next message if one is available, otherwise None.

        If timeout is specified, the system will wait for `timeout` seconds
        before returning. Timeout should be specified as a floating point
        number, or None, to wait indefinitely.
        TrrN)rVr�)rCr�r#�wait�maxr�rq)r/rr��
start_time�
time_spentr�r2r2r3�get_message�s
zPubSub.get_messagercCs |durd|gndg}|j|�S)z'
        Ping the Redis server
        NrY�r�)r/rr�r2r2r3�ping�s
zPubSub.pingc	Cs�|durdSt|t�r|dkrd|gnddg}t|d�}|dkr/||d|d|d	d
�}n|dkr=|dd|dd
�}n|d|d|dd
�}||jvr�|dkrh|d}||jvrg|j�|�|j�|d�n1|d
kr�|d}||jvr�|j�|�|j	�|d�n|d}||j
vr�|j
�|�|j�|d�|js�|js�|j	s�|j�
�||jvr�|dkr�|j�|dd�}n|dkr�|j	�|dd�}n	|j�|dd�}|r�||�dS|S|dkr�|s�|jr�dS|S)z�
        Parses a pub/sub message. If the channel or pattern was subscribed to
        with a message handler, the handler is invoked instead of a parsed
        message being returned.
        NsPONGr r&rrr�rYr�)r��pattern�channelr*rrrrzrr{)r�rr%�UNSUBSCRIBE_MESSAGE_TYPESr6�remover5rOr4r3r2r0r#r7�PUBLISH_MESSAGE_TYPESr>r)	r/r�r�message_typerrz�	s_channelr{�handlerr2r2r3rqsn
���

�
�


�
zPubSub.handle_message�
sleep_time�daemon�exception_handler�PubSubWorkerThreadc	Cs�|j��D]\}}|durtd|�d���q|j��D]\}}|dur+td|�d���q|j��D]\}}|durAtd|�d���q1t||||d�}|��|S)Nz
Channel: 'z' has no handler registeredz
Pattern: 'zShard Channel: ')r�r�)r0r-rr5r3r��start)	r/r�r�r�r{r�rzr��threadr2r2r3�
run_in_threadMs&��
���zPubSub.run_in_thread)NFNN)r+r�r�)Tr)Frrr,)F)rFN),rCrDrErFr~r|r%r�rr	rrGr4r�r�r�r(r�r.�propertyrCr�rHrQrIr�rMrDrr\r@rr?rrArrr�rw�get_sharded_messageryrqr�r�r2r2r2r3r�}sx���
�



	










��
�
L�����r�csZeZdZ		ddededeeeddgdfdff�fdd�
Zdd
d�Z	ddd
�Z
�ZS)r�FNr�r�r�r�cs0t���||_||_||_||_t��|_dSr,)	r6r4r�r�r�r�r!r"�_running)r/r�r�r�r�r9r2r3r4gs
	zPubSubWorkerThread.__init__r+c
Cs�|j��rdS|j��|j}|j}|j��rEz	|jd|d�Wnty?}z|jdur.�|�|||�WYd}~nd}~ww|j��s|��dS)NT)rr�)	r�rBr1r�r�rw�
BaseExceptionr�r�)r/r�r��er2r2r3�runws 



��
�zPubSubWorkerThread.runcCs|j��dSr,)r�r7r�r2r2r3�stop�szPubSubWorkerThread.stop)FNr�)rCrDrEr�r�r	rr,r4r�r�rHr2r2r9r3r�fs�����
r�c@seZdZdZhd�Zdd�Zd8dd�Zdd	�Zd
d�Zde	fdd
�Z
defdd�Zd9dd�Z
d9dd�Zd9dd�Zdd�Zd9dd�Zdd�Zd8dd�Zdefdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+ed,eddfd-d.�Zd:d0d1�Zd2d3�Zd4d5�Z defd6d7�Z!dS);r�a_
    Pipelines provide a way to transmit multiple commands to the Redis server
    in one transmission.  This is convenient for batch processing, such as
    saving all the values in a list to Redis.

    All commands executed within a pipeline are wrapped with MULTI and EXEC
    calls. This guarantees all commands executed in the pipeline will be
    executed atomically.

    Any command raising an exception does *not* halt the execution of
    subsequent commands in the pipeline. Instead, the exception is caught
    and its instance is placed into the response list returned by execute().
    Code iterating over the response list should be able to deal with an
    instance of an exception as a potential value. In general, these will be
    ResponseError exceptions, such as those raised when issuing a command
    on a key of a different datatype.
    >�EXEC�DISCARD�UNWATCHcCs0||_d|_||_||_||_d|_|��dS)NF)rNr�r�r�r��watchingr()r/rNr�r�r�r2r2r3r4�szPipeline.__init__r+cCr�r,r2r�r2r2r3r��r�zPipeline.__enter__cCr�r,r)r�r2r2r3r��r�zPipeline.__exit__cCr*r,r+r�r2r2r3r��s
�zPipeline.__del__cCr�r,)�len�
command_stackr�r2r2r3�__len__�r�zPipeline.__len__cCsdS)z1Pipeline instances should always evaluate to TrueTr2r�r2r2r3�__bool__�szPipeline.__bool__NcCs�g|_t�|_|jr)|jr)z
|j�d�|j��Wnty(|j��Ynwd|_d|_	|jr>|j
�|j�d|_dSdS)Nr�F)r�r1�scriptsr�r�r�r�rr��explicit_transactionrNr�r�r2r2r3r(�s�
�zPipeline.resetcCs|��dS)zClose the pipelineNr)r�r2r2r3r��szPipeline.closecCs&|jrtd��|jrtd��d|_dS)z�
        Start a transactional block of the pipeline after WATCH commands
        are issued. End the transactional block with `execute`.
        z"Cannot issue nested calls to MULTIz:Commands without an initial WATCH have already been issuedTN)r�rr�r�r2r2r3�multi�s�
zPipeline.multicOs8|js	|ddkr|js|j|i|��S|j|i|��S)Nr�WATCH)r�r��immediate_execute_command�pipeline_execute_command)r/r�rSr2r2r3r��szPipeline.execute_commandcCs<|��|jr|��td��|jrt|t�s|���dS)z�
        Close the connection, reset watching state and
        raise an exception if we were watching,
        retry_on_timeout is not set,
        or the error is not a TimeoutError
        �=A ConnectionError occurred on while watching one or more keysN)r�r�r(rr�r�rr�r2r2r3�_disconnect_reset_raise�s��z Pipeline._disconnect_reset_raisecsP�d��j��s�j���j����_�j������fdd���fdd��S)z�
        Execute a command immediately, but don't auto-retry on a
        ConnectionError if we're already WATCHing a variable. Used when
        issuing WATCH or subsequent commands retrieving their values but before
        MULTI is called.
        rcr�r,r�r2r�r2r3r�r�z4Pipeline.immediate_execute_command.<locals>.<lambda>cr�r,)r�r�r�r2r3r�r�)r�rNr�r�rdr��r/r�r�r2r�r3r�s�z"Pipeline.immediate_execute_commandcOs|j�||f�|S)ar
        Stage a command to be executed when execute() is next called

        Returns the current Pipeline object back so commands can be
        chained together, such as:

        pipe = pipe.set('foo', 'bar').incr('baz').decr('bang')

        At some other point, you can then run: pipe.execute(),
        which will execute all commands queued in the pipe.
        )r�r�r�r2r2r3r�sz!Pipeline.pipeline_execute_commandcCstdifg|difg�}|�dd�|D��}|�|�g}z|�|d�Wnty>}z
|�d|f�WYd}~nd}~wwt|�D]B\}}	t|	dvrY|�||	dtf�qCz|�|d�WqCty�}z|�||d|	d�|�||f�WYd}~qCd}~wwz|�|d�}
Wnt	y�|r�|dd��wd|_
|
dur�td	��|D]
\}}|
�||�q�t
|
�t
|�kr�|j��td
��|r�|�||
�g}t|
|�D]&\}}
t|t�s�|
\}}|d}||jvr�|j||fi|��}|�|�q�|S)N)�MULTI)r�cSsg|]
\}}t|vr|�qSr2)r')r<r�r�r2r2r3�
<listcomp>)sz1Pipeline._execute_transaction.<locals>.<listcomp>r~rr�FzWatched variable changed.z6Wrong number of response items from pipeline execution)r�
pack_commands�send_packed_commandr�rr��	enumerater'�annotate_exceptionrr�r�insertr�r�r��raise_first_error�zipr�r,r�)r/r��commands�raise_on_error�cmds�all_cmdsr�r��ir�r�r*�r�cmdr�r�r�r2r2r3�_execute_transaction&sd�
�����
�

zPipeline._execute_transactionc	Cs�|�dd�|D��}|�|�g}|D],\}}z|�|j||dfi|���Wqty?}z|�|�WYd}~qd}~ww|rH|�||�|S)NcSsg|]\}}|�qSr2r2)r<r�r~r2r2r3r�ksz.Pipeline._execute_pipeline.<locals>.<listcomp>r)r�r�r�r�rr�)	r/r�r�r�r�r�r�r�r�r2r2r3�_execute_pipelineis
"��zPipeline._execute_pipelinecCs>t|�D]\}}t|t�r|�||d||d�|�qdS)Nr�r)r�r�rr�)r/r�r�r�r�r2r2r3r�ys
��zPipeline.raise_first_errorcCsFd�tt|��}d|�d|�d|jd��}|f|jdd�|_dS)Nr�z
Command # z (z) of pipeline caused error: rr�)r�mapr$r�)r/�	exception�numberr�r��msgr2r2r3r�s��zPipeline.annotate_exceptioncKs<tj|||fi|��}||jvrd|_|S|dkrd|_|S)NFr�T)rJr��UNWATCH_COMMANDSr�)r/r�r�r��resultr2r2r3r��s
�zPipeline.parse_responsecCsdt|j�}|j}dd�|D�}|dg|�R�}t|�s.t||�D]\}}|s-|d|j�|_q dSdS)NcSsg|]}|j�qSr2)�sha)r<�sr2r2r3r��sz)Pipeline.load_scripts.<locals>.<listcomp>z
SCRIPT EXISTSzSCRIPT LOAD)�listr�r��allr��scriptr�)r/r��	immediate�shas�existsr��existr2r2r3�load_scripts�s
��zPipeline.load_scriptsr�r�cCs:|��|jrtd��t|jvrt|t�s|��|�dS)z�
        Close the connection, raise an exception if we were watching,
        and raise an exception if TimeoutError is not part of retry_on_error,
        or the error is not a TimeoutError
        r�N)r�r�rrrcr�r(r�r2r2r3�_disconnect_raise_reset�s��z Pipeline._disconnect_raise_resetTcs��j��s
�js
gS�jr����js�jr�j�n�j��j��s.�j	�
d�j����_z�j�
����fdd���fdd��W���S���w)z0Execute all the commands in the current pipeliner�cs�����Sr,r2r2)r�r�r��stackr2r3r��r�z"Pipeline.execute.<locals>.<lambda>cr�r,)r�r�r�r2r3r��r�)r�r�r�r�r�r�r�r�r�rNr�r�rdr�r()r/r�r2)r�r�r�r/r�r3r��s$
�zPipeline.executecCs|�d�dS)zg
        Flushes all previously queued commands
        See: https://redis.io/commands/DISCARD
        r�Nrxr�r2r2r3�discard�szPipeline.discardcGs |jrtd��|jdg|�R�S)z$Watches the values at keys ``names``z"Cannot issue a WATCH after a MULTIr�)r�rr�)r/�namesr2r2r3r��szPipeline.watchcCs|jr|�d�p	dS)z'Unwatches all previously specified keysr�T)r�r�r�r2r2r3�unwatch�szPipeline.unwatchr�r�)T)"rCrDrErFr�r4r�r�r�r�r�r�r�r(r�r�r�r�r�r�rr�r�r�r�r�r�rJr,r�r�r�r�r�r2r2r2r3r��s6






C
r�)@r�rr!r�r��	itertoolsr�typingrrrrrrr	�redis._parsers.encodersr
�redis._parsers.helpersrrr
r�redis.commandsrrrr�redis.connectionrrr�redis.credentialsr�redis.exceptionsrrrrrrr�
redis.lockr�redis.retryr �redis.utilsr!r"r#r$r%�	SYM_EMPTYr'r(r_r)rIrJ�StrictRedisr�r��Threadr�r�r2r2r2r3�<module>sB$$	iCl'