(phU,NSSKrSSKrSSKrSSKJrJr SSKJr "SS\ 5r g)N) LockErrorLockNotOwnedError)dummyc\rSrSrSrSrSrSrSrSr Sr SSjr Sr S r S rSS jrS rS rSrSrSrSSjrSrSrSrSrg)Lockz A shared, distributed Lock. Using Redis for locking allows the Lock to be shared across processes and/or machines. It's left to the user to resolve deadlock issues and make sure multiple clients play nicely together. Nz local token = redis.call('get', KEYS[1]) if not token or token ~= ARGV[1] then return 0 end redis.call('del', KEYS[1]) return 1 a local token = redis.call('get', KEYS[1]) if not token or token ~= ARGV[1] then return 0 end local expiration = redis.call('pttl', KEYS[1]) if not expiration then expiration = 0 end if expiration < 0 then return 0 end local newttl = ARGV[2] if ARGV[3] == "0" then newttl = ARGV[2] + expiration end redis.call('pexpire', KEYS[1], newttl) return 1 z local token = redis.call('get', KEYS[1]) if not token or token ~= ARGV[1] then return 0 end redis.call('pexpire', KEYS[1], ARGV[2]) return 1 cXlX lX0lX@lXPlX`l[ U5UlUR(a[R"5O [5Ul SURl UR5 g)aH Create a new Lock instance named ``name`` using the Redis client supplied by ``redis``. ``timeout`` indicates a maximum life for the lock. By default, it will remain locked until release() is called. ``timeout`` can be specified as a float or integer, both representing the number of seconds to wait. ``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. ``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) redisnametimeoutsleepblockingblocking_timeoutbool thread_local threadinglocalrtokenregister_scripts)selfr r r r rrrs =/var/www/html/venv/lib/python3.13/site-packages/redis/lock.py__init__ Lock.__init__Isch     0 .*.*;*;Y__&   cDURnURnURc URUR5UlUR c URUR 5UlURc!URUR5UlggN) __class__r lua_releaseregister_scriptLUA_RELEASE_SCRIPT lua_extendLUA_EXTEND_SCRIPT lua_reacquireLUA_REACQUIRE_SCRIPT)rclsclients rrLock.register_scriptssnn ?? "$44S5K5KLCO >> !#33C4I4IJCN    $&&s'?'?@   %rcDURSS9(aU$[S5e)NT)rz0Unable to acquire lock within the time specified)acquirerrs r __enter__Lock.__enter__s# <<< &KJKKrc$UR5 gr)release)rexc_type exc_value tracebacks r__exit__ Lock.__exit__s  rc.URnUc.[R"5RR 5nO5UR R R5nUR U5nUc URnUc URnSnUb[R"5U-nURU5(aX0RlgU(dg[R"5U-nUbXv:ag[R"U5 Mh)a Use Redis to hold a shared, distributed lock named ``name``. Returns True once the lock is acquired. If ``blocking`` is False, always return immediately. If the lock was acquired, return True, otherwise return False. ``blocking_timeout`` specifies the maximum number of seconds to wait trying to acquire the lock. ``token`` specifies the token value to be used. If provided, token must be a bytes object or a string that can be encoded to a bytes object with the default encoding. If a token isn't specified, a UUID will be generated. NTF)r uuiduuid1hexencoder connection_pool get_encoderrrmod_timetime do_acquirerr)rrrrr encoderstop_trying_at next_try_ats rr) Lock.acquires   =JJL$$++-Ejj00<<>GNN5)E  }}H  ##44   '%]]_/??Nu%%#(  "--/E1K)k.J NN5 !rcUR(a[URS-5nOSnURRURUSUS9(agg)NT)nxpxF)r intr setr )rrr s rr=Lock.do_acquiresC <<$,,-.GG ::>>$))Ut> @rcPURRUR5SL$)zE Returns True if this key is locked by any process, otherwise False. N)r getr r*s rlocked Lock.lockeds zz~~dii(44rc\URRUR5nU(aJ[U[5(d5URR R 5nURU5nURRSL=(a XRR:H$)zC Returns True if this key is locked by this lock, otherwise False. N) r rJr isinstancebytesr9r:r8rr)r stored_tokenr>s rowned Lock.owneds}zz~~dii0   < ? ?jj00<<>G">>,7Lzzt+- JJ,, , -rcURRnUc [S5eSURlURU5 g)z"Releases the already acquired lockNzCannot release an unlocked lock)rrr do_releaserexpected_tokens rr. Lock.releases;))  !=> >  'rc[URUR/U/URS95(d [ S5eg)Nkeysargsr&z,Cannot release a lock that's no longer owned)rrr r rrUs rrTLock.do_releasesOD$$499++9*:,0JJ%899$%>? ?9rcURRc [S5eURc [S5eUR X5$)a0 Adds more time to an already acquired lock. ``additional_time`` can be specified as an integer or a float, both representing the number of seconds to add. ``replace_ttl`` if False (the default), add `additional_time` to the lock's existing ttl. If True, replace the lock's ttl with `additional_time`. zCannot extend an unlocked lockz$Cannot extend a lock with no timeout)rrrr do_extendradditional_time replace_ttls rextend Lock.extendsE ::   #<= = << BC C~~o;;rc [US-5n[URUR/URR UU=(a S=(d S/UR S95(d [S5eg)NrC10rYz+Cannot extend a lock that's no longer ownedT)rFrr!r rrr rr_s rr^Lock.do_extendszo45 OOii[JJ$$#'C.3 zz     $@ rcURRc [S5eURc [S5eUR 5$)zC Resets a TTL of an already acquired lock back to a timeout value. z!Cannot reacquire an unlocked lockz'Cannot reacquire a lock with no timeout)rrrr do_reacquirer*s r reacquireLock.reacquiresE ::   #?@ @ << EF F  ""rc[URS-5n[URUR/UR R U/URS95(d [S5eg)NrCrYz.Cannot reacquire a lock that's no longer ownedT) rFr rr#r rrr r)rr s rriLock.do_reacquiresldllT)*D&&TYYK-1ZZ-=-=w,G.2jj':;;$%78 8r)rrrr r r rr )Ng?TNT)NNN)F)__name__ __module__ __qualname____firstlineno____doc__rr!r#r r"r$rrr+r2r)r=rKrQr.rTrbr^rjri__static_attributes__rrrrsKJM 29rxs" 9]6]r