o ;h9@sddlZddlZddlmZddlmZddlmZddlm Z m Z m Z ddl m Z mZmZmZddlmZGdd d e ZGd d d e ZGd d d e ZGdddee ZGdddZGddde ZGdddeZdS)N)Optional)Redis)SentinelCommands) ConnectionConnectionPool SSLConnection)ConnectionError ReadOnlyError ResponseError TimeoutError) str_if_bytesc@ eZdZdS)MasterNotFoundErrorN__name__ __module__ __qualname__rrA/var/www/html/venv/lib/python3.10/site-packages/redis/sentinel.pyr rc@r )SlaveNotFoundErrorNrrrrrrrrcsjeZdZfddZddZfddZddZd d Z dd d d d ee dee ffddZ Z S)SentinelManagedConnectionc s"|d|_tjdi|dS)Nconnection_poolr)poprsuper__init__)selfkwargs __class__rrrs z"SentinelManagedConnection.__init__cCsR|j}dt|jdt|jd|jd}|jr'd|jd|j}||}|S)N<. (service=z%s)>z,host=z,port=)rtyperr service_namehostport)rpoolsZ host_inforrr__repr__sz"SentinelManagedConnection.__repr__csH|\|_|_t|jjr |dt|dkr"t ddSdS)NZPINGZPONGz PING failed) r%r&rconnectrcheck_connectionZ send_commandr read_responser)raddressrrr connect_to$s   z$SentinelManagedConnection.connect_toc Cs\|jrdS|jjr||jdS|jD]}z||WSty+YqwtN)_sockr is_masterr.get_master_address rotate_slavesrr)rslaverrr_connect_retry,s z(SentinelManagedConnection._connect_retrycCs|j|jddS)NcSsdSr/r)errorrrr:sz3SentinelManagedConnection.connect..)retryZcall_with_retryr5rrrrr*9sz!SentinelManagedConnection.connectF)disconnect_on_error push_requestr:r;cs>z tj|||dWSty|jjr|tdw)N)disable_decodingr:r;z"The previous master is now a slave)rr,r rr1 disconnectr)rr<r:r;rrrr,<s z'SentinelManagedConnection.read_response)F) rrrrr)r.r5r*rboolr, __classcell__rrrrrs   rc@r )SentinelManagedSSLConnectionNrrrrrr@Urr@c@s,eZdZddZddZddZddZd S) SentinelConnectionPoolProxycCs0t||_||_||_||_||_|dSr/)weakrefrefconnection_pool_refr1r+r$sentinel_managerreset)rrr1r+r$rErrrrZs  z$SentinelConnectionPoolProxy.__init__cCsd|_d|_dSr/)master_addressslave_rr_counterr9rrrrFis z!SentinelConnectionPoolProxy.resetcCsD|j|j}|jr |j|kr ||_|}|dur |jdd|S)NF)Zinuse_connections)rEdiscover_masterr$r1rGrDr=)rrGrrrrr2ms z.SentinelConnectionPoolProxy.get_master_addressccs|j|j}|r5|jdurtdt|d|_tt|D]}|jdt||_||j}|Vq z|VWn t yEYnwt d|j)NrzNo slave found for ) rEdiscover_slavesr$rHrandomrandintlenranger2rr)rslaves_r4rrrr3xs   z)SentinelConnectionPoolProxy.rotate_slavesN)rrrrrFr2r3rrrrrAYs  rAcs\eZdZdZfddZddZfddZedd Zfd d Z d d Z ddZ Z S)SentinelConnectionPoolz Sentinel backed connection pool. If ``check_connection`` flag is set to True, SentinelManagedConnection sends a PING command right after establishing the connection. c s|d|ddr tnt|d<|dd|_|dd|_t||j|j||d|_tj d i||j|j d<||_ ||_ dS) NZconnection_classsslFr1Tr+)rr1r+r$rErr) getrr@rr1r+rAproxyrrconnection_kwargsr$rE)rr$rErrrrrs&   zSentinelConnectionPool.__init__c Cs:|jrdnd}dt|jdt|jd|jd|d S)NZmasterr4r r!r"(z))>)r1r#rrr$)rZrolerrrr)szSentinelConnectionPool.__repr__cst|jdSr/)rrFrUr9rrrrFs zSentinelConnectionPool.resetcCs|jjSr/)rUrGr9rrrrGsz%SentinelConnectionPool.master_addresscs4|j p|jo|j|j|jfk}t}|o||Sr/)r1rGr%r&rowns_connection)r connectioncheckparentrrrrXs z&SentinelConnectionPool.owns_connectioncC |jSr/)rUr2r9rrrr2s z)SentinelConnectionPool.get_master_addresscCr\)zRound-robin slave balancer)rUr3r9rrrr3s z$SentinelConnectionPool.rotate_slaves) rrr__doc__rr)rFpropertyrGrXr2r3r?rrrrrRs    rRc@sleZdZdZ   dddZddZdd Zd d Zd d ZddZ ddZ e e fddZ e e fddZdS)Sentinelar 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. rNc sJ|dur dd|D}|_fdd|D_|_|_|_dS)NcSs i|] \}}|dr||qS)Zsocket_) startswith).0kvrrr s z%Sentinel.__init__..cs$g|]\}}t||fijqSr)rsentinel_kwargs)rahostnamer&r9rr sz%Sentinel.__init__..)itemsre sentinelsmin_other_sentinelsrV_force_master_ip)rrirjreZforce_master_iprVrr9rrs   zSentinel.__init__cOsft|dd}d|vr|d|r#t|jj|i|dS|jD] }|j|i|q&dS)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)r>rTkeysrrLchoiceriexecute_command)rargsrrlsentinelrrrros   zSentinel.execute_commandcCsNg}|jD] }|d|jjqdt|jdt|jdd|dS)Nz {host}:{port}r r!z (sentinels=[,z])>) riappend format_maprrVr#rrjoin)rZsentinel_addressesrqrrrr) s  zSentinel.__repr__cCs2|dr |ds |drdS|d|jkrdSdS)Nr1is_sdownis_odownFznum-other-sentinelsT)rj)rstater$rrrcheck_master_states zSentinel.check_master_statec Cst}t|jD]X\}}z|}Wnttfy0}z||d|WYd}~qd}~ww||}|r`|||r`||jd|jd<|j|<|j durT|j n|d}||dfSqd} t |dkrqdd |} t d || ) 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 - Nripr&z : z, zNo master found for ) list enumerateriZsentinel_mastersrr rsrTryrkrNrur) rr$Zcollected_errorsZ sentinel_norqZmasterserxrz error_inforrrrIs0     zSentinel.discover_mastercCs:g}|D]}|ds|drq||d|dfq|S)z1Remove slaves that are in an ODOWN or SDOWN staterwrvrzr&)rs)rrPZ slaves_aliver4rrr filter_slavesBs zSentinel.filter_slavesc CsN|jD]!}z||}Wn tttfyYqw||}|r$|SqgS)z;Returns a list of alive slaves for service ``service_name``)riZsentinel_slavesrr r r)rr$rqrPrrrrKKs  zSentinel.discover_slavescK4d|d<t|j}||||||fi|S)a Returns a redis client instance for the ``service_name`` master. Sentinel client will detect failover and reconnect Redis clients automatically. 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. Tr1dictrVupdateZ from_poolrr$Z redis_classZconnection_pool_classrrVrrr master_forWs   zSentinel.master_forcKr)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. Fr1rrrrr slave_for}s   zSentinel.slave_for)rNN)rrrr]rror)ryrIrrKrrRrrrrrrr_s$  #  )r_)rLrBtypingrZ redis.clientrZredis.commandsrZredis.connectionrrrZredis.exceptionsrr r r Z redis.utilsr rrrr@rArRr_rrrrs    A0=