a *a1@sNdZddlZddlZddlZddlZz ddlZWneyFdZYn0z ddlZWneyjdZYn0z ddlZWneydZYn0ze Wne ye Z Yn0gdZ dZ eeZGddde ZGdddeZGd d d eZGd d d eZGd ddeZdZer&eZn$er2eZneZedurJeddS)zD A platform independent file lock that supports the with-statement. N)Timeout BaseFileLockWindowsFileLock UnixFileLock SoftFileLockFileLockz2.0.8c@s eZdZdZddZddZdS)rzN Raised when the lock could not be acquired in *timeout* seconds. cCs ||_dS N) lock_file)selfr r Blib/python3.9/site-packages/navigator_updater/external/filelock.py__init__QszTimeout.__init__cCsd|j}|S)Nz)The file lock '{}' could not be acquired.)formatr )r Ztempr r r __str__XszTimeout.__str__N)__name__ __module__ __qualname____doc__rrr r r r rKsrc@seZdZdZdddZeddZeddZejd dZd d Z d d Z eddZ dddZ dddZ ddZddZddZdS) rz3 Implements the base class of a file lock. cCs&||_d|_||_t|_d|_dS)r Nr) _lock_file _lock_file_fdtimeout threadingZLock _thread_lock _lock_counter)r r rr r r res  zBaseFileLock.__init__cCs|jS)z, The path to the lock file. )rr r r r r }szBaseFileLock.lock_filecCs|jS)a~ You can set a default timeout for the filelock. 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. .. versionadded:: 2.0.0 )_timeoutrr r r rszBaseFileLock.timeoutcCst||_dSr)floatr)r valuer r r rs cCs tdS)z Platform dependent. If the file lock could be acquired, self._lock_file_fd holds the file descriptor of the lock file. NNotImplementedErrorrr r r _acquireszBaseFileLock._acquirecCs tdS)zH Releases the lock and sets self._lock_file_fd to None. Nr rr r r _releaseszBaseFileLock._releasecCs |jduS)z True, if the object holds the file lock. .. versionchanged:: 2.0.0 This was previously a method and is now a property. N)rrr r r is_lockeds zBaseFileLock.is_lockedN皙?c Csj|dur|j}|j|jd7_Wdn1s80Yzt}t|}|j}|j,|js~td||| Wdn1s0Y|jrt d||qqL|dkrt||krtd||t |jqLtd|||t |qLWnH|j"t d|jd|_Wdn1s>0YYn0Gdd d t}||d S) aY Acquires the file lock or fails with a :exc:`Timeout` error. .. code-block:: python # You can use this method in the context manager (recommended) with lock.acquire(): pass # Or you use an equal try-finally construct: lock.acquire() try: pass finally: lock.release() :arg float timeout: The maximum time waited for the file lock. If ``timeout <= 0``, there is no timeout and this method will block until the lock could be acquired. If ``timeout`` is None, the default :attr:`~timeout` is used. :arg float poll_intervall: We check once in *poll_intervall* seconds if we can acquire the file lock. :raises Timeout: if the lock could not be acquired in *timeout* seconds. .. versionchanged:: 2.0.0 This method returns now a *proxy* object instead of *self*, so that it can be used in a with statement without side effects. Nz#Attempting to acquire lock %s on %szLock %s acquired on %srz!Timeout on aquiring lock %s on %sz2Lock %s not acquired on %s, waiting %s seconds ...c@s$eZdZddZddZddZdS)z)BaseFileLock.acquire..ReturnProxycSs ||_dSNlock)r r)r r r rsz2BaseFileLock.acquire..ReturnProxy.__init__cSs|jSr'r(rr r r __enter__sz3BaseFileLock.acquire..ReturnProxy.__enter__cSs|jdSr')r)releaser exc_type exc_value tracebackr r r __exit__s z2BaseFileLock.acquire..ReturnProxy.__exit__N)rrrrr*r0r r r r ReturnProxysr1r()rrrtimeidrr$loggerdebugr"inforsleepmaxobject)r rZpoll_intervallZ start_timelock_id lock_filenamer1r r r acquiresJ$,& 2 zBaseFileLock.acquireFcCs|jj|jrb|jd8_|jdks*|rbt|}|j}td|||d|_td||Wdn1sv0YdS)aV Releases the file lock. Please note, that the lock is only completly released, if the lock counter is 0. Also note, that the lock file itself is not automatically deleted. :arg bool force: If true, the lock counter is ignored and the lock is released in every case. r&rz#Attempting to release lock %s on %szLock %s released on %sN) rr$rr3rr4r5r#r6)r forcer:r;r r r r+s "zBaseFileLock.releasecCs ||Sr')r<rr r r r*AszBaseFileLock.__enter__cCs |dSr'r+r,r r r r0EszBaseFileLock.__exit__cCs|jdddS)NT)r=r>rr r r __del__Is zBaseFileLock.__del__)r)Nr%)F)rrrrrpropertyr rsetterr"r#r$r<r+r*r0r?r r r r r`s"      e "rc@s eZdZdZddZddZdS)rze Uses the :func:`msvcrt.locking` function to hard lock the lock file on windows systems. c CsxtjtjBtjB}zt|j|}Wnty6Yn>0zt|tj dWn t tfylt |Yn0||_ dSNr&) osO_RDWRO_CREATO_TRUNCopenrOSErrormsvcrtlockingZLK_NBLCKIOErrorcloserr Z open_modefdr r r r"Xs zWindowsFileLock._acquirecCsN|j}d|_t|tjdt|zt|jWntyHYn0dSrB) rrIrJZLK_UNLCKrCrLremoverrHr rNr r r r#hs  zWindowsFileLock._releaseNrrrrr"r#r r r r rRsrc@s eZdZdZddZddZdS)rzR Uses the :func:`fcntl.flock` to hard lock the lock file on unix systems. c CsdtjtjBtjB}t|j|}zt|tjtj BWn t t fyXt |Yn0||_ dSr')rCrDrErFrGrfcntlflockZLOCK_EXZLOCK_NBrKrHrLrrMr r r r"szUnixFileLock._acquirecCs(|j}d|_t|tjt|dSr')rrRrSZLOCK_UNrCrLrPr r r r#s  zUnixFileLock._releaseNrQr r r r r{s rc@s eZdZdZddZddZdS)rz8 Simply watches the existence of the lock file. c CsLtjtjBtjBtjB}zt|j|}Wnttfy@Yn0||_ dSr') rCO_WRONLYrEO_EXCLrFrGrrKrHrrMr r r r"szSoftFileLock._acquirecCs:t|jd|_zt|jWnty4Yn0dSr')rCrLrrOrrHrr r r r#s  zSoftFileLock._releaseNrQr r r r rs rz only soft file lock is available)rZloggingrCrr2warnings ImportErrorrIrR TimeoutError NameErrorrH__all__ __version__Z getLoggerrr4rr9rrrrrwarnr r r r sJ            s)!