IiE9 SSKrSSKrSSKJr SSKJr SSKJr SSKJ r J r J r SSK J r JrJrJr SSKJr "SS \ 5r"S S \ 5r"S S \ 5r"SS\\ 5r"SS5r"SS\ 5r"SS\5rg)N)Optional)Redis)SentinelCommands) ConnectionConnectionPool SSLConnection)ConnectionError ReadOnlyError ResponseError TimeoutError) str_if_bytesc\rSrSrSrg)MasterNotFoundError N__name__ __module__ __qualname____firstlineno____static_attributes__r4/venv/lib/python3.13/site-packages/redis/sentinel.pyrr rrc\rSrSrSrg)SlaveNotFoundErrorrNrrrrrrrrrcz^\rSrSrU4SjrSrU4SjrSrSrS SSS.S \ \ S \ \ 4U4S jjjjr S r U=r $)SentinelManagedConnectionc R>URS5Ul[TU] "S0UD6 g)Nconnection_poolr)popr"super__init__)selfkwargs __class__s rr%"SentinelManagedConnection.__init__s%%zz*;< "6"rcURnS[U5RS[U5RSURS3nUR (a SUR SUR 3nX#-nU$)N<. (service=z%s)>z,host=z,port=)r"typerr service_namehostport)r&pools host_infos r__repr__"SentinelManagedConnection.__repr__sy##T %%&aT (;(;'<))*$ 0  99  6$))=I Arc>UuUlUl[TU] 5 URR (a:UR S5 [UR55S:wa [S5egg)NPINGPONGz PING failed) r0r1r$connectr"check_connection send_commandr read_responser )r&addressr(s r connect_to$SentinelManagedConnection.connect_to$sc& 49     0 0   f %D..01V;%m44< 1rcDUR(agURR(a*URURR 55 gURR 5HnURU5s $ [e![ a M,f=fN)_sockr" is_masterr?get_master_address rotate_slavesr r)r&slaves r_connect_retry(SentinelManagedConnection._connect_retry,s ::     ) ) OOD00CCE F--;;=??511> % $'s6B BBcPURRURS5$)NcgrBr)errors r3SentinelManagedConnection.connect..:sTr)retrycall_with_retryrHr&s rr:!SentinelManagedConnection.connect9s zz))$*=*=?QRRrF)disconnect_on_error push_requestrSrTc>[TU]UUUS9$![a8 URR(aUR 5 [ S5eef=f)N)disable_decodingrSrTz"The previous master is now a slave)r$r=r r"rD disconnectr )r&rVrSrTr(s rr='SentinelManagedConnection.read_response<sc 7(!1$7))   ##-- !%&JKK  s AA)r"r0r1)F)rrrrr%r5r?rHr:rboolr=r __classcell__r(s@rrrsU# 5 %S /4', &d^  tn rrc\rSrSrSrg)SentinelManagedSSLConnectionUrNrrrrr]r]Urrr]c,\rSrSrSrSrSrSrSrg)SentinelConnectionPoolProxyYc[R"U5UlX lX0lX@lXPlUR5 grB)weakrefrefconnection_pool_refrDr;r/sentinel_managerreset)r&r"rDr;r/rfs rr%$SentinelConnectionPoolProxy.__init__Zs5$+;;#? " 0( 0 rc SUlSUlgrB)master_addressslave_rr_counterrQs rrg!SentinelConnectionPoolProxy.resetis" $rcURRUR5nUR(a8URU:wa(XlUR 5nUbUR SS9 U$)NF)inuse_connections)rfdiscover_masterr/rDrjrerW)r&rjr"s rrE.SentinelConnectionPoolProxy.get_master_addressmse..>>t?P?PQ >>d11^C"0 #668O***U*Crc## URRUR5nU(aURc([R "S[ U5S- 5Ul[[ U55H5nURS-[ U5-UlXRnUv M7 UR5v [SUR<35e![a N%f=f7f)NrzNo slave found for ) rfdiscover_slavesr/rkrandomrandintlenrangerErr)r&slaves_rGs rrF)SentinelConnectionPoolProxy.rotate_slavesxs&&66t7H7HI $$,(.q#f+/(J%3v;')-)>)>)Bc&k(Q%445 (  ))+ +!#6t7H7H6K!LMM#   s*B/C-2CC- C*'C-)C**C-)r;rerDrjrfr/rkN) rrrrr%rgrErFrrrrr`r`Ys % Nrr`cf^\rSrSrSrU4SjrSrU4Sjr\S5r U4Sjr Sr S r S r U=r$) SentinelConnectionPoolz Sentinel backed connection pool. If ``check_connection`` flag is set to True, SentinelManagedConnection sends a PING command right after establishing the connection. c >URSURSS5(a[O[5US'URSS5UlURSS5Ul[ UURUR UUS9Ul[TU]$"S 0UD6 URURS'Xl X l g) Nconnection_classsslFrDTr;)r"rDr;r/rfr"r) getr#r]rrDr;r`proxyr$r%connection_kwargsr/rf)r&r/rfr'r(s rr%SentinelConnectionPool.__init__s%+ZZ ::eU++-. & !" K6 & +=u E0 nn!22%-    "6"48JJ01( 0rc UR(aSOSnS[U5RS[U5RSURSUS3 $)NmasterrGr+r,r-(z))>)rDr.rrr/)r&roles rr5SentinelConnectionPool.__repr__sR>>xwT %%&aT (;(;'<))*!D6 6 rcV>[TU]5 URR5 grB)r$rgr)r&r(s rrgSentinelConnectionPool.resets   rc.URR$rB)rrjrQs rrj%SentinelConnectionPool.master_addressszz(((rc>UR(+=(d8 UR=(a% URURUR4:Hn[ 5nU=(a UR U5$rB)rDrjr0r1r$owns_connection)r& connectioncheckparentr(s rr&SentinelConnectionPool.owns_connectionsZNN" NN Xt22z 6XX ;// ;;rc6URR5$rB)rrErQs rrE)SentinelConnectionPool.get_master_addressszz,,..rc6URR5$)zRound-robin slave balancer)rrFrQs rrF$SentinelConnectionPool.rotate_slavesszz''))r)r;rDrrfr/)rrrr__doc__r%r5rgpropertyrjrrErFrrZr[s@rr|r|s?1. ))</**rr|ch\rSrSrSrSSjrSrSrSrSr S r S r \ \ 4S jr\ \ 4S jrS rg)Sentinela Redis Sentinel cluster client >>> from redis.sentinel import Sentinel >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1) >>> master = sentinel.master_for('mymaster', socket_timeout=0.1) >>> master.set('foo', 'bar') >>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1) >>> slave.get('foo') b'bar' ``sentinels`` is a list of sentinel nodes. Each node is represented by a pair (hostname, port). ``min_other_sentinels`` defined a minimum number of peers for a sentinel. When querying a sentinel, if it doesn't meet this threshold, responses from that sentinel won't be considered valid. ``sentinel_kwargs`` is a dictionary of connection arguments used when connecting to sentinel instances. Any argument that can be passed to a normal Redis connection can be specified here. If ``sentinel_kwargs`` is not specified, any socket_timeout and socket_keepalive options specified in ``connection_kwargs`` will be used. ``connection_kwargs`` are keyword arguments that will be used when establishing a connection to a Redis server. Nc *Uc<UR5VVs0sHupgURS5(dMXg_M! nnnX0lUVV s/sHup[X40URD6PM sn nUlX lXPlX@lgs snnfs sn nf)Nsocket_)items startswithsentinel_kwargsr sentinelsmin_other_sentinelsr_force_master_ip) r&rrrforce_master_iprkvhostnamer1s rr%Sentinel.__init__s  "!2!8!8!:!:all9>U!:  /#, "+ ( 9D$8$8 9"+ $7 !2 /  sB B  "Bc>[URSS55nSUR5;aURS5 U(a1[R "UR 5R"U0UD6 gUR HnUR"U0UD6 M g)z Execute Sentinel command in sentinel nodes. once - If set to True, then execute the resulting command on a single node at random, rather than across the entire sentinel cluster. onceFT)rYrkeysr#rtchoicerexecute_command)r&argsr'rsentinels rrSentinel.execute_commands FJJvu-. V[[] " JJv   MM$.. ) 9 94 J6 J!NN(($9&9+rc/nURH7nURSRURR55 M9 S[ U5R S[ U5RSSRU5S3$)Nz {host}:{port}r+r,z (sentinels=[,z])>) rappend format_mapr"rr.rrjoin)r&sentinel_addressesrs rr5Sentinel.__repr__ sH  % %**8+C+C+U+UV ' T %%&aT (;(;'<388$678 = rcjUS(aUS(d US(agUSUR:agg)NrDis_sdownis_odownFznum-other-sentinelsT)r)r&stater/s rcheck_master_stateSentinel.check_master_states5[!U:%6% :K & '$*B*B BrcN[5n[UR5Hup4UR5nURU5nU(dM0URXq5(dMHUURSsURS'URU'URb UROUSnXS4s $ Sn [U5S:aSSRU53n [S U<U 35e![[ 4a"nUR USU<35 SnAMSnAff=f) z Asks sentinel servers for the Redis master's address corresponding to the service labeled ``service_name``. Returns a pair (address, port) or raises MasterNotFoundError if no master is found. z - Nripr1z : z, zNo master found for ) list enumeratersentinel_mastersr r rrrrrvrr) r&r/collected_errors sentinel_normasterserr error_infos rroSentinel.discover_masters1 6%.t~~%> !K "335KK -Eu00EENN1%?q!4>>+#>,,8))t =(('&?*  1 $tyy)9:; sC22D$DD$cz/nUH2nUS(d US(aMURUSUS45 M4 U$)z1Remove slaves that are in an ODOWN or SDOWN staterrrr1)r)r&rx slaves_aliverGs r filter_slavesSentinel.filter_slavesBsF EZ E*$5   teFm < =rcURH1nURU5nUR U5nU(dM/Us $ /$![[[4a MOf=f)z;Returns a list of alive slaves for service ``service_name``)rsentinel_slavesr r r r)r&r/rrxs rrsSentinel.discover_slavesKscH !11,?''/Fv ' $]LA  sAAAc SUS'[UR5nURU5 URU"X40UD65$)a Returns a redis client instance for the ``service_name`` master. A :py:class:`~redis.sentinel.SentinelConnectionPool` class is used to retrieve the master's address before establishing a new connection. NOTE: If the master's address has changed, any cached connections to the old master are closed. By default clients will be a :py:class:`~redis.Redis` instance. Specify a different class to the ``redis_class`` argument if you desire something different. The ``connection_pool_class`` specifies the connection pool to use. The :py:class:`~redis.sentinel.SentinelConnectionPool` will be used by default. All other keyword arguments are merged with any connection_kwargs passed to this class and passed to the connection pool as keyword arguments to be used to initialize Redis connections. TrDdictrupdate from_poolr&r/ redis_classconnection_pool_classr'rs r master_forSentinel.master_forWsN:#{ !7!78  ($$ !, J8I J  rc SUS'[UR5nURU5 URU"X40UD65$)a Returns redis client instance for the ``service_name`` slave(s). A SentinelConnectionPool class is used to retrieve the slave's address before establishing a new connection. By default clients will be a :py:class:`~redis.Redis` instance. Specify a different class to the ``redis_class`` argument if you desire something different. The ``connection_pool_class`` specifies the connection pool to use. The SentinelConnectionPool will be used by default. All other keyword arguments are merged with any connection_kwargs passed to this class and passed to the connection pool as keyword arguments to be used to initialize Redis connections. FrDrrs r slave_forSentinel.slave_for{sN0${ !7!78  ($$ !, J8I J  r)rrrrr)rNN)rrrrrr%rr5rrorrsrr|rrrrrrrrsR> 00"  !WF 4 " N4  rr)rtrctypingr redis.clientrredis.commandsrredis.connectionrrrredis.exceptionsr r r r redis.utilsr rrrr]r`r|rrrrrs +FFXX$ /   > >B #