ó –ù\c@sÑdZddlZddlZddlZddlZyddlZWnek r_dZnXyddlZWnek r‰dZnXyddl Z Wnek r³dZ nXye Wne k rÕe Z nXddddddgZ d Zdad „Zde fd „ƒYZd efd „ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdZerœeZn1e r«eZn"eZedk rÍejdƒndS(sD A platform independent file lock that supports the with-statement. iÿÿÿÿNtTimeoutt BaseFileLocktWindowsFileLockt UnixFileLockt SoftFileLocktFileLocks3.0.12cCstptjtƒatS(s0Returns the logger instance used in this module.(t_loggertloggingt getLoggert__name__(((s'lib/python2.7/site-packages/filelock.pytloggerLscBs eZdZd„Zd„ZRS(sN Raised when the lock could not be acquired in *timeout* seconds. cCs ||_dS(s N(t lock_filetNone(tselfR ((s'lib/python2.7/site-packages/filelock.pyt__init__[s cCsdj|jƒ}|S(Ns)The file lock '{}' could not be acquired.(tformatR (R ttemp((s'lib/python2.7/site-packages/filelock.pyt__str__bs (R t __module__t__doc__RR(((s'lib/python2.7/site-packages/filelock.pyRUs t_Acquire_ReturnProxycBs#eZd„Zd„Zd„ZRS(cCs ||_dS(N(tlockR (R R((s'lib/python2.7/site-packages/filelock.pyRus cCs|jS(N(R(R ((s'lib/python2.7/site-packages/filelock.pyt __enter__yscCs|jjƒdS(N(RtreleaseR (R texc_typet exc_valuet traceback((s'lib/python2.7/site-packages/filelock.pyt__exit__|s (R RRRR(((s'lib/python2.7/site-packages/filelock.pyRss  cBs¡eZdZdd„Zed„ƒZed„ƒZejd„ƒZd„Zd„Z ed„ƒZ dd d „Z e d „Zd „Zd „Zd„ZRS(s3 Implements the base class of a file lock. iÿÿÿÿcCs7||_d|_||_tjƒ|_d|_dS(s iN(t _lock_fileR t _lock_file_fdttimeoutt threadingtLockt _thread_lockt _lock_counter(R R R((s'lib/python2.7/site-packages/filelock.pyR†s     cCs|jS(s, The path to the lock file. (R(R ((s'lib/python2.7/site-packages/filelock.pyR žscCs|jS(s~ 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 (t_timeout(R ((s'lib/python2.7/site-packages/filelock.pyR¥scCst|ƒ|_dS(s N(tfloatR#R (R tvalue((s'lib/python2.7/site-packages/filelock.pyRµscCs tƒ‚dS(s˜ Platform dependent. If the file lock could be acquired, self._lock_file_fd holds the file descriptor of the lock file. N(tNotImplementedError(R ((s'lib/python2.7/site-packages/filelock.pyt_acquire¿scCs tƒ‚dS(sH Releases the lock and sets self._lock_file_fd to None. N(R&(R ((s'lib/python2.7/site-packages/filelock.pyt_releaseÇscCs |jdk S(sž True, if the object holds the file lock. .. versionchanged:: 2.0.0 This was previously a method and is now a property. N(RR (R ((s'lib/python2.7/site-packages/filelock.pyt is_lockedÐs gš™™™™™©?c Cs{|dkr|j}n|j|jd7_WdQXt|ƒ}|j}tjƒ}yàxÙtr6|j1|jsšt ƒj d||ƒ|j ƒnWdQX|jrÃt ƒj d||ƒPq^|dkr tjƒ||kr t ƒj d||ƒt |jƒ‚q^t ƒj d|||ƒtj|ƒq^WWn3|jtd|jdƒ|_WdQX‚nXtd|ƒS( sY 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. iNs#Attempting to acquire lock %s on %ssLock %s acquired on %sis"Timeout on acquiring lock %s on %ss2Lock %s not acquired on %s, waiting %s seconds ...R(R RR!R"tidRttimetTrueR)R tdebugR'tinfoRtsleeptmaxR(R Rtpoll_intervalltlock_idt lock_filenamet start_time((s'lib/python2.7/site-packages/filelock.pytacquireÛs8$          "   cCs›|jŒ|jr‘|jd8_|jdks7|r‘t|ƒ}|j}tƒjd||ƒ|jƒd|_tƒjd||ƒq‘nWdQXdS(sV 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. iis#Attempting to release lock %s on %ssLock %s released on %sN( R!R)R"R*RR R-R(R.R (R tforceR2R3((s'lib/python2.7/site-packages/filelock.pyR%s      "cCs|jƒ|S(N(R5(R ((s'lib/python2.7/site-packages/filelock.pyRBs cCs|jƒdS(N(RR (R RRR((s'lib/python2.7/site-packages/filelock.pyRFs cCs|jdtƒdS(NR6(RR,R (R ((s'lib/python2.7/site-packages/filelock.pyt__del__JsN(R RRRtpropertyR RtsetterR'R(R)R R5tFalseRRRR7(((s'lib/python2.7/site-packages/filelock.pyRs    J   cBs eZdZd„Zd„ZRS(se Uses the :func:`msvcrt.locking` function to hard lock the lock file on windows systems. cCs’tjtjBtjB}ytj|j|ƒ}Wntk rCnKXytj|tj dƒWn$t tfk r„tj |ƒn X||_ dS(Ni(tostO_RDWRtO_CREATtO_TRUNCtopenRtOSErrortmsvcrttlockingtLK_NBLCKtIOErrortcloseRR (R t open_modetfd((s'lib/python2.7/site-packages/filelock.pyR'Xs  cCsa|j}d|_tj|tjdƒtj|ƒytj|jƒWnt k r\nXdS(Ni( RR RARBtLK_UNLCKR;REtremoveRR@(R RG((s'lib/python2.7/site-packages/filelock.pyR(hs    (R RRR'R((((s'lib/python2.7/site-packages/filelock.pyRRs cBs eZdZd„Zd„ZRS(sR Uses the :func:`fcntl.flock` to hard lock the lock file on unix systems. cCs~tjtjBtjB}tj|j|ƒ}ytj|tjtj BƒWn$t t fk rptj |ƒn X||_ dS(N(R;R<R=R>R?RtfcntltflocktLOCK_EXtLOCK_NBRDR@RERR (R RFRG((s'lib/python2.7/site-packages/filelock.pyR'~s cCs6|j}d|_tj|tjƒtj|ƒdS(N(RR RJRKtLOCK_UNR;RE(R RG((s'lib/python2.7/site-packages/filelock.pyR(Šs    (R RRR'R((((s'lib/python2.7/site-packages/filelock.pyRys cBs eZdZd„Zd„ZRS(s8 Simply watches the existence of the lock file. cCs^tjtjBtjBtjB}ytj|j|ƒ}Wnttfk rPn X||_ dS(N( R;tO_WRONLYR=tO_EXCLR>R?RRDR@RR (R RFRG((s'lib/python2.7/site-packages/filelock.pyR's cCsEtj|jƒd|_ytj|jƒWntk r@nXdS(N(R;RERR RIRR@(R ((s'lib/python2.7/site-packages/filelock.pyR(§s  (R RRR'R((((s'lib/python2.7/site-packages/filelock.pyR˜s s only soft file lock is available(RRR;RR+twarningst ImportErrorR RARJt TimeoutErrort NameErrorR@t__all__t __version__RR RtobjectRRRRRRtwarn(((s'lib/python2.7/site-packages/filelock.pytsV              Ñ'!