ej dZddlmZgdZddlZddlZddlmZddlm Z ddl m Z ej dkr dd l mZmZndd lmZmZd d d ddZddZddgZdS)znA minimal native lock over a caller-owned file descriptor, contending with :class:`FileLock` on the same file.) annotations)zfilelock._unix threadingtypingN) TIMEOUT_MAX)Final)_secondswin32)_lock_fd_nonblocking _unlock_fdTg?)blocking poll_intervalfdintr boolr floatreturnc |st|Sdtd|x}cxkr tksndtd|}t|t|s#t j|t|#dS)aI Take the native OS lock on *fd*, a file descriptor the caller opened and owns. This is the same one-byte exclusive lock :class:`FileLock` uses, so a descriptor lock and a path lock on the same file contend with each other. Unlike :class:`FileLock` it adds no path handling: it never opens, truncates, closes, unlinks, chmods, canonicalizes, or falls back. The caller owns *fd* before, during, and after the call, and must close it. On Windows *fd* must be a synchronous descriptor (its handle not opened with ``FILE_FLAG_OVERLAPPED``). For timeout, reentrancy, singleton, lifetime, or stale-break behavior, use :class:`FileLock`. There is no async wrapper. Run this in an executor, or drive ``blocking=False`` from your own polling loop. :param fd: an open file descriptor the caller owns. :param blocking: when ``True`` (default), retry the nonblocking attempt every *poll_interval* seconds until it succeeds; when ``False``, make one attempt. :param poll_interval: positive seconds between attempts while blocking, at most :data:`threading.TIMEOUT_MAX`; ignored when *blocking* is ``False``. :returns: ``True`` once the lock is held, or ``False`` on contention when ``blocking`` is ``False``. :raises OSError: for a permanent native failure, such as an invalid descriptor, or with ``errno.ENOSYS`` when the Python build lacks the native locking primitive. The descriptor is left open. :raises ValueError: if a blocking call receives a *poll_interval* outside that range, including ``nan``. .. versionadded:: 3.30.0 rr z1poll_interval must be greater than 0 and at most z, got T)r rr ValueErrortimesleep)rr r msgs \/home/spazio/cosmos_universe_media/venv/lib/python3.11/site-packages/filelock/_descriptor.pylock_descriptorrs6 (#B''' /=!I!II Y Y Y Yk Y Y Y Ypkppanppoo"2&&" =!!!#2&&" 4Nonec$t|dS)a Release the native OS lock on *fd* without touching the descriptor. :param fd: the descriptor a prior :func:`lock_descriptor` locked; the caller still owns and must close it. :raises OSError: if the native unlock fails, including ``errno.ENOSYS`` when the Python build lacks the native locking primitive; the caller may retry on the same descriptor. .. versionadded:: 3.30.0 N)r )rs runlock_descriptorr:srNNNNNrrr)rrr rr rrr)rrrr)__doc__ __future__r__lazy_modules__sysrrrrr filelock._apirplatformfilelock._windowsr r filelock._unixrr__all__rrr(stt""""""<<< !!!!!!""""""<7BBBBBBBBB????????26d######L      r