U Ha3@spdZddlZddlZddlZddlZz ddlZWnek rHdZYnXz ddlZWnek rndZYnXz ddlZWnek rdZYnXze Wne k re Z YnXddddddgZ d Z dad d ZGd dde ZGd ddeZGdddeZGdddeZGdddeZGdddeZdZerHeZn$erTeZneZedk rleddS)zD A platform independent file lock that supports the with-statement. NTimeout BaseFileLockWindowsFileLock UnixFileLock SoftFileLockFileLockz3.0.12cCstp ttatS)z0Returns the logger instance used in this module.)_loggerlogging getLogger__name__r r ,/tmp/pip-unpacked-wheel-nk9nrq51/filelock.pyloggerLsrc@s eZdZdZddZddZdS)rzN Raised when the lock could not be acquired in *timeout* seconds. cCs ||_dS N) lock_file)selfrr r r __init__[szTimeout.__init__cCsd|j}|S)Nz)The file lock '{}' could not be acquired.)formatr)rtempr r r __str__bszTimeout.__str__N)r __module__ __qualname____doc__rrr r r r rUsc@s$eZdZddZddZddZdS)_Acquire_ReturnProxycCs ||_dSNlock)rrr r r rusz_Acquire_ReturnProxy.__init__cCs|jSrrrr r r __enter__ysz_Acquire_ReturnProxy.__enter__cCs|jdSr)rreleaserexc_type exc_value tracebackr r r __exit__|s z_Acquire_ReturnProxy.__exit__N)r rrrrr%r r r r rssrc@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)rNr) _lock_file _lock_file_fdtimeout threadingLock _thread_lock _lock_counter)rrr)r r r rs  zBaseFileLock.__init__cCs|jS)z, The path to the lock file. )r'rr r r rszBaseFileLock.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 r)szBaseFileLock.timeoutcCst||_dSr)floatr.)rvaluer r r r)s 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. Nr1rr r r _releaseszBaseFileLock._releasecCs |jdk S)z True, if the object holds the file lock. .. versionchanged:: 2.0.0 This was previously a method and is now a property. N)r(rr r r is_lockeds zBaseFileLock.is_lockedN皙?c Cs"|dkr|j}|j|jd7_W5QRXt|}|j}t}z|j$|jsltd||| W5QRX|jrt d||qqF|dkrt||krtd||t |jqFtd|||t |qFWn2|jt d|jd|_W5QRXYnXt|dS) 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 use an equivalent 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 acquiring lock %s on %sz2Lock %s not acquired on %s, waiting %s seconds ...r)r)r,r-idr'timer5rdebugr3inforsleepmaxr)rr)Zpoll_intervalllock_id lock_filename start_timer r r acquires<$ zBaseFileLock.acquireFc Cst|jd|jrf|jd8_|jdks*|rft|}|j}td|||d|_td||W5QRXdS)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. r7rz#Attempting to release lock %s on %szLock %s released on %sN) r,r5r-r8r'rr:r4r;)rforcer>r?r r r r %s zBaseFileLock.releasecCs ||Sr)rArr r r rBszBaseFileLock.__enter__cCs |dSrr r!r r r r%FszBaseFileLock.__exit__cCs|jdddS)NT)rBrCrr r r __del__Js zBaseFileLock.__del__)r&)Nr6)F)r rrrrpropertyrr)setterr3r4r5rAr rr%rDr r r r rs"      J c@s eZdZdZddZddZdS)rze Uses the :func:`msvcrt.locking` function to hard lock the lock file on windows systems. c Cs|tjtjBtjB}zt|j|}Wntk r8Yn@Xzt|tj dWn"t tfk rpt |YnX||_ dSNr7) osO_RDWRO_CREATO_TRUNCopenr'OSErrormsvcrtlockingZLK_NBLCKIOErrorcloser(rZ open_modefdr r r r3XszWindowsFileLock._acquirecCsP|j}d|_t|tjdt|zt|jWntk rJYnXdSrG) r(rNrOZLK_UNLCKrHrQremover'rMrrSr r r r4hs zWindowsFileLock._releaseNr rrrr3r4r r r r rRsc@s eZdZdZddZddZdS)rzR Uses the :func:`fcntl.flock` to hard lock the lock file on unix systems. c CsftjtjBtjB}t|j|}zt|tjtj BWn"t t fk rZt |YnX||_ dSr)rHrIrJrKrLr'fcntlflockZLOCK_EXZLOCK_NBrPrMrQr(rRr r r r3~szUnixFileLock._acquirecCs(|j}d|_t|tjt|dSr)r(rWrXZLOCK_UNrHrQrUr r r r4s  zUnixFileLock._releaseNrVr r r r rys c@s eZdZdZddZddZdS)rz8 Simply watches the existence of the lock file. c CsNtjtjBtjBtjB}zt|j|}Wnttfk rBYnX||_ dSr) rHO_WRONLYrJO_EXCLrKrLr'rPrMr(rRr r r r3szSoftFileLock._acquirecCs<t|jd|_zt|jWntk r6YnXdSr)rHrQr(rTr'rMrr r r r4s zSoftFileLock._releaseNrVr r r r rs z only soft file lock is available)rr rHr*r9warnings ImportErrorrNrW TimeoutError NameErrorrM__all__ __version__rrrobjectrrrrrrwarnr r r r sZ         R'!