172 lines
17 KiB
Plaintext
172 lines
17 KiB
Plaintext
|
Ë
|
|||
|
|
KÀjÜ8 ã ó, — d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl
|
|||
|
|
m Z ddl m
|
|||
|
|
Z
|
|||
|
|
ddlmZmZmZmZ dd lmZmZmZmZ dd
|
|||
|
|
lmZ dd lmZ dd l m Z dd
|
|||
|
|
l m Z er2ddl Z ddl!m"Z" ddl#m$Z$ ddl%m&Z& e jN dk\ rddlm(Z( nddl)m(Z( ejT d« Z+e G d„ de« « Z, G d„ de,e
|
|||
|
|
« Z- G d„ d« Z. edd¬ « Z/ G d „ d e« Z0 G d „ dee0¬ « Z1 G d!„ d"ee1« Z2 G d#„ d$e e1« Z3 G d%„ d&e e1« Z4g d'¢Z5y)(z1An asyncio-based implementation of the file lock.é )Ú annotationsN)Ú dataclass)Úiscoroutinefunction)Úlocal)Ú
|
|||
|
|
TYPE_CHECKINGÚAnyÚNoReturnÚTypeVaré )Ú_UNSET_FILE_MODEÚ BaseFileLockÚFileLockContextÚ FileLockMeta)ÚTimeout)Ú SoftFileLock)Ú UnixFileLock)ÚWindowsFileLock)ÚCallable)Úfutures)Ú
|
|||
|
|
TracebackType)é é )ÚSelfÚfilelockc ó< — e Zd ZU dZdZded< dZded< dZded < y)
|
|||
|
|
ÚAsyncFileLockContextzGA dataclass which holds the context for a ``BaseAsyncFileLock`` object.TÚboolÚrun_in_executorNúfutures.Executor | NoneÚexecutorú asyncio.AbstractEventLoop | NoneÚloop)Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r Ú__annotations__r r" © ó úS/home/antigravity/intellecton/venv/lib/python3.12/site-packages/filelock/asyncio.pyr r $ s+ … áQð !€O�TÓ ð )-€HÐ%Ó,ð .2€DÐ
|
|||
|
|
*Ô1r) r c ó — e Zd ZdZy)ÚAsyncThreadLocalFileContextz8A thread local version of the ``FileLockContext`` class.N©r# r$ r% r& r( r) r* r, r, 2 s „ ÚBr) r, c ó8 — e Zd ZdZdd„Zdd„Z dd„Zy) ÚAsyncAcquireReturnProxyzDA context-aware object that will release the lock file when exiting.c ó — || _ y ©N©Úlock)Úselfr3 s r* Ú__init__z AsyncAcquireReturnProxy.__init__9 s € ؈� r) c ƒ ó" K — | j S wr1 r2 ©r4 s r* Ú
|
|||
|
|
__aenter__z"AsyncAcquireReturnProxy.__aenter__< s è ø€ Ø�y‰yÐùs ‚
|
|||
|
|
c ƒ óT K — | j j « ƒ d { –—† y 7 Œwr1 )r3 Úrelease©r4 Úexc_typeÚ exc_valueÚ tracebacks r* Ú __aexit__z!AsyncAcquireReturnProxy.__aexit__? s è ø€ ð �i‰i× Ñ Ó!×!Ò!ús ‚ ( &¡(N)r3 ÚBaseAsyncFileLockÚreturnÚNone)rA r@ ©r< útype[BaseException] | Noner= úBaseException | Noner> zTracebackType | NonerA rB )r# r$ r% r& r5 r8 r? r( r) r* r/ r/ 6 s: „ ÙNóóð"à,ð"ð (ð"ð (ð "ð
|
|||
|
|
|
|||
|
|
ô "r) r/ Ú_ATr@ )Úboundc ól ‡ — e Zd Zdedfddddddddœ dˆ fd„Zˆ xZS ) ÚAsyncFileLockMetaéÿÿÿÿFTçš™™™™™©?N©ÚblockingÚ is_singletonÚ
|
|||
|
|
poll_intervalÚlifetimer" r r c
|
|||
|
|
óZ •— |r|
|
|||
|
|
r
|
|||
|
|
d} t | « ‚t ‰
|
|||
|
|
| � ||||||||| |
|
|||
|
|
| ¬« S )Nz:run_in_executor is not supported when thread_local is True) Ú lock_fileÚtimeoutÚmodeÚ thread_localrM rN rO rP r" r r )Ú
|
|||
|
|
ValueErrorÚsuperÚ__call__)ÚclsrR rS rT rU rM rN rO rP r" r r ÚmsgÚ __class__s €r* rX zAsyncFileLockMeta.__call__L sQ ø€ ñ ™OØNˆCÜ ˜S“/Ð !܉wÑ Ø ØØØ%Ø Ø%Ø'Ø ØØ +Ø ð ó
|
|||
|
|
ð
|
|||
|
|
r) )rY z type[_AT]rR ústr | os.PathLike[str]rS ÚfloatrT ÚintrU r rM r rN r rO r] rP ú float | Noner" r! r r r r rA rF )r# r$ r% r rX Ú
|
|||
|
|
__classcell__)r[ s @r* rI rI K s² ø„ ð Ø$Ø "ð
|
|||
|
|
ð Ø "Ø #Ø!%Ø15Ø $Ø,0ñ
|
|||
|
|
Ø
|
|||
|
|
ð
|
|||
|
|
à)ð
|
|||
|
|
ð ð
|
|||
|
|
ð ð
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ð ð
|
|||
|
|
ð ð
|
|||
|
|
ð ð
|
|||
|
|
ð ð
|
|||
|
|
ð /ð
|
|||
|
|
ð ð
|
|||
|
|
ð *ð
|
|||
|
|
ð
|
|||
|
|
|
|||
|
|
÷
|
|||
|
|
ñ
|
|||
|
|
r) rI c ó> — e Zd ZdZdedfddddddddœ dd„Zedd „« Zedd
|
|||
|
|
„« Zej dd „« Zedd „« Z
|
|||
|
|
dddd
|
|||
|
|
œ d d„Z d d d„Z d d„Z
|
|||
|
|
d d„Z d!d„Zd"d„Z d#d„Zd$d„Zy)%r@ zP
|
|||
|
|
Base class for asynchronous file locks.
|
|||
|
|
|
|||
|
|
.. versionadded:: 3.15.0
|
|||
|
|
|
|||
|
|
rJ FTrK NrL c
|
|||
|
|
ó� — || _ || _ t j |« |||||| |
|
|||
|
|
| dœ } |rt nt
|
|||
|
|
di | ¤Ž| _ y)a¢
|
|||
|
|
Create a new lock object.
|
|||
|
|
|
|||
|
|
:param lock_file: path to the file
|
|||
|
|
:param timeout: default timeout when acquiring the lock, in seconds. It will be used as fallback value in the
|
|||
|
|
acquire method, if no timeout value (``None``) is given. If you want to disable the timeout, set it to a
|
|||
|
|
negative value. A timeout of 0 means that there is exactly one attempt to acquire the file lock.
|
|||
|
|
:param mode: file permissions for the lockfile. When not specified, the OS controls permissions via umask and
|
|||
|
|
default ACLs, preserving POSIX default ACL inheritance in shared directories.
|
|||
|
|
:param thread_local: Whether this object's internal context should be thread local or not. If this is set to
|
|||
|
|
``False`` then the lock will be reentrant across threads.
|
|||
|
|
:param blocking: whether the lock should be blocking or not
|
|||
|
|
:param is_singleton: If this is set to ``True`` then only one instance of this class will be created per lock
|
|||
|
|
file. This is useful if you want to use the lock object for reentrant locking without needing to pass the
|
|||
|
|
same object around.
|
|||
|
|
:param poll_interval: default interval for polling the lock file, in seconds. It will be used as fallback value
|
|||
|
|
in the acquire method, if no poll_interval value (``None``) is given.
|
|||
|
|
:param lifetime: maximum time in seconds a lock can be held before it is considered expired. When set, a waiting
|
|||
|
|
process will break a lock whose file modification time is older than ``lifetime`` seconds. ``None`` (the
|
|||
|
|
default) means locks never expire.
|
|||
|
|
:param loop: The event loop to use. If not specified, the running event loop will be used.
|
|||
|
|
:param run_in_executor: If this is set to ``True`` then the lock will be acquired in an executor.
|
|||
|
|
:param executor: The executor to use. If not specified, the default executor will be used.
|
|||
|
|
|
|||
|
|
) rR rS rT rM rO rP r" r r Nr( )Ú_is_thread_localÚ
|
|||
|
|
_is_singletonÚosÚfspathr, r Ú_context)
|
|||
|
|
r4 rR rS rT rU rM rN rO rP r" r r Úkwargss
|
|||
|
|
r* r5 zBaseAsyncFileLock.__init__u sa € ðP !-ˆÔ Ø )ˆÔô
|
|||
|
|
Ÿ™ 9Ó-Ø ØØ Ø *Ø ØØ .Ø ñ
|
|||
|
|
"
|
|||
|
|
ˆð 0uÉlÕ/JÔ`tñ /
|
|||
|
|
Øñ/
|
|||
|
|
ˆ�
|
|||
|
|
r) c ó. — | j j S )z":returns: whether run in executor.)rg r r7 s r* r z!BaseAsyncFileLock.run_in_executor± s € ð �}‰}×,Ñ,Ð,r) c ó. — | j j S )z:returns: the executor.©rg r r7 s r* r zBaseAsyncFileLock.executor¶ s € ð �}‰}×%Ñ%Ð%r) c ó& — || j _ y)zs
|
|||
|
|
Change the executor.
|
|||
|
|
|
|||
|
|
:param futures.Executor | None value: the new executor or ``None``
|
|||
|
|
|
|||
|
|
Nrk )r4 Úvalues r* r zBaseAsyncFileLock.executor» s € ð "'ˆ�
|
|||
|
|
‰
|
|||
|
|
Õ r) c ó. — | j j S )z:returns: the event loop.)rg r" r7 s r* r" zBaseAsyncFileLock.loopÅ s € ð �}‰}×!Ñ!Ð!r) )rM Ú cancel_checkc ƒ ó| K — |€| j j }|€| j j }|€| j j }| j xj dz
|
|||
|
|
c_ t | « }| j }t j « } | j sJ| j « t j d||« | j | j « ƒ d{ –—† | j rt j d||« nZ| j ||||||¬« r t! |« ‚d}t j ||||« t# j$ |« ƒ d{ –—† ŒÔ t+ | ¬« S 7 Œ�7 Œ# t& $ r4 t) d| j j dz
|
|||
|
|
« | j _ ‚ w xY ww) a„
|
|||
|
|
Try to acquire the file lock.
|
|||
|
|
|
|||
|
|
:param timeout: maximum wait time for acquiring the lock, ``None`` means use the default
|
|||
|
|
:attr:`~BaseFileLock.timeout` is and if ``timeout < 0``, there is no timeout and this method will block
|
|||
|
|
until the lock could be acquired
|
|||
|
|
:param poll_interval: interval of trying to acquire the lock file, ``None`` means use the default
|
|||
|
|
:attr:`~BaseFileLock.poll_interval`
|
|||
|
|
:param blocking: defaults to True. If False, function will return immediately if it cannot obtain a lock on the
|
|||
|
|
first attempt. Otherwise, this method will block until the timeout expires or the lock is acquired.
|
|||
|
|
:param cancel_check: a callable returning ``True`` when the acquisition should be canceled. Checked on each poll
|
|||
|
|
iteration. When triggered, raises :class:`~Timeout` just like an expired timeout.
|
|||
|
|
|
|||
|
|
:returns: a context object that will unlock the file when the context is exited
|
|||
|
|
|
|||
|
|
:raises Timeout: if fails to acquire lock within the timeout period
|
|||
|
|
|
|||
|
|
.. code-block:: python
|
|||
|
|
|
|||
|
|
# You can use this method in the context manager (recommended)
|
|||
|
|
with lock.acquire():
|
|||
|
|
pass
|
|||
|
|
|
|||
|
|
# Or use an equivalent try-finally construct:
|
|||
|
|
lock.acquire()
|
|||
|
|
try:
|
|||
|
|
pass
|
|||
|
|
finally:
|
|||
|
|
lock.release()
|
|||
|
|
|
|||
|
|
Nr z#Attempting to acquire lock %s on %szLock %s acquired on %s)rM ro rS Ú
|
|||
|
|
start_timez2Lock %s not acquired on %s, waiting %s seconds ...r r2 )rg rS rM rO Ú lock_counterÚidrR ÚtimeÚ perf_counterÚ is_lockedÚ_try_break_expired_lockÚ_LOGGERÚdebugÚ_run_internal_methodÚ_acquireÚ_check_give_upr ÚasyncioÚsleepÚ
|
|||
|
|
BaseExceptionÚmaxr/ ) r4 rS rO rM ro Úlock_idÚ
|
|||
|
|
lock_filenamerq rZ s r* ÚacquirezBaseAsyncFileLock.acquireÊ s� è ø€ ðP ˆ?Ø—m‘m×+Ñ+ˆGà Ð Ø—}‘}×-Ñ-ˆHà Ð Ø ŸM™M× 7Ñ 7ˆMð
|
|||
|
|
�
|
|||
|
|
‰
|
|||
|
|
×"Ò" aÑ'Õ"ä�T“(ˆØ Ÿ™ˆ
|
|||
|
|
Ü×&Ñ&Ó(ˆ
|
|||
|
|
ð ØØ—~’~Ø×0Ñ0Ô2Ü—M‘MÐ"GÈÐR_Ô`Ø ×3Ñ3°D·M±MÓB×BÐBØ—>’>Ü—M‘MÐ":¸GÀ]ÔSØØ×&Ñ&ØØ!Ø %Ø!-Ø #Ø )ð
|
|||
|
|
'ô ô " -Ó0Ð0ØJ�Ü—
|
|||
|
|
‘
|
|||
|
|
˜c 7¨M¸=ÔIÜ —m‘m MÓ2×2Ð2ð' ð ô '¨DÔ1Ð1ð' Cøð 3ùÜ ò Ü),¨Q°·
|
|||
|
|
±
|
|||
|
|
×0JÑ0JÈQÑ0NÓ)OˆD�M‰MÔ &Ø ð üsD ‚BF<ÂAE< Ã(E8Ã)A<E< Å%E:Å&E< Å+
|
|||
|
|
F<Å8E< Å:E< Å<=F9Æ9F<c ƒ ó’ K — | j rµ| j xj dz c_ | j j dk( s|rzt | « | j }}t
|
|||
|
|
j
|
|||
|
|
d||« | j | j « ƒ d{ –—† d| j _ t
|
|||
|
|
j
|
|||
|
|
d||« yyy7 Œ/w)a
|
|||
|
|
Release the file lock. The lock is only completely released when the lock counter reaches 0. The lock file
|
|||
|
|
itself is not automatically deleted.
|
|||
|
|
|
|||
|
|
:param force: If true, the lock counter is ignored and the lock is released in every case.
|
|||
|
|
|
|||
|
|
r r z#Attempting to release lock %s on %sNzLock %s released on %s) rv rg rr rs rR rx ry rz Ú_release)r4 Úforcer� r‚ s r* r: zBaseAsyncFileLock.release sž è ø€ ð �>Š>Ø �M‰M× &Ò &¨!Ñ +Õ &à�}‰}×)Ñ)¨QÒ.±%Ü)+¨D«°4·>±>˜ �ä—
|
|||
|
|
‘
|
|||
|
|
Ð CÀWÈmÔ\Ø×/Ñ/°·
|
|||
|
|
±
|
|||
|
|
Ó>×>Ð>Ø-.�—
|
|||
|
|
‘
|
|||
|
|
Ô*Ü—
|
|||
|
|
‘
|
|||
|
|
Ð 6¸À ÕOð
|
|||
|
|
38ð ð ?ús ‚BCÂCÂ0Cc ƒ óÞ K — t |« r |« ƒ d { –—† y | j r7t j « j | j |« ƒ d { –—† y |« y 7 ŒP7 Œwr1 )r r r} Úget_running_loopr )r4 Úmethods r* rz z&BaseAsyncFileLock._run_internal_method. sQ è ø€ Ü ˜vÔ &Ù“(�N‰NØ
|
|||
|
|
×
|
|||
|
|
!Ò
|
|||
|
|
!Ü×*Ñ*Ó,×<Ñ<¸T¿]¹]ÈFÓS× SÑ Sá �Hð
|
|||
|
|
øà Sús" ‚A-˜A)™AA-ÁA+Á A-Á+A-c ó — d}t |« ‚)zTSync context manager entry is not supported because lock acquisition is a coroutine.õd Use `async with` — acquire/release are coroutines and cannot be awaited in a sync context manager.©ÚNotImplementedError)r4 rZ s r* Ú __enter__zBaseAsyncFileLock.__enter__6 s € àtˆÜ! #Ó&Ð&r) c ó — d}t |« ‚)zOSync context manager exit is not supported because lock release is a coroutine.r‹ rŒ )r4 r< r= r> rZ s r* Ú__exit__zBaseAsyncFileLock.__exit__; s € ð uˆÜ! #Ó&Ð&r) c ƒ óB K — | j « ƒ d{ –—† | S 7 Œw)zG
|
|||
|
|
Acquire the lock.
|
|||
|
|
|
|||
|
|
:returns: the lock object
|
|||
|
|
|