a Ni1@s`dZddlZddlZddlZddlZz ddlZWneyFdZYn0z ddlZWneyjdZYn0z ddlZWneydZYn0ze Wne ye Z Yn0gdZ dZ daddZGddde ZGd d d eZGd d d eZGd ddeZGdddeZGdddeZdZer8eZn$erDeZneZedur\eddS)zD A platform independent file lock that supports the with-statement. N)Timeout BaseFileLockWindowsFileLock UnixFileLock SoftFileLockFileLockz3.0.12cCstp ttatS)z0Returns the logger instance used in this module.)_loggerloggingZ getLogger__name__r r X/home/james-whalen/.local/share/Steam/steamapps/common/Proton - Experimental/filelock.pyloggerLsr c@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)rZtempr r r __str__bszTimeout.__str__N)r __module__ __qualname____doc__rrr r r r rUsrc@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. 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)r&rr r r is_lockeds zBaseFileLock.is_lockedN皙?c Csb|dur|j}|j|jd7_Wdn1s80Yt|}|j}t}z|j.|jstd||| Wdn1s0Y|jrt d||q qZ|dkrt||krtd||t |jqZtd|||t |qZWnH|j"t d|jd|_Wdn1sF0YYn0t|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%timer3r debugr1inforsleepmaxr)rr'Zpoll_intervalllock_id lock_filenameZ start_timer r r acquires8$,& 2zBaseFileLock.acquireFcCs|jn|jrf|jd8_|jdks*|rft|}|j}td|||d|_td||Wdn1sz0YdS)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. r5rz#Attempting to release lock %s on %szLock %s released on %sN) r*r3r+r6r%r r8r2r9)rforcer<r=r r r r%s .zBaseFileLock.releasecCs ||Sr)r>rr r r rBszBaseFileLock.__enter__cCs |dSrrrr r r r#FszBaseFileLock.__exit__cCs|jdddS)NT)r?r@rr r r __del__Js zBaseFileLock.__del__)r$)Nr4)F)r rrrrpropertyrr'setterr1r2r3r>rrr#rAr r r r rs"      J 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||_ dSNr5) osO_RDWRO_CREATO_TRUNCopenr%OSErrormsvcrtlockingZLK_NBLCKIOErrorcloser&rZ open_modefdr r r r1Xs zWindowsFileLock._acquirecCsN|j}d|_t|tjdt|zt|jWntyHYn0dSrD) r&rKrLZLK_UNLCKrErNremover%rJrrPr r r r2hs  zWindowsFileLock._releaseNr rrrr1r2r 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)rErFrGrHrIr%fcntlflockLOCK_EXLOCK_NBrMrJrNr&rOr r r r1~szUnixFileLock._acquirecCs(|j}d|_t|tjt|dSr)r&rTrULOCK_UNrErNrRr r r r2s  zUnixFileLock._releaseNrSr r r r rys rc@s eZdZdZddZddZdS)rz8 Simply watches the existence of the lock file. c CsLtjtjBtjBtjB}zt|j|}Wnttfy@Yn0||_ dSr) rEO_WRONLYrGO_EXCLrHrIr%rMrJr&rOr r r r1szSoftFileLock._acquirecCs:t|jd|_zt|jWnty4Yn0dSr)rErNr&rQr%rJrr r r r2s  zSoftFileLock._releaseNrSr r r r rs rz only soft file lock is available)rr rEr(r7warnings ImportErrorrKrT TimeoutError NameErrorrJ__all__ __version__rr robjectrrrrrrwarnr r r r sN             R'!