
    +h\              
       Z   U d dl Z d dl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mZmZ d dlmZ d dlmZmZmZmZmZmZ d dlmZmZmZ dd	lmZmZmZmZ dd
l m!Z! ddl"m#Z#m$Z$ ddl%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6 e2rd dl7Z7dZ8dZ9dZ:dZ;dZ< e=       Z>eeeeef      e?d<   e2reZ@neZ@ G d d      ZA G d d      ZB G d d      ZC G d deC      ZD G d deD      ZE G d d eC      ZFd!ZGd" ZHeIeJeJeHeHeKeIeIeHd#	ZLd$ ZM G d% d&      ZN G d' d(eN      ZOy))    N)abstractmethod)chain)EmptyFull	LifoQueue)time)AnyCallableListOptionalTypeUnion)parse_qsunquoteurlparse   )Encoder_HiredisParser_RESP2Parser_RESP3Parser)	NoBackoff)CredentialProvider"UsernamePasswordCredentialProvider)AuthenticationError$AuthenticationWrongNumberOfArgsErrorChildDeadlockedErrorConnectionError	DataError
RedisErrorResponseErrorTimeoutError)Retry)CRYPTOGRAPHY_AVAILABLEHIREDIS_AVAILABLEHIREDIS_PACK_AVAILABLESSL_AVAILABLEget_lib_versionstr_if_bytes   *   $s   
       DefaultParserc                       e Zd ZdefdZy)HiredisRespSerializerargsc                    g }t        |d   t              r1t        |d   j                         j	                               |dd z   }n)d|d   v r"t        |d   j	                               |dd z   }	 |j                  t        j                  |             |S # t        $ r3 t        j                         \  }}}t        |      j                  |      w xY w2Pack a series of arguments into the Redis protocolr   r   N    )
isinstancestrtupleencodesplitappendhiredispack_command	TypeErrorsysexc_infor   with_traceback)selfr0   output_value	tracebacks         C/var/www/html/venv/lib/python3.12/site-packages/redis/connection.pypackzHiredisRespSerializer.pack:   s    d1gs#a)//12T!"X=DT!W_a)DH4D	=MM'..t45
 	  	="%,,.AuiE"11)<<	=s   1$B <CN)__name__
__module____qualname__r   rG    r+   rF   r/   r/   9   s    $ r+   r/   c                       e Zd ZddZd Zy)PythonRespSerializerNc                      || _         || _        y N)_buffer_cutoffr8   )rA   buffer_cutoffr8   s      rF   __init__zPythonRespSerializer.__init__L   s    +r+   c           	      n   g }t        |d   t              r1t        |d   j                         j	                               |dd z   }n)d|d   v r"t        |d   j	                               |dd z   }t
        j                  t        t        t        |            j                         t        f      }| j                  }t        | j                  |      D ]  }t        |      }t        |      |kD  s||kD  st        |t              rat
        j                  |t        t        |      j                         t        f      }|j                  |       |j                  |       t        }t
        j                  |t        t        |      j                         t        |t        f      } |j                  |       |S r2   )r5   r6   r7   r8   r9   	SYM_EMPTYjoinSYM_STARlenSYM_CRLFrP   map
memoryview
SYM_DOLLARr:   )rA   r0   rB   buffrQ   arg
arg_lengths          rF   rG   zPythonRespSerializer.packP   si    d1gs#a)//12T!"X=DT!W_a)DH4D~~xSY)>)>)@(KL++t{{D) 	C SJD	M)-c:. ~~:s:'='='?J d#c" ~~"J..0  	!	4 	dr+   returnN)rH   rI   rJ   rR   rG   rK   r+   rF   rM   rM   K   s    +r+   rM   c            *          e Zd ZdZdddddedddedddd e       ddddd	dfd
edee	   dee
   dee
   dede	de	dedededee	   dee	   dee	   dee	   deedf   deeg df      dee   dee   deeg df      f&dZd Zed        Zd  Zd! Zd" Zd# Zd$ Zd% Zed&        Zed'        Zed(        Zd) Zd* Zd+ Zd, Z d- Z!d6d/Z"d0 Z#d7d1Z$	 d8d.dd2d3Z%d4 Z&d5 Z'y)9AbstractConnectionz0Manages communication to and from a Redis serverr   NFutf-8stricti   zredis-pyr,   dbpasswordsocket_timeoutsocket_connect_timeoutretry_on_timeoutencodingencoding_errorsdecode_responsessocket_read_sizehealth_check_intervalclient_namelib_namelib_versionusernameretryredis_connect_funccredential_providerprotocolcommand_packerc                    |s|r|t        d      t        j                         | _        || _        || _        || _        || _        || _        || _	        || _
        || _        ||}|| _        || _        |t        u rg }|r|j                  t                || _        |s|rR|t%        t'               d      | _        nt+        j,                  |      | _        | j(                  j/                  |       nt%        t'               d      | _        || _        d| _        || _        t7        |||	      | _        d| _        || _        | j?                  |
       g | _         d| _!        	 tE        |      }|dk  s|dkD  rtM        d	      || _'        | jQ                  |      | _)        y# tF        $ r	 tH        }Y DtJ        $ r tM        d      w xY w# dk  s|dkD  rtM        d	      || _'        w xY w)
