IhY UddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z mZddlmZmZmZmZmZmZmZmZddlmZmZmZddlmZmZmZm Z m!Z!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+dd l,m-Z-m.Z.dd l/m0Z0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ddl;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFe@rddlGZGndZGe?rddlHZHdZIdZJdZKdZLdZMeNZOeee&e'e%fePd<e?re%ZQne&ZQGddZRGddZSGddZTGddeTZUGdd eUZVGd!d"eTZWGd#d$eVZXGd%d&eUZYd'ZZd(Z[e\e]e]e[e[e^e\e\e[e]d) Z_d*Z`ed+d,-ZaGd.d,ZbGd/d0ebZcy)1N)abstractmethod)chain)EmptyFull LifoQueue)AnyCallableDictListOptionalTypeTypeVarUnion)parse_qsunquoteurlparse) CacheEntryCacheEntryStatus CacheFactoryCacheFactoryInterfaceCacheInterfaceCacheKey)Encoder_HiredisParser _RESP2Parser _RESP3Parser)TokenInterface) NoBackoff)CredentialProvider"UsernamePasswordCredentialProvider)AfterConnectionReleasedEventEventDispatcher)AuthenticationError$AuthenticationWrongNumberOfArgsErrorChildDeadlockedErrorConnectionError DataError RedisError ResponseError TimeoutError)Retry) CRYPTOGRAPHY_AVAILABLEHIREDIS_AVAILABLE SSL_AVAILABLEcompare_versionsdeprecated_args ensure_stringformat_error_messageget_lib_version str_if_bytes*$s  DefaultParserceZdZdefdZy)HiredisRespSerializerargscg}t|dtr1t|djj |ddz}n)d|dvr"t|dj |ddz} |j t j||S#t$r3tj\}}}t|j|wxYw2Pack a series of arguments into the Redis protocolrrN ) isinstancestrtupleencodesplitappendhiredis pack_command TypeErrorsysexc_infor(with_traceback)selfr=output_value tracebacks I/var/www/html/planif/env/lib/python3.12/site-packages/redis/connection.pypackzHiredisRespSerializer.packLs d1gs #a)//12T!"X=D T!W_a)DH4D = MM'..t4 5   ="%,,. AuiE"11)< < =s 1$B)>)@(KL++ t{{D) CSJD M) -c:. ~~:s:'='='?J d# c" ~~"J..0   ! 4  d r8returnN)rUrVrWr_rTrXr8rSrZrZ]s +r8rZcpeZdZedZedZedZedZedZedZ edZ edZ ed Z edd Z ed Zedd Ze dd dddZedZedZeedeeeefeeefffdZedefdZedZy)ConnectionInterfacecyr\rXrNs rS repr_pieceszConnectionInterface.repr_pieces r8cyr\rXrNcallbacks rSregister_connect_callbackz-ConnectionInterface.register_connect_callbackrsr8cyr\rXrus rSderegister_connect_callbackz/ConnectionInterface.deregister_connect_callbackrsr8cyr\rXrN parser_classs rS set_parserzConnectionInterface.set_parserrsr8cyr\rXrqs rS get_protocolz ConnectionInterface.get_protocolrsr8cyr\rXrqs rSconnectzConnectionInterface.connectrsr8cyr\rXrqs rS on_connectzConnectionInterface.on_connectrsr8cyr\rXrNr=s rS disconnectzConnectionInterface.disconnectrsr8cyr\rXrqs rS check_healthz ConnectionInterface.check_healthrsr8Tcyr\rXrNcommandrs rSsend_packed_commandz'ConnectionInterface.send_packed_commandrsr8cyr\rXrNr=kwargss rS send_commandz ConnectionInterface.send_commandrsr8cyr\rXrNtimeouts rScan_readzConnectionInterface.can_readrsr8Fdisconnect_on_error push_requestcyr\rX)rNdisable_decodingrrs rS read_responsez!ConnectionInterface.read_responses r8cyr\rXrs rSrIz ConnectionInterface.pack_commandrsr8cyr\rXrNcommandss rS pack_commandsz!ConnectionInterface.pack_commandsrsr8rmcyr\rXrqs rShandshake_metadataz&ConnectionInterface.handshake_metadatas r8tokencyr\rXrNrs rSset_re_auth_tokenz%ConnectionInterface.set_re_auth_tokenrsr8cyr\rXrqs rSre_authzConnectionInterface.re_authrsr8NTrF)rUrVrWrrrrwryr}rrrrrrrrrrIrpropertyrr bytesrCrrrrrXr8rSroros                         !        E$ue|*Z/d?e1fd@Z2dAZ3y)EAbstractConnectionz0Manages communication to and from a Redis serverrNFutf-8strictizredis-pyr9dbpasswordsocket_timeoutsocket_connect_timeoutretry_on_timeoutencodingencoding_errorsdecode_responsessocket_read_sizehealth_check_interval client_namelib_name lib_versionusernameretryredis_connect_funccredential_providerprotocolcommand_packerevent_dispatcherc|s|r | td|t|_n||_tj|_||_| |_||_||_ ||_ ||_ ||_ ||_ ||}||_||_|t urg}|r|j#t$||_|s|rR|t)t+d|_nt/j0||_|j,j3|nt)t+d|_| |_d|_||_t;||| |_d|_d|_ | |_!|jE| g|_#d|_$d|_% tM|}|dks|dkDr tUd ||_+|jY||_-y#tN$r tP}YDtR$r tUdwxYw#dks|dkDr tUd ||_+wxYw) 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'rripzprotocol must be an integerr9zprotocol must be either 2 or 3).r(r#_event_dispatcherosgetpidpidrrrrrrrrrrSENTINELrGr+retry_on_errorr,rrcopydeepcopyupdate_supported_errorsrnext_health_checkrrencoderr_sock_socket_read_sizer}_connect_callbacksr]_re_auth_tokenintrJDEFAULT_RESP_VERSION ValueErrorr'r_construct_command_packer_command_packer)rNrrrrrrrrrr|rrrrrrrrrrrrps rSr_zAbstractConnection.__init__s @ &9&E+   #%4%6D "%5D "99;&  &#6     , ! )%3 "&<# 0 X %N   ! !, /, N}"9;2 "]]51 JJ . .~ >y{A.DJ%:"!""4x:JK "& !1  %"$"8< H A 1uA%&FGGDM#==nM %$A A!"?@ @ A1uA%&FGGDMs$ GG+G.G++G..H c dj|jDcgc] \}}|d|c}}}d|jjd|jjd|dScc}}w)N,=<.()>)rbrr __class__rVrU)rNkv repr_argss rS__repr__zAbstractConnection.__repr__DsjHHT5E5E5GHTQ1QCjHI 4>>,,-Qt~~/F/F.Gq SUVVIsA, cyr\rXrqs rSrrzAbstractConnection.repr_piecesHrsr8cD |jy#t$rYywxYwr\)r Exceptionrqs rS__del__zAbstractConnection.__del__Ls#  OO    s  c~||Str tSt|j|jj Sr\)r.r<rZr]rrE)rNpackers rSrz,AbstractConnection._construct_command_packerRs6  M (* *'(;(;T\\=P=PQ Qr8ctj|}||jvr|jj|yy)a^ Register a callback to be called when the connection is established either initially or reconnected. This allows listeners to issue commands that are ephemeral to the connection, for example pub/sub subscription or key tracking. The callback must be a _method_ and will be kept as a weak reference. N)weakref WeakMethodrrG)rNrvwms rSrwz,AbstractConnection.register_connect_callbackZs;   ) T,, ,  # # * *2 . -r8c |jjtj|y#t$rYywxYw)z De-register a previously registered callback. It will no-longer receive notifications on connection events. Calling this is not required when the listener goes away, since the callbacks are kept as weak methods. N)rremoverrrrus rSryz.AbstractConnection.deregister_connect_callbackfs8    # # * *7+=+=h+G H   s .1 ==c4||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 )rN)r_parserr{s rSr}zAbstractConnection.set_parserqs $T5K5KL r8c(|jdy)z5Connects to the Redis server if not already connectedTrN)connect_check_healthrqs rSrzAbstractConnection.connectys !!t!4r8Trc@jry jjfdfd}|_ jj|njjDcgc] }|s |c}_ jD]}|}|s |y#tj$r t dt $r}tj|d}~wwxYw#t$rjwxYwcc}w)Nc$jSr\)_connectrqsrSz9AbstractConnection.connect_check_health..s  r8c&j|Sr\rerrorrNs rSrz9AbstractConnection.connect_check_health..stu7Mr8zTimeout connecting to serverr)rrcall_with_retrysocketrr+OSErrorr'_error_messageron_connect_check_healthr)rr)rNrsockerefrvs` rSrz'AbstractConnection.connect_check_health}s ::  :::--')MD  &&.,,,,G''-372I2I"S3SU3"S** CuH -~~ ?=> > :!$"5"5a"89 9 :  OO   #Ts."B50C=8 DD5&C:C55C:=Dcyr\rXrqs rSrzAbstractConnection._connectrsr8cyr\rXrqs rS _host_errorzAbstractConnection._host_errorrsr8c6t|j|Sr\)r3r )rN exceptions rSrz!AbstractConnection._error_messages#D$4$4$6 BBr8c(|jdy)NTr)rrqs rSrzAbstractConnection.on_connects $$$$7r8c|jj||j}d}|js|js |jr>|jxs t |j|j}|j }|r|jdvrt|jtrK|jt|j|j_ |jj|t|dk(rd|dg}|jd|jdg|dd i|j|_nD|rA|jdg|dd i |j}t%|d k7r t'd |jdvrt|jtrK|jt|j|j_ |jj||jd|j| |j|_|j j)d|jk7r3|j j)d|jk7r t+d|j,rF|jdd|j,| t%|jd k7r t+d |j.r0|jddd|j.| |j |j2r0|jddd|j2| |j|j4rF|jd|j4| t%|jd k7r t+dyy#t"$r+|jd|d d |j}YmwxYw#t0$rYwxYw#t0$rYwxYw)z=Initialize the connection, authenticate and select a databaseN)r92rdefaultrHELLOAUTHrFrOKzInvalid Username or PasswordsprotoprotozInvalid RESP versionCLIENTSETNAMEzError setting client nameSETINFOzLIB-NAMEzLIB-VERSELECTzInvalid Database)rrrrrr!get_credentialsrrBrr}rEXCEPTION_CLASSESrdrrrr%r5r$getr'rrr*rr)rNrparser auth_args cred_provider auth_responses rSrz*AbstractConnection.on_connect_check_healths %  # # ((T5dmmT]]S &557I h6$,, 5 -171I1I . ''-9~"& ! 5  D   1: IN '+&8&8&:D #  D  f Ey Eu E 5 $ 2 2 4 M*d2)*HII]]( *$,, 5 -171I1I . ''-   gt}}<  P&*&8&8&:D #''++H5F++//8DMMI%&<==        )   D..01T9%&ABB }}!!MM!- """$ !!$$!- """$ 77   hl  KD..01T9%&899: C8 5 !!&)B-e!L $ 2 2 4  5`      s6(N2&  V *! *X0<eCHo(E$ue|*FHeYD !}}VXu= 2 2F4F4FJ((OOF$5$5v7J7JAN $ = = C C EB1(:(:AqAB ; ;< ^, 3 34 1! !F ?IABB !# f&6&67"JJL !s=D E55 G >GF#"G# F/,G.F//GG c8|jd|jS)N:)r[r\rqs rSr zConnection._host_error s))Adii[))r8) localhostiFNr rUrVrWrSr_rrrr  __classcell__rs@rSrXrXs-: !% #  +CZ*r8rXc:eZdZdZdZdZdededejfdZ dZ d Z d Z d Zd Zd ZdZdZd&dZdZd'dZ d(ddddZdZdZedeeeefeeefffdZdZdZ deddfdZ!dZ"d e#eee$e#effd!Z%d"Z&d#e'fd$Z(d%Z)y))CacheProxyConnectionsfooz7.4.0redisconncache pool_lockctj|_||_|jj|_|jj |_|jj |_|j|_||_||_ tj|_ d|_ d|_|j|j yr\)rrr_connrr[r\r _pool_lock_cache threadingRLock _cache_lock_current_command_cache_key_current_optionsrw_enable_tracking_callback)rNr|r}r~s rSr_zCacheProxyConnection.__init__)s 99; ZZ%% JJOO JJOO #'#;#; # $??,*.' $ &&t'E'EFr8c6|jjSr\)rrrrqs rSrrz CacheProxyConnection.repr_pieces<szz%%''r8c:|jj|yr\)rrwrus rSrwz.CacheProxyConnection.register_connect_callback?s ,,X6r8c:|jj|yr\)rryrus rSryz0CacheProxyConnection.deregister_connect_callbackBs ..x8r8c:|jj|yr\)rr}r{s rSr}zCacheProxyConnection.set_parserEs l+r8c |jj|jjjdd}|&|jjjdd}|jjjdd}|&|jjjdd}|| t dt |}t |}||j k7st||jdk(r t dy)Nsserverserversversionversionz0Cannot retrieve information about server versionrziTo maximize compatibility with all Redis products, client-side caching is supported by Redis 7.4 or later) rrrrr'r2DEFAULT_SERVER_NAMEr0MIN_ALLOWED_VERSION)rN server_name server_vers rSrzCacheProxyConnection.connectHs jj3377 4H  **77;;HdKKZZ2266z4H  66::9dKJ  !3!"TU U":. #K0  433 3 D,D,DEJ!{ Kr8c8|jjyr\)rrrqs rSrzCacheProxyConnection.on_connect_s r8c|j5|jjddd|jj|y#1swY#xYwr\)rrflushrrrs rSrzCacheProxyConnection.disconnectbsD    KK     t$  s A  Ac8|jjyr\)rrrqs rSrz!CacheProxyConnection.check_healthgs !r8Tc:|jj|yr\)rrrs rSrz(CacheProxyConnection.send_packed_commandjs &&w/r8c |j|j5|jjt |dds-d|_|j j|i| dddy ddd|jd tdt |dt|jd|_|j5|jj|j r|jj|j }|j|j k7rf|j5|jjr7|jjd|jjr7ddd dddy|jjt!|j |j"t$j&|j ddd|j j|i|y#1swYxYw#1swYxYw#1swY?xYw) NrrX)r redis_keyskeyszCannot create cache key.Tr) cache_key cache_valuestatusconnection_ref)_process_pending_invalidationsrr is_cachablerrrrrrrDrrrrsetrDUMMY_CACHE_VALUEr IN_PROGRESS)rNr=rentrys rSrz!CacheProxyConnection.send_commandos ++-    ;;**8DGPR+ST26/' ''88   U  ::f  %78 8+3Gfjj.@(A+ '   {{t>>? (G(GH''4::5R#22;;=!00>>D>Q$22;;=R   KKOO"== $ 6 6+77#'::  ! 6  00W  0RR  s9AHA0H8AH, H8&AH8H),H5 1H88Ic8|jj|Sr\)rrrs rSrzCacheProxyConnection.can_readszz""7++r8Frc|j5|j|jj|j|jj|jjt j k7rTtj|jj|jj}d|_|cdddSddd|jj|||}|j5|j |cdddS|1|jj|jg|cdddS|jj|j}|7t j|_||_ |jj|d|_ddd|S#1swYxYw#1swY|SxYw)N)rrr)rrrrrrrrrrrrdelete_by_cache_keysVALIDr)rNrrrrnr@ cache_entrys rSrz"CacheProxyConnection.read_responses   //;KKOOD$C$CDPKKOOD$C$CDKK#//0mmKKOOD$C$CDPP37/   ::++- 3%,     3..6 3 3  00$2Q2Q1RS 3 3++//$*I*IJK&%5%;%; "*2 '  ,.2D +% 3(Q  ( 3(s%B> G&(79,. % "0 .1`, %+=APU+Z.2-E$ue|*S9S3T.U:),~,r8rzcPeZdZdZ dfd ZfdZdZxZS) 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 ts td||_||_|tj }nWt |trGtj tjtjd}||vrtd|||}||_ ||_ ||_ ||_ |jtj k7r|nd|_||_| |_| |_| |_| |_| |_||_t-|\di|y)aConstructor 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), or an ssl.VerifyMode. 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. ssl_min_version: The lowest supported SSL version. It affects the supported SSL versions of the SSLContext. None leaves the default provided by ssl module. ssl_ciphers: A string listing the ciphers that are allowed to be used. Defaults to None, which means that the default ciphers are used. See https://docs.python.org/3/library/ssl.html#ssl.SSLContext.set_ciphers for more information. Raises: RedisError z$Python wasn't built with SSL supportN)noneoptionalrequiredz+Invalid SSL Certificate Requirements Flag: FrX)r/r)keyfilecertfilessl CERT_NONErBrC CERT_OPTIONAL CERT_REQUIRED cert_reqsca_certsca_dataca_pathcheck_hostnamecertificate_passwordssl_validate_ocspssl_validate_ocsp_stapledssl_ocsp_contextssl_ocsp_expected_certssl_min_version ssl_ciphersr`r_)rN ssl_keyfile ssl_certfile ssl_cert_reqs ssl_ca_certs ssl_ca_datassl_check_hostname ssl_ca_path ssl_passwordrrrrrrr CERT_REQSrs rSr_zSSLConnection.__init__s PCD D" $  MMM  s + ----I I- A-Q&m4M&$ " " "&..CMM"A u %1!!2)B& 0&<#.& "6"r8ct|} |j|S#ttf$r|j wxYw)zN Wrap the socket with SSL support, handling potential errors. )r`r_wrap_socket_with_sslrr)r&)rNrrs rSrzSSLConnection._connectJsHw! --d3 3$  JJL  s "!Ac,tj}|j|_|j|_|j s |j r2|j|j |j |j|j|j |j2|j|j|j|j|j|j|_|jr|j!|j|j"durt$dur t'd|j(r|j"r t'd|j+||j,}|j(r+d dl}d d lm}|j4f|j6j9|j6j:}|j=|j |j?|j n |j4}|jA||jB|j6jE|tGjF}|jI|jK|j,|jLf|jO|jQ|S|j"durRt$rLd d lm)}|||j,|jL|j} | jUr|StWd |S)z Wraps the socket with SSL support. Args: sock: The plain socket to wrap with SSL. Returns: An SSL wrapped socket. )rrrN)cafilecapathcadataTFzcryptography is not installed.zKEither an OCSP staple or pure OCSP connection must be validated - not both.)server_hostnamerr)ocsp_staple_verifier) OCSPVerifierzocsp validation error),rcreate_default_contextrr verify_moderrload_cert_chainrrrrload_verify_locationsrminimum_versionr set_ciphersrr-r)r wrap_socketr[OpenSSLocsprrSSLContext SSLv23_METHODuse_certificate_fileuse_privatekey_fileset_ocsp_client_callbackrrXr request_ocsprr\ do_handshaker$ris_validr') rNrcontextsslsockrr staple_ctxconros rSrz#SSLConnection._wrap_socket_with_sslUsu,,.!%!4!4"nn ==DLL  # # 22 $  MM %||'||'  ) )}}T\\$,, *     +&*&:&:G #       0 0 1  ! !T ).D.M=> >  ) )d.D.D  %%dDII%F  ) )  2$$,$[[001J1JK // >..t||<!22  / /$d&A&A  ++((V]]_EC     KKDII. /     LLNN  ! !T ).D *WdiiDMMJAzz|%&=>>r8)NNrNNTNNFFNNNN)rUrVrWrSr_rrrwrxs@rSrrsF "'#H#T Mr8rc6eZdZdZdfd ZdZdZdZxZS)UnixDomainSocketConnectionz4Manages UDS communication to and from a Redis serverc @t|di|||_||_yrZ)r`r_pathr)rNrrrrs rSr_z#UnixDomainSocketConnection.__init__s" "6" ,r8cd|jfd|jfg}|jr|jd|jf|S)Nrrr)rrrrGrbs rSrrz&UnixDomainSocketConnection.repr_piecessB499%dgg7    MM=$*:*:; < r8ctjtjtj}|j|j |j |j |j|j|S#t$rB |jtjn#t$rYnwxYw|jwxYw)z&Create a Unix domain socket connection) rAF_UNIXrerlrrrrr$r%r&r)rNrs rSrz#UnixDomainSocketConnection._connects}}V^^V-?-?@ 334  LL # ++,    f../   JJL  s0B CB10C1 B=:C<B==Cc|jSr\)rrqs rSr z&UnixDomainSocketConnection._host_errors yyr8)Nrvrxs@rSrrs:-  "r8r)0FFALSENNOcv||dk(ryt|tr|jtvryt |S)NrF)rBrCupper FALSE_STRINGSrU)rQs rSto_boolrs4 } %%++-="@ ;r8) rrrr]rrmax_connectionsrrrcB|jds-|jds|jds tdt|}i}t|jj D]N\}}|s t |dkDst|d}tj|}|r ||||<J|||<P|jrt|j|d<|jrt|j|d <|jd k(r/|jrt|j|d <t|d <|S|j rt|j |d <|j"rt%|j"|d<|jr6d|vr2 t%t|jj'dd|d<|jdk(r t*|d <|S#ttf$rtd|dwxYw#t(tf$rYMwxYw)Nzredis://z rediss://zunix://zRRedis URL must specify one of the following schemes (redis://, rediss://, unix://)rzInvalid value for 'z' in connection URL.rrunixrconnection_classr[r\r/rrediss) startswithrrrqueryrkrdrURL_QUERY_ARGUMENT_PARSERSrrJrrschemerrhostnamer\rreplaceAttributeErrorr)urlrnamerQrs rS parse_urlr s z" >>+ & >>) $ 5  3-C F *002 % e SZ!^E!H%E/33D9FW#)%=F4L %t  % ||$S\\2z ||$S\\2z zzV 88$SXX.F6N%?!"& M! <<$S\\2F6N 88 ]F6N 88F* "7388#4#<# - `rediss://` creates a SSL wrapped TCP socket connection. See more at: - ``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. rrX)r update)r%rr url_optionss rSfrom_urlzConnectionPool.from_url+s?R n  '.45G.HK* + k"}V}r8Nr cache_factoryc |xsd}t|tr|dkr td||_||_||_d|_||_|jds|jdr|jddvr td|jjd}|#t|ts td ||_nc|j |jj|_n7t|jjdj|_|jdd|jdd|jjd d|_|jt|_t!j"|_|j t!j"|_nt!j(|_|j+y) Nlrz,"max_connections" must be a positive integer cache_configr}r)rr?z4Client caching is only supported with RESP version 3z#Cache must implement CacheInterfacer)rBrrrconnection_kwargsrr}_cache_factoryrr)r get_cacherpoprr#rr _fork_lock_lockrreset)rNrrr*r-r}s rSr_zConnectionPool.__init__\s*2U/3/?Q3FKL L 0!2. +   04E4I4I'4R $$Z0@ !WXX**..w7E !%8$%JKK" &&2!%!4!4!>!>!@DJ!-..22>B"ikJ gt,nd3!%!7!7!;!;   $ $ ( ( 4  5      B&&(TZZ-?)*?@@3 4!113  4 5 5"$\7; B%%'""$&&()*@AA) B   LL $   sXB6BB6D.'CB30B62B33B66B?ADDDDD4c|j}t|jdd|jdd|jddS)z,Return an encoder based on encoding settingsrrrrrF)rrr)r-rr)rNrs rS get_encoderzConnectionPool.get_encodersF''ZZ G4"JJ'8(C#ZZ(:EB  r8c:|j|jk\r td|xjdz c_|j;t |j di|j |j|jS|j di|j S)zCreate a new connectionzToo many connectionsrrX)r9rr'r}rzrr-r2rqs rSrLzConnectionPool.make_connections  $ $(<(< <!"89 9 !!Q&! :: !'%%%?(>(>?TZZ %t$$>t'='=>>r8rQc|j|j5 |jj||j |r@|j j||jjt|n|j dddy dddy#t$r YdddywxYw#1swYyxYw)z(Releases the connection back to the poolN) rAr2r;rKeyErrorowns_connectionr:rGrdispatchr"rrNrQs rSr?zConnectionPool.release%s  ZZ  ((// ; ##J/++22:>&&//0<%%''           s.CB/A"C/ C8CCCCc4|j|jk(Sr\)rrZs rSrXzConnectionPool.owns_connection=s~~))r8inuse_connectionsc|j|j5|r!t|j|j}n |j}|D]}|j  dddy#1swYyxYw)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)rAr2rr:r;r)rNr\ connectionsrQs rSrzConnectionPool.disconnect@sp  ZZ ( #//1I1I #99 ) ( %%' ( ( ( (s AA..A7c$|jy)z-Close the pool, disconnecting all connectionsNrrqs rSr&zConnectionPool.closeTr/r8rc|jjd|i|jD] }||_ |jD] }||_ y)Nr)r-r'r:rr;)rNrr|s rS set_retryzConnectionPool.set_retryXsS %%w&67// DDJ ,, DDJ r8rc>j5jD]GjjfdfdjjfdfdIjD]j  dddy#1swYyxYw)NcdjdjdjSrO)rrQrR)r|rsrSrz1ConnectionPool.re_auth_callback..cs)D-- e 4eoo6Gr8c&j|Sr\_mockrs rSrz1ConnectionPool.re_auth_callback..fs$**U"3r8c$jSr\)r)r|srSrz1ConnectionPool.re_auth_callback..isD..0r8c&j|Sr\rers rSrz1ConnectionPool.re_auth_callback..is 5@Qr8)r2r:rrr;r)rNrr|s``@rSre_auth_callbackzConnectionPool.re_auth_callback_s ZZ .33  **4   **02Q 00 .&&u- . . . .s A9BBrc Kyw)z Dummy functions, needs to be passed as error callback to retry object. :param error: :return: NrXr-s rSrfzConnectionPool._mockns srlr\)rmrX)rmro)rQrXrmNr)"rUrVrWrS classmethodr r!rCr)rXr rrr_rrr3rAr1rRrrTrLr?rXrUrr&r,rarrir)rfrXr8rSr"r"s .d3i.c...d$)-9= ="#= 56 =~ 3* < -*^U:   D W  ?0*,*3*(D(D((u .n .  r8cjeZdZdZddeeffd ZdZdZe dgdd dd Z d Z d Z xZ 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) 2c F||_||_t| d||d|y)N)rrrX) queue_classrr`r_)rNrrrrqr-rs rSr_zBlockingConnectionPool.__init__s6'   -+   r8c|j|j|_ |jjd#t$rYnwxYwg|_t j|_yr\) rqrpool put_nowaitr _connectionsrrrrqs rSr3zBlockingConnectionPool.resetsf$$T%9%9:   $$T*   99;s? A  A c|j(>?TZZJ/..H1G1GHJ   ,r8rBrCrDrEc|jd} |jjd|j}||j } |j |jr t d |S#t$r t dwxYw#t ttf$r?|j|j|jr t dY|SwxYw#t$r|j|wxYw)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)blockrzNo connection available.rIrJ)rArsrrrr'rLrrr+rrr6r?rNs rSrRz%BlockingConnectionPool.get_connections$   >T4<<HJ  --/J      B&&()*?@@)= >""<= = >($\7; B%%'""$&&()*@AA) B   LL $  s6'A=C+B=BAC($C+'C((C++Dc|j|j|s,|j|jj dy |jj |y#t $rYywxYw)z)Releases the connection back to the pool.N)rArXrrsrtrrZs rSr?zBlockingConnectionPool.releasesj ##J/  ! ! # II  &   II  ,   sA++ A76A7cf|j|jD]}|jy)z(Disconnects all connections in the pool.N)rArurrZs rSrz!BlockingConnectionPool.disconnects- ++ $J  ! ! # $r8r\)rUrVrWrSrXrr_r3rLr1rRr?rrwrxs@rSrmrmwsUF#  0 U: 2  2h*$r8rm)drrrrKrr1rabcr itertoolsrqueuerrrtypingrr r r r r rr urllib.parserrr redis.cacherrrrrr_parsersrrrr auth.tokenrbackoffr credentialsr r!eventr"r# exceptionsr$r%r&r'r(r)r*r+rr,utilsr-r.r/r0r1r2r3r4r5rrHrcrhrerarobjectr__annotations__r:r<rZrorrXrzrrrrrrTlistrr r!r"rmrXr8rSrs  ((LLL44JI&O@       C      8E, nDEFF"M M$00fN N bv',v'rG*#G*TS.SlhJhV !3 F/  # ! 6re+,W W t g$^g$r8