o
    ôjw  ã                   @  s˜   d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl	m
Z
 ejdkr0dd	lmZmZ ndd	lmZmZ d
ddœddd„Zddd„ZddgZdS )znA minimal native lock over a caller-owned file descriptor, contending with :class:`FileLock` on the same file.é    )ÚannotationsN)ÚTIMEOUT_MAX)ÚFinalé   )Ú_secondsÚwin32)Ú_lock_fd_nonblockingÚ
_unlock_fdTgš™™™™™©?)ÚblockingÚpoll_intervalÚfdÚintr
   Úboolr   ÚfloatÚreturnc                C  sb   |st | ƒS dtd|ƒ }  k rtks"n dt› d|› �}t|ƒ‚t | ƒs/t |¡ t | ƒr&dS )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

    r   r   z1poll_interval must be greater than 0 and at most z, got T)r   r   r   Ú
ValueErrorÚtimeÚsleep)r   r
   r   Úmsg© r   úe/var/www/html/academy/tools/voices/clone/sv-venv/lib/python3.10/site-packages/filelock/_descriptor.pyÚlock_descriptor   s    
ÿr   ÚNonec                 C  s   t | ƒ dS )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	   )r   r   r   r   Úunlock_descriptor8   s   r   )r   r   r
   r   r   r   r   r   )r   r   r   r   )Ú__doc__Ú
__future__r   Úsysr   Ú	threadingr   Útypingr   Ú_apir   ÚplatformÚ_windowsr   r	   Ú_unixr   r   Ú__all__r   r   r   r   Ú<module>   s    

&þ