a2  
        Initialize a new Connection.
        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`.
        Nz'username' and 'password' cannot be passed along with 'credential_provider'. Please provide only one of the following arguments: 
1. 'password' and (optional) 'username'
2. 'credential_provider'r   r   ip  zprotocol must be an integerr,      zprotocol must be either 2 or 3)*r   osgetpidpidre   ro   rp   rq   ru   rf   rr   rg   rh   ri   SENTINELr:   r!   retry_on_errorr"   r   rs   copydeepcopyupdate_supported_errorsrn   next_health_checkrt   r   encoder_sock_socket_read_size
set_parser_connect_callbacksrP   intr=   DEFAULT_RESP_VERSION
ValueErrorr   rv   _construct_command_packer_command_packer)rA   re   rf   rg   rh   ri   r~   rj   rk   rl   parser_classrm   rn   ro   rp   rq   rr   rs   rt   ru   rv   rw   ps                          rF   rR   zAbstractConnection.__init__   s   > &9&E+  99;& &#6   ,!)%3"&<# 0X%N!!,/,N}"9;2
 "]]51
JJ..~>y{A.DJ%:"!""4x:JK
!1%"$"
	HA 1uA%&FGGDM#==nM  	%$A 	A!"?@@	A 1uA%&FGGDMs$   !F G.G 0GG G%c           	          dj                  | j                         D cg c]  \  }}| d|  c}}      }| j                  j                   d| dS c c}}w )N,=<>)rU   repr_pieces	__class__rH   )rA   kv	repr_argss       rF   __repr__zAbstractConnection.__repr__   sV    HHT5E5E5GHTQ1QCjHI	..))*!I;a88 Is   A
c                      y rO   rK   rA   s    rF   r   zAbstractConnection.repr_pieces       r+   c                 D    	 | j                          y # t        $ r Y y w xY wrO   )
disconnect	Exceptionr   s    rF   __del__zAbstractConnection.__del__   s#    	OO 		s    	c                 ~    ||S t         r
t               S t        | j                  | j                  j
                        S rO   )r%   r/   rM   rP   r   r8   )rA   packers     rF   r   z,AbstractConnection._construct_command_packer   s6    M#(**'(;(;T\\=P=PQQr+   c                     t        j                  |      }|| j                  vr| j                  j                  |       y y rO   )weakref
WeakMethodr   r:   )rA   callbackwms      rF   _register_connect_callbackz-AbstractConnection._register_connect_callback   s9    )T,,,##**2. -r+   c                     	 | j                   j                  t        j                  |             y # t        $ r Y y w xY wrO   )r   remover   r   r   )rA   r   s     rF   _deregister_connect_callbackz/AbstractConnection._deregister_connect_callback   s8    	##**7+=+=h+GH 		s   .1 	==c                 4     || j                         | _        y)z
        Creates a new instance of parser_class with socket size:
        _socket_read_size and assigns it to the parser for the connection
        :param parser_class: The required parser class
        )rm   N)r   _parser)rA   r   s     rF   r   zAbstractConnection.set_parser   s     $T5K5KLr+   c                 <     j                   ry	  j                  j                   fd fd      }| _         	  j                   j                          n j                           j                  D cg c]  } |       s| c} _         j                  D ]  } |       }|s |         y# t        j                  $ r t        d      t        $ r}t         j                  |            d}~ww xY w# t        $ r  j                           w xY wc c}w )z5Connects to the Redis server if not already connectedNc                  $     j                         S rO   )_connectr   s   rF   <lambda>z,AbstractConnection.connect.<locals>.<lambda>	  s     r+   c                 &    j                  |       S rO   r   )errorrA   s    rF   r   z,AbstractConnection.connect.<locals>.<lambda>	  s    tu7M r+   zTimeout connecting to server)r   rs   call_with_retrysockettimeoutr!   OSErrorr   _error_messagert   
on_connectr   r   r   )rA   sockerefr   s   `    rF   connectzAbstractConnection.connect  s   ::	:::--')MD 

	&&.! ''- 372I2I"S3SU3"S** 	CuH	- ~~ 	?=>> 	:!$"5"5a"899	:  	OO	 #Ts.   "B3 .C; 6DD3&C8C33C8;Dc                      y rO   rK   r   s    rF   r   zAbstractConnection._connect&  r   r+   c                      y rO   rK   r   s    rF   _host_errorzAbstractConnection._host_error*  r   r+   c                      y rO   rK   )rA   	exceptions     rF   r   z!AbstractConnection._error_message.  r   r+   c                    | j                   j                  |        | j                   }d}| j                  s| j                  s| j                  r>| j                  xs  t        | j                  | j                        }|j                         }|r| j                  dvrt        | j                   t              rK| j                  t               |j                  | j                   _        | j                   j                  |        t        |      dk(  rd|d   g} | j                  d| j                  dg|  | j                         }n(|r@ | j                  dg|dd	i 	 | j                         }t#        |      dk7  rt%        d      | j                  dvrt        | j                   t              rK| j                  t               |j                  | j                   _        | j                   j                  |        | j                  d| j                         | j                         }|j'                  d      | j                  k7  r)|j'                  d      | j                  k7  rt)        d      | j*                  rD| j                  dd| j*                         t#        | j                               dk7  rt)        d      	 | j,                  r.| j                  ddd| j,                         | j                          	 | j0                  r.| j                  ddd| j0                         | j                          | j2                  rD| j                  d| j2                         t#        | j                               dk7  rt)        d      yy# t         $ r+ | j                  d|d
   d	       | j                         }Y Iw xY w# t.        $ r Y w xY w# t.        $ r Y w xY w)z=Initialize the connection, authenticate and select a databaseN)r,   2r   defaultr   HELLOAUTHcheck_healthFr   OKzInvalid Username or Passwords   protoprotozInvalid RESP versionCLIENTSETNAMEzError setting client nameSETINFOzLIB-NAMEzLIB-VERSELECTzInvalid Database)r   r   ru   rr   rf   r   get_credentialsrv   r5   r   r   r   EXCEPTION_CLASSESrW   send_commandread_responser   r(   r   getr   ro   rp   r    rq   re   )rA   parser	auth_argscred_providerresponseauth_responses         rF   r   zAbstractConnection.on_connect2  sG   %	##(( T5dmmT]]S  &557I h6$,,5-171I1I.''-9~"&	!5	Dgt}}fIyI))+H
  DfEyEuE5 $ 2 2 4 M*d2)*HII ]](*$,,5-171I1I.''-gt}}5))+HX&$--7LL)T]]:%&<== h	43C3CDD..01T9%&ABB	}}!!(Iz4==Q""$	!!(Iy$BRBRS""$
 77h0D..01T9%&899 : a 8 5
 !!&)B-e!L $ 2 2 45J  		  		s6    N  :N= ;:O 0N:9N:=	O	O		OOc                 D   | j                   j                          | j                  }d| _        |yt        j                         | j
                  k(  r 	 |j                  t        j                         	 |j                          y# t        $ r Y w xY w# t        $ r Y yw xY w)z!Disconnects from the Redis serverN)r   on_disconnectr   rz   r{   r|   shutdownr   	SHUT_RDWRr   close)rA   r0   	conn_socks      rF   r   zAbstractConnection.disconnect  s    ""$JJ	
99;$(("""6#3#34	OO	  
  		s$   B 3B 	BB	BBc                 x    | j                  dd       t        | j                               dk7  rt        d      y)z Send PING, expect PONG in returnPINGFr   PONGz#Bad response from PING health checkN)r   r(   r   r   r   s    rF   
_send_pingzAbstractConnection._send_ping  s<    &u5**,-7!"GHH 8r+   c                 $    | j                          y)z Function to call when PING failsNr   )rA   r   s     rF   _ping_failedzAbstractConnection._ping_failed      r+   c                     | j                   rIt               | j                  kD  r1| j                  j	                  | j
                  | j                         yyy)z3Check the health of the connection with a PING/PONGN)rn   r   r   rs   r   r   r   r   s    rF   r   zAbstractConnection.check_health  sA    %%$&43I3I*IJJ&&t8I8IJ +J%r+   Tc                 N   | j                   s| j                          |r| j                          	 t        |t              r|g}|D ]  }| j                   j                  |        y# t        j                  $ r | j                          t        d      t        $ ro}| j                          t        |j                        dk(  rd|j                  d   }}n|j                  d   }|j                  d   }t        d| d| d      d}~wt        $ r | j                           w xY w)	z2Send an already packed command to the Redis serverzTimeout writing to socketr   UNKNOWNr   Error z while writing to socket. .N)r   r   r   r5   r6   sendallr   r   r   r!   r   rW   r0   r   BaseException)rA   commandr   itemr   errnoerrmsgs          rF   send_packed_commandz&AbstractConnection.send_packed_command  s   zzLLN	'3'") )

""4()~~ 	<OO:;; 	WOO166{a )166!9vq	!F5'1KF8ST"UVV 	
 OO	s   5A& &6D$A*DD$c                 x    | j                   | j                  j                  | |j                  dd             y)z+Pack and send a command to the Redis serverr   Tr   N)r   r   rG   r   )rA   r0   kwargss      rF   r   zAbstractConnection.send_command  s9      %D  %%t,ND9 	! 	
r+   c                    | j                   }|s| j                          | j                         }	 | j                  j	                  |      S # t
        $ r0}| j                          t        d| d|j                         d}~ww xY w)z8Poll the socket to see if there's data that can be read.Error while reading from z: N)	r   r   r   r   can_readr   r   r   r0   )rA   r   r   
host_errorr   s        rF   r   zAbstractConnection.can_read  sy    zzLLN%%'
	V<<((11 	VOO!$=j\AFF8"TUU	Vs   A 	B+A??B)disconnect_on_errorpush_requestc                \   | j                         }	 | j                  dv r$t        s| j                  j	                  ||      }n| j                  j	                  |      }| j                  rt               | j                  z   | _        t!        |t"              r	 ||S # t
        j                  $ r! |r| j                          t        d|       t        $ r2}|r| j                          t        d| d|j                         d}~wt        $ r |r| j                           w xY w# ~w xY w)z0Read the response from a previously sent command)3ry   )disable_decodingr   )r   zTimeout reading from r   z : N)r   rv   r$   r   r   r   r   r   r!   r   r   r0   r   rn   r   r   r5   r    )rA   r   r   r   r   r   r   s          rF   r   z AbstractConnection.read_response  s(    %%'
	}}(1B<<55%5L 6   <<55GW5X& %%%)Vd.H.H%HD"h. 5 ~~ 	E"!!6zlCDD 	"!!+J<3qvvhG   	 #!	 s$   AB D( ;D%-D D%(D+c                 4     | j                   j                  | S )r3   )r   rG   )rA   r0   s     rF   r<   zAbstractConnection.pack_command  s    (t##(($//r+   c                    g }g }d}| j                   }|D ]  } | j                  j                  | D ]  }t        |      }||kD  s||kD  st	        |t
              r*|r$|j                  t        j                  |             d}g }||kD  st	        |t
              r|j                  |       y|j                  |       ||z  }  |r$|j                  t        j                  |             |S )z.Pack multiple commands into the Redis protocolr   )	rP   r   rG   rW   r5   rZ   r:   rT   rU   )	rA   commandsrB   piecesbuffer_lengthrQ   cmdchunkchunklens	            rF   pack_commandsz AbstractConnection.pack_commands  s    ++ 	.C2--22C8 .u:!M1-/!%4innV&<=$%MFm+z%/LMM%(MM%(!X-M!.	.& MM)..01r+   T)r   )F)(rH   rI   rJ   __doc__r}   r-   r'   r   r   r6   floatboolr   r	   r
   r   rR   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r<   r  rK   r+   rF   rb   rb   ~   sC   6 "&*.26!&'!&" %%&%)",%4%6"&"&;?<@"#7;-WNWN 3-WN !	WN
 !)WN WN WN WN WN WN  #WN c]WN 3-WN  c]!WN" 3-#WN$ S$Y%WN& %Xb$h%78'WN( &&89)WN* 3-+WN, !"d(!34-WNr9  R/
M!F      X:t(IK
>
V  , !,\0r+   rb   c                   F     e Zd ZdZ	 	 	 	 	 d fd	Zd Zd Zd Zd Z xZ	S )
Connectionz4Manages TCP communication to and from a Redis serverc                     || _         t        |      | _        || _        |xs i | _        || _        t        |   di | y NrK   )hostr   portsocket_keepalivesocket_keepalive_optionssocket_typesuperrR   )rA   r  r  r  r  r  r   r   s          rF   rR   zConnection.__init__7  sD     	I	 0(@(FB%&"6"r+   c                     d| j                   fd| j                  fd| j                  fg}| j                  r|j	                  d| j                  f       |S )Nr  r  re   ro   )r  r  re   ro   r:   rA   r  s     rF   r   zConnection.repr_piecesG  sM    499%		':T477OLMM=$*:*:;<r+   c                 @   d}t        j                  | j                  | j                  | j                  t         j
                        D ]  }|\  }}}}}d}	 t        j                   |||      }|j                  t         j                  t         j                  d       | j                  rr|j                  t         j                  t         j                  d       | j                  j                         D ]&  \  }	}
|j                  t         j                  |	|
       ( |j                  | j                         |j!                  |       |j                  | j"                         |c S  ||t%        d      # t$        $ r}|}||j'                          Y d}~Qd}~ww xY w)zCreate a TCP socket connectionNr   z)socket.getaddrinfo returned an empty list)r   getaddrinfor  r  r  SOCK_STREAM
setsockoptIPPROTO_TCPTCP_NODELAYr  
SOL_SOCKETSO_KEEPALIVEr  items
settimeoutrh   r   rg   r   r   )rA   errresfamilysocktyper   	canonnamesocket_addressr   r   r   rC   s               rF   r   zConnection._connectM  sg   
 %%IItyy$"2"2F4F4F
 	!C BE>FHeYD!}}VXu= 2 2F4F4FJ ((OOF$5$5v7J7JAN $ = = C C E B1(:(:AqAB  ; ;< ^,  3 341	!> ?IABB  !#JJL!s   DE55	F>FFc                 8    | j                    d| j                   S )N:)r  r  r   s    rF   r   zConnection._host_errorv  s    ))Adii[))r+   c                 R   | j                         }t        |j                        dk(  r	 d| d|j                  d    dS 	 d|j                  d    d| d	|j                  d    dS # t        $ r d|j                  d    cY S w xY w# t        $ r d|j                  d    cY S w xY w)
Nr   zError connecting to z.                         r   r   zConnection Error: r   z connecting to . )r   rW   r0   AttributeErrorrA   r   r   s      rF   r   zConnection._error_messagey  s     %%'
y~~!#@-j\ :"*+1. .
@Y^^A./!l"Y^^A%6$7q:	 " @+INN1,=+>??@ " @+INN1,=+>??@s#   A' %B 'BBB&%B&)	localhosti  FNr   
rH   rI   rJ   r
  rR   r   r   r   r   __classcell__r   s   @rF   r  r  4  s3    : !%# 'CR*@r+   r  c                   F     e Zd ZdZ	 	 	 	 	 	 	 	 	 	 	 	 d fd	Z fdZ xZS )SSLConnectionzManages SSL connections to and from the Redis server(s).
    This class extends the Connection class, adding SSL functionality, and making
    use of ssl.SSLContext (https://docs.python.org/3/library/ssl.html#ssl.SSLContext)
    c                    t         st        d      || _        || _        |t        j
                  }nWt        |t              rGt        j
                  t        j                  t        j                  d}||vrt        d|       ||   }|| _
        || _        || _        || _        || _        || _        |	| _        |
| _        || _        || _        t)        | T  di | y)ae  Constructor

        Args:
            ssl_keyfile: Path to an ssl private key. Defaults to None.
            ssl_certfile: Path to an ssl certificate. Defaults to None.
            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required). Defaults to "required".
            ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
            ssl_ca_data: Either an ASCII string of one or more PEM-encoded certificates or a bytes-like object of DER-encoded certificates.
            ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to False.
            ssl_ca_path: The path to a directory containing several CA certificates in PEM format. Defaults to None.
            ssl_password: Password for unlocking an encrypted private key. Defaults to None.

            ssl_validate_ocsp: If set, perform a full ocsp validation (i.e not a stapled verification)
            ssl_validate_ocsp_stapled: If set, perform a validation on a stapled ocsp response
            ssl_ocsp_context: A fully initialized OpenSSL.SSL.Context object to be used in verifying the ssl_ocsp_expected_cert
            ssl_ocsp_expected_cert: A PEM armoured string containing the expected certificate to be returned from the ocsp verification service.

        Raises:
            RedisError
        z$Python wasn't built with SSL supportN)noneoptionalrequiredz+Invalid SSL Certificate Requirements Flag: rK   )r&   r   keyfilecertfilessl	CERT_NONEr5   r6   CERT_OPTIONALCERT_REQUIRED	cert_reqsca_certsca_dataca_pathcheck_hostnamecertificate_passwordssl_validate_ocspssl_validate_ocsp_stapledssl_ocsp_contextssl_ocsp_expected_certr  rR   )rA   ssl_keyfilessl_certfilessl_cert_reqsssl_ca_certsssl_ca_datassl_check_hostnamessl_ca_pathssl_passwordrE  rF  rG  rH  r   	CERT_REQSr   s                  rF   rR   zSSLConnection.__init__  s    H CDD"$ MMMs+----I
 I- A-Q  &m4M&$""0$0!!2)B& 0&<#"6"r+   c                    t         
|          }t        j                         }| j                  |_        | j
                  |_        | j                  s| j                  r2|j                  | j                  | j                  | j                         | j                  | j                  | j                  2|j                  | j                  | j                  | j                         |j                  || j                         }| j"                  du rt$        du rt'        d      | j(                  r| j"                  rt'        d      | j(                  r+d	dl}d
dlm} | j0                  f|j2                  j5                  |j2                  j6                        }|j9                  | j                         |j;                  | j                         n| j0                  }|j=                  || j>                         |j2                  jA                  |tC        jB                               }|jE                          |jG                  | j                   | jH                  f       |jK                          |jM                          |S | j"                  du rRt$        rLd
dlm'}  ||| j                   | jH                  | j                        }	|	jQ                         r|S tS        d      |S )z Wrap the socket with SSL support)r:  r9  rf   N)cafilecapathcadata)server_hostnameTFzcryptography is not installed.zKEither an OCSP staple or pure OCSP connection must be validated - not both.r   r   )ocsp_staple_verifier)OCSPVerifierzocsp validation error)*r  r   r;  create_default_contextrC  r?  verify_moder:  r9  load_cert_chainrD  r@  rB  rA  load_verify_locationswrap_socketr  rE  r#   r   rF  OpenSSLocsprW  rG  SSLContextSSLv23_METHODuse_certificate_fileuse_privatekey_fileset_ocsp_client_callbackrH  r  r   request_ocspr   r  do_handshaker   rX  is_validr   )rA   r   contextsslsockr^  rW  
staple_ctxconrX  or   s             rF   r   zSSLConnection._connect  sH   w!,,.!%!4!4"nn==DLL##22 $  MM%||'||'))}}T\\$,, *  %%dDII%F!!T).D.M=>>))d.D.D  ))2 $$,$[[001J1JK
//>..t||<!22
//$d&A&A
 ++((V]]_ECKKDII./LLNN !!T).D*WdiiDMMJAzz|%&=>>r+   )NNr8  NNFNNFFNN)rH   rI   rJ   r
  rR   r   r1  r2  s   @rF   r4  r4    sA       "'#@#DA Ar+   r4  c                   <     e Zd ZdZd fd	Zd Zd Zd Zd Z xZ	S )UnixDomainSocketConnectionz4Manages UDS communication to and from a Redis serverc                 @    || _         || _        t        |   di | y r  )pathrg   r  rR   )rA   rq  rg   r   r   s       rF   rR   z#UnixDomainSocketConnection.__init__  s"    	,"6"r+   c                     d| j                   fd| j                  fg}| j                  r|j                  d| j                  f       |S )Nrq  re   ro   )rq  re   ro   r:   r  s     rF   r   z&UnixDomainSocketConnection.repr_pieces#  sB    499%dgg7MM=$*:*:;<r+   c                    t        j                   t         j                  t         j                        }|j                  | j                         |j                  | j                         |j                  | j                         |S )z&Create a Unix domain socket connection)r   AF_UNIXr  r"  rh   r   rq  rg   )rA   r   s     rF   r   z#UnixDomainSocketConnection._connect)  sU    }}V^^V-?-?@334TYY++,r+   c                     | j                   S rO   )rq  r   s    rF   r   z&UnixDomainSocketConnection._host_error1  s    yyr+   c                     | j                         }t        |j                        dk(  rd| d|j                  d    dS d|j                  d    d| d|j                  d    dS )Nr   z!Error connecting to unix socket: r,  r   r   r   z connecting to unix socket: )r   rW   r0   r.  s      rF   r   z)UnixDomainSocketConnection._error_message4  s}     %%'
y~~!#3J<r)..QRBSATTUV
 *++G,b!2 316r+   ) Nr0  r2  s   @rF   ro  ro    s    :#
r+   ro  )0FFALSENNOc                 v    | | dk(  ry t        | t              r| j                         t        v ryt	        |       S )Nrw  F)r5   r6   upperFALSE_STRINGSr  )rD   s    rF   to_boolr  F  s4    }%%++-="@;r+   )	re   rg   rh   r  ri   r~   max_connectionsrn   rN  c                 B   | j                  d      s-| j                  d      s| j                  d      st        d      t        |       } i }t        | j                        j                         D ]N  \  }}|s	t        |      dkD  st        |d         }t        j                  |      }|r	  ||      ||<   J|||<   P | j                  rt        | j                        |d<   | j                  rt        | j                        |d	<   | j                  d
k(  r/| j                  rt        | j                        |d<   t        |d<   |S | j                   rt        | j                         |d<   | j"                  rt%        | j"                        |d<   | j                  r6d|vr2	 t%        t        | j                        j'                  dd            |d<   | j                  dk(  r	t*        |d<   |S # t        t        f$ r t        d| d      w xY w# t(        t        f$ r Y Mw xY w)Nzredis://z	rediss://zunix://zRRedis URL must specify one of the following schemes (redis://, rediss://, unix://)r   zInvalid value for `z` in connection URL.rr   rf   unixrq  connection_classr  r  re   /rw  rediss)
startswithr   r   r   queryr!  rW   r   URL_QUERY_ARGUMENT_PARSERSr   r=   rr   rf   schemerq  ro  hostnamer  r   replacer-  r4  )urlr   namerD   r   s        rF   	parse_urlr  [  s   z">>+&>>)$5
 	

 3-CF		*002 
%eSZ!^E!H%E/33D9FW#)%=F4L  %t
% ||$S\\2z
||$S\\2z zzV88$SXX.F6N%?!"& M! <<$S\\2F6N88 ]F6N 88F*"7388#4#<#<S"#EFt ::!)6F%&MC ":. W$':4&@T%UVVW6 #J/ s   -G*1H *H	HHc                       e Zd ZdZed        Zedfdee   fdZ	de
e
ffdZddZdd	Zd
e
ddfdZdefdZddZddZdddefdZddeddfdZddZddZy)ConnectionPoola  
    Create a connection pool. ``If max_connections`` is set, then this
    object raises :py:class:`~redis.exceptions.ConnectionError` when the pool's
    limit is reached.

    By default, TCP connections are created unless ``connection_class``
    is specified. Use class:`.UnixDomainSocketConnection` for
    unix sockets.

    Any additional keyword arguments are passed to the constructor of
    ``connection_class``.
    c                 b    t        |      }d|v r|d   |d<   |j                  |        | di |S )a  
        Return a connection pool 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.
        r  rK   )r  update)clsr  r   url_optionss       rF   from_urlzConnectionPool.from_url  s?    R  n'.45G.HK*+k"}V}r+   Nr  c                     |xs d}t        |t              r|dk  rt        d      || _        || _        || _        t        j                         | _        | j                          y )Nl        r   z,"max_connections" must be a positive integer)
r5   r   r   r  connection_kwargsr  	threadingLock
_fork_lockreset)rA   r  r  r  s       rF   rR   zConnectionPool.__init__  s\     *2U/3/?Q3FKLL 0!2. $..*

r+   r`   c           	      ~    t        |       j                   dt         | j                  di | j                         dS )Nr   r   rK   )typerH   reprr  r  r   s    rF   r   zConnectionPool.__repr__  sC    Dz""#*T**DT-C-CDEFaI	
r+   c                     t        j                         | _        d| _        g | _        t               | _        t        j                         | _	        y )Nr   )
r  r  _lock_created_connections_available_connectionsset_in_use_connectionsrz   r{   r|   r   s    rF   r  zConnectionPool.reset  s9    ^^%
$%!&(##&5  99;r+   c                 f   | j                   t        j                         k7  rq| j                  j	                  d      }|st
        	 | j                   t        j                         k7  r| j                          | j                  j                          y y # | j                  j                          w xY w)N   )r   )r|   rz   r{   r  acquirer   r  release)rA   acquireds     rF   	_checkpidzConnectionPool._checkpid  s    F 88ryy{"..q.9H***88ryy{*JJL'') # '')s   1B B0command_namer  c                 N   | j                          | j                  5  	 | j                  j                         }| j                  j                  |       ddd       	 j                          	 |j                         rt        d      	 |S # t        $ r | j                         }Y nw xY w# 1 sw Y   XxY w# t        t        f$ r? |j                          |j                          |j                         rt        d      Y |S w xY w# t        $ r | j                          w xY w)zGet a connection from the poolNConnection has dataConnection not ready)r  r  r  pop
IndexErrormake_connectionr  addr   r   r   r   r   r   r  rA   r  keysoptions
connections        rF   get_connectionzConnectionPool.get_connection2  s'   ZZ 	54!88<<>
 $$((4	5	 
B&&()*?@@ ) 3  4!113
4	5 	5" $W- B%%'""$&&()*@AA ) B
  	 LL$		sX   B+BB+D .B7 B(%B+'B((B++B47A
DD DD D$c                     | j                   }t        |j                  dd      |j                  dd      |j                  dd            S )z,Return an encoder based on encoding settingsrj   rc   rk   rd   rl   F)rj   rk   rl   )r  r   r   )rA   r   s     rF   get_encoderzConnectionPool.get_encoderS  sF    ''ZZ
G4"JJ'8(C#ZZ(:EB
 	
r+   c                     | j                   | j                  k\  rt        d      | xj                   dz  c_          | j                  di | j                  S )zCreate a new connectionzToo many connectionsr   rK   )r  r  r   r  r  r   s    rF   r  zConnectionPool.make_connection\  sO    $$(<(<<!"899!!Q&!$t$$>t'='=>>r+   r  c                 v   | j                          | j                  5  	 | j                  j                  |       | j                  |      r| j                  j                  |       n/| xj                  dz  c_        |j                          	 ddd       y	 ddd       y# t        $ r Y qw xY w# 1 sw Y   yxY w)z(Releases the connection back to the poolr   N)
r  r  r  r   KeyErrorowns_connectionr  r:   r  r   rA   r  s     rF   r  zConnectionPool.releasec  s    ZZ 	((//
; ##J/++22:>
 ))Q.)%%'!	 	 ?	 	   	 	s.   B/B AB/ 	B,)B/+B,,B//B8c                 4    |j                   | j                   k(  S rO   )r|   r  s     rF   r  zConnectionPool.owns_connectionx  s    ~~))r+   inuse_connectionsc                     | j                          | j                  5  |r!t        | j                  | j                        }n| j                  }|D ]  }|j                           	 ddd       y# 1 sw Y   yxY w)z
        Disconnects connections in the pool

        If ``inuse_connections`` is True, disconnect connections that are
        current in use, potentially by other threads. Otherwise only disconnect
        connections that are idle in the pool.
        N)r  r  r   r  r  r   )rA   r  connectionsr  s       rF   r   zConnectionPool.disconnect{  sp     	ZZ 		( #//1I1I #99) (
%%'(		( 		( 		(s   AA..A7c                 $    | j                          y)z-Close the pool, disconnecting all connectionsNr   r   s    rF   r   zConnectionPool.close  r   r+   c                     | j                   j                  d|i       | j                  D ]	  }||_         | j                  D ]	  }||_         y )Nrs   )r  r  r  rs   r  )rA   rs   conns      rF   	set_retryzConnectionPool.set_retry  sS    %%w&67// 	DDJ	,, 	DDJ	r+   r_   )r`   r  )r  r  r`   Nr	  )rs   r"   r`   N)rH   rI   rJ   r
  classmethodr  r  r   r   rR   r6   r   r  r  r  r   r  r  r  r  r  r   r   r  rK   r+   rF   r  r    s     . .d $)- "#2
3* 
"-*^3 \ B
W 
?**, *3 *(D (D ((r+   r  c                   J     e Zd ZdZddeef fd	Zd Zd Zd Z	d Z
d	 Z xZS )
BlockingConnectionPoola  
    Thread-safe blocking connection pool::

        >>> from redis.client import Redis
        >>> client = Redis(connection_pool=BlockingConnectionPool())

    It performs the same function as the default
    :py:class:`~redis.ConnectionPool` implementation, in that,
    it maintains a pool of reusable connections that can be shared by
    multiple redis clients (safely across threads if required).

    The difference is that, in the event that a client tries to get a
    connection from the pool when all of connections are in use, rather than
    raising a :py:class:`~redis.ConnectionError` (as the default
    :py:class:`~redis.ConnectionPool` implementation does), it
    makes the client wait ("blocks") for a specified number of seconds until
    a connection becomes available.

    Use ``max_connections`` to increase / decrease the pool size::

        >>> pool = BlockingConnectionPool(max_connections=10)

    Use ``timeout`` to tell it either how many seconds to wait for a connection
    to become available, or to block forever:

        >>> # Block forever.
        >>> pool = BlockingConnectionPool(timeout=None)

        >>> # Raise a ``ConnectionError`` after five seconds if a connection is
        >>> # not available.
        >>> pool = BlockingConnectionPool(timeout=5)
    2      c                 F    || _         || _        t        |   d||d| y )N)r  r  rK   )queue_classr   r  rR   )rA   r  r   r  r  r  r   s         rF   rR   zBlockingConnectionPool.__init__  s6     ' 	
-+	
  	
r+   c                     | j                  | j                        | _        	 	 | j                  j                  d        # t        $ r Y nw xY wg | _        t        j                         | _        y rO   )	r  r  pool
put_nowaitr   _connectionsrz   r{   r|   r   s    rF   r  zBlockingConnectionPool.reset  sf    $$T%9%9:			$$T*   
  99;s   ? 	A
Ac                 t     | j                   di | j                  }| j                  j                  |       |S )zMake a fresh connection.rK   )r  r  r  r:   r  s     rF   r  z&BlockingConnectionPool.make_connection  s7    *T**DT-C-CD
  ,r+   c                 
   | j                          d}	 | j                  j                  d| j                        }|| j                         }	 |j                          	 |j                         rt        d      	 |S # t        $ r t        d      w xY w# t
        t        f$ r? |j                          |j                          |j                         rt        d      Y |S w xY w# t        $ r | j                  |        w xY w)a7  
        Get a connection, blocking for ``self.timeout`` until a connection
        is available from the pool.

        If the connection returned is ``None`` then creates a new connection.
        Because we use a last-in first-out queue, the existing connections
        (having been returned to the pool after the initial ``None`` values
        were added) will be returned before ``None`` values. This means we only
        create new connections when we need to, i.e.: the actual number of
        connections will only increase in response to demand.
        NT)blockr   zNo connection available.r  r  )r  r  r   r   r   r   r  r   r   r   r   r   r  r  s        rF   r  z%BlockingConnectionPool.get_connection  s    	 
	>T4<<HJ --/J	 
B&&()*?@@ ) =  	> ""<==	>( $W- B%%'""$&&()*@AA ) B
  	LL$	s6   'A= C& B =BA
C#C& "C##C& &Dc                     | j                          | j                  |      s,|j                          | j                  j	                  d       y	 | j                  j	                  |       y# t
        $ r Y yw xY w)z)Releases the connection back to the pool.N)r  r  r   r  r  r   r  s     rF   r  zBlockingConnectionPool.release  sj     	##J/
 !!#II  &	II  , 	 	s   A+ +	A76A7c                 f    | j                          | j                  D ]  }|j                           y)z(Disconnects all connections in the pool.N)r  r  r   r  s     rF   r   z!BlockingConnectionPool.disconnect4  s-    ++ 	$J!!#	$r+   )rH   rI   rJ   r
  r  r   rR   r  r  r  r  r   r1  r2  s   @rF   r  r    s6    F #
 02h*$r+   r  )Pr   rz   r   r;  r>   r  r   abcr   	itertoolsr   queuer   r   r   r   typingr	   r
   r   r   r   r   urllib.parser   r   r   _parsersr   r   r   r   backoffr   credentialsr   r   
exceptionsr   r   r   r   r   r   r    r!   rs   r"   utilsr#   r$   r%   r&   r'   r(   r;   rV   r[   rX   rT   r   objectr}   __annotations__r-   r/   rM   rb   r  r4  ro  r  r  r   r  listr  r  r  r  rK   r+   rF   <module>r     sO    	  
 
     ( (  = = 4 4 I I  O	 	 	   
	 8E,nDEF F"M M $0 0fs slX@# X@vIJ IX%!3 %P / # !
 6rD DN]$^ ]$r+   