o
    ôjl7  ã                   @  s¼  U d Z ddlmZ ddlZddlZddlZddlmZ ddl	m
Z
 ddlmZ ddlmZmZmZmZmZmZmZ ddlmZ d	d
lmZmZmZmZ d	dlmZ eroddlmZm Z m!Z! ddlm"Z" d	dl#m$Z$ d	dl%m&Z& edƒZ'G dd„ de(ƒZ)e
dd�G dd„ dee' ƒƒZ*G dd„ dƒZ+G dd„ dƒZ,eƒ Z-de.d< eƒ Z/de.d< dLd"d#„Z0dMd%d&„Z1dNd*d+„Z2dOd-d.„Z3dPd1d2„Z4dOd3d4„Z5dQd;d<„Z6dRd>d?„Z7dSdEdF„Z8dTdIdJ„Z9g dK¢Z:dS )UzKSeparate caller cancellation from backend task and executor-future results.é    )ÚannotationsN)ÚFuture)Ú	dataclass)ÚLock)ÚTYPE_CHECKINGÚFinalÚGenericÚLiteralÚNoReturnÚTypeVarÚcast)ÚWeakKeyDictionaryé   )Ú_append_exception_contextÚ_fork_transitionÚ_raise_chained_errorsÚ_resolve_read_write_timeout)ÚTimeout)ÚAsyncGeneratorÚ	AwaitableÚCallable)ÚExecutor)ÚReadWriteLock)ÚSoftReadWriteLockÚ_Tc                   @  s   e Zd ZdS )Ú _AsyncTransitionUnavailableErrorN)Ú__name__Ú
__module__Ú__qualname__© r   r   úb/var/www/html/academy/tools/voices/clone/cosy-venv/lib/python3.10/site-packages/filelock/_async.pyr      s    r   T)Úfrozenc                   @  s&   e Zd ZU dZded< dZded< dS )Ú_BackendOutcomeNz	_T | NoneÚvaluezBaseException | NoneÚerror)r   r   r   r#   Ú__annotations__r$   r   r   r   r    r"      s   
 r"   c                   @  sN   e Zd Zddd„Zejddd„ƒZejddd„ƒZeddd„ƒZ	ddd„Z
dS )Ú_AsyncTransitionGateÚreturnÚNonec                 C  s   t ƒ | _d | _d S ©N)r   Ú
_tail_lockÚ_tail©Úselfr   r   r    Ú__init__&   s   
z_AsyncTransitionGate.__init__úAsyncGenerator[None]c              	    s¤   �t ƒ ‰ˆ j� ˆ j}ˆˆ _W d   ƒ n1 sw   Y  |d ur@ztt |¡ƒI d H  W n ty?   | ‡ ‡fdd„¡ ‚ w zd V  W ˆ  ˆ¡ d S ˆ  ˆ¡ w )Nc                   ó
   ˆ   ˆ¡S r)   ©Ú_leave©Z_predecessor©r-   Úticketr   r    Ú<lambda>4   ó   
 z+_AsyncTransitionGate.hold.<locals>.<lambda>)	ÚConcurrentFuturer*   r+   Ú_wait_until_doneÚasyncioÚwrap_futureÚBaseExceptionÚadd_done_callbackr2   )r-   Úpredecessorr   r4   r    Úhold*   s    €þþz_AsyncTransitionGate.holdÚblockingÚboolÚcancel_checkúCallable[[], bool] | NoneÚdeadlineúfloat | NoneÚpoll_intervalÚfloatc             	    s²   �t ƒ ‰ˆ j� ˆ j}ˆˆ _W d   ƒ n1 sw   Y  |d urG| ¡ sGzˆ j|||||d�I d H  W n tyF   | ‡ ‡fdd„¡ ‚ w zd V  W ˆ  ˆ¡ d S ˆ  ˆ¡ w )N)r@   rB   rD   rF   c                   r0   r)   r1   r3   r4   r   r    r6   R   r7   z7_AsyncTransitionGate.hold_for_acquire.<locals>.<lambda>)r8   r*   r+   ÚdoneÚ_wait_for_predecessorr<   r=   r2   )r-   r@   rB   rD   rF   r>   r   r4   r    Úhold_for_acquire;   s,   €	þûþz%_AsyncTransitionGate.hold_for_acquirer>   úConcurrentFuture[None]c                Ã  sœ   �|st ‚t | ¡}|  ¡ sL|d ur|ƒ rt ‚|d ur3|t ¡   }dkr't ‚|d ur0t||ƒn|}n|d ur9|nd }tj|f|d�I d H  |  ¡ rd S d S )Nr   ©Útimeout)r   r:   r;   rH   ÚtimeÚperf_counterÚminÚwait)r>   r@   rB   rD   rF   ÚwaiterÚ	remainingZwait_intervalr   r   r    rI   Y   s   €	
÷z*_AsyncTransitionGate._wait_for_predecessorr5   c                 C  sD   | j � | j|u rd | _W d   ƒ n1 sw   Y  | d ¡ d S r)   )r*   r+   Ú
set_resultr4   r   r   r    r2   p   s   
€þz_AsyncTransitionGate._leaveN©r'   r(   )r'   r/   )
r@   rA   rB   rC   rD   rE   rF   rG   r'   r/   )r>   rK   r@   rA   rB   rC   rD   rE   rF   rG   r'   r(   )r5   rK   r'   r(   )r   r   r   r.   Ú
contextlibÚasynccontextmanagerr?   rJ   ÚstaticmethodrI   r2   r   r   r   r    r&   %   s    
r&   c                   @  s\   e Zd ZdZd(dd„Zd)dd„Zd*dd„Zd+dd„Zd(dd„Zdd œd,d$d%„Z	d(d&d'„Z
dS )-Ú_TaskOwnersal  
    Per-task ownership in front of a sync reader/writer lock that tracks threads.

    An async wrapper runs each call on an executor thread, and that thread does not identify the calling task. Waiting
    writers block new readers so a stream of readers cannot starve them. A thread lock guards the table because tasks on
    different event loops share it.
    r'   r(   c                 C  s2   t ƒ | _d | _i | _d| _d| _tƒ | _d | _d S )NFr   )	r   Ú_lockÚ_modeÚ_depthsÚ_transitioningÚ_waiting_writersr8   Ú_changedÚbackend_threadr,   r   r   r    r.   €   s   
z_TaskOwners.__init__ÚmodeúLiteral['read', 'write']rM   rG   r@   rA   Ú	lock_fileÚstrÚenterú"Callable[[float], Awaitable[None]]c                Ã  sô  �t ƒ }t||d�}|r|dk rd nt ¡ | }d}zŠt| j||||d� }	tƒrƒ|r5|d ur9t ¡ |kr9t|ƒ‚|dkr[|s[d}| j� |  j	d7  _	W d   ƒ n1 sVw   Y  |d u rad n|t ¡  }
t
jt
 |	¡f|
d�I d H  t| j||||d� }	tƒs)W |r¤| j� |  j	d8  _	|  ¡  W d   ƒ n1 sŸw   Y  n!|rÅ| j� |  j	d8  _	|  ¡  W d   ƒ w 1 sÀw   Y  w |	d	krÌd S z||d u rÔd
ntd|t ¡  ƒƒI d H  W n tyð   | jd d� ‚ w | j||d� d S )N)r@   r   F)Úwaiting_writerÚwriteTr   rL   Úheldéÿÿÿÿg        ©ra   ©ra   Úholder)Ú_current_taskr   rN   rO   Ú
isinstanceÚ_admitr8   r   rZ   r^   r:   rQ   r;   Ú_notifyÚmaxr<   Ú_finish_transition)r-   ra   rM   r@   rc   re   ÚtaskrD   rg   Z	admissionrQ   r   r   r    ÚacquireŠ   sT   €	ÿÿöÿ€
þ€ÿ
þ,þz_TaskOwners.acquirert   úasyncio.Task[object]rg   ú1Literal['held', 'enter'] | ConcurrentFuture[None]c             
   C  s   | j �ƒ | j |¡ }d urB| j|kr2d|› d|› d|dkr dnd› d|dkr)dnd› d	�	}t|ƒ‚|d
 | j|< 	 W d   ƒ dS | j| }| js||dkrc| jdkrc|scd
| j|< 	 W d   ƒ dS | js||dksl|s|d|| _| _	 W d   ƒ dS | jW  d   ƒ S 1 s‰w   Y  d S )NzCannot acquire z	 lock on z: already holding a Úreadrh   z lock (Z	downgradeÚupgradez not allowed)r   ri   Tre   )rZ   r\   Úgetr[   ÚRuntimeErrorr^   r]   r_   )r-   rt   ra   rc   rg   ÚdepthÚmsgZwriters_aheadr   r   r    rp   ±   s2   
ÿþÿö

ñî$íz_TaskOwners._admitÚforceÚleaveú3Callable[[], asyncio.Future[_BackendOutcome[None]]]c          	      Ã  s  �t ƒ }| j�S | j |¡ }d u r'|r	 W d   ƒ d S d|› d�}t|ƒ‚|s=|dkr=|d | j|< 	 W d   ƒ d S | j|= | jrM	 W d   ƒ d S d| _| j}W d   ƒ n1 s]w   Y  z
t|ƒ ƒI d H }W n ty{   | j	||d� ‚ w | j	d d� |d urˆ|‚d S )NzCannot release a lock on z that is not held by this taskr   Trl   rk   )
rn   rZ   r\   rz   r{   r]   r[   Ú_drain_cancellationr<   rs   )	r-   r~   rc   r   rt   r|   r}   ra   Úcancellationr   r   r    ÚreleaseÎ   s<   €ýø	õóýþz_TaskOwners.releasec                 C  sJ   | j � | j ¡  d\| _| _|  ¡  W d   ƒ d S 1 sw   Y  d S )N)NF)rZ   r\   Úclearr[   r]   rq   r,   r   r   r    Úresetë   s
   

"ýz_TaskOwners.resetN)rm   úLiteral['read', 'write'] | Nonerm   úasyncio.Task[object] | Nonec                C  sT   | j � d|| _| _|d urd| j|< |  ¡  W d   ƒ d S 1 s#w   Y  d S )NFr   )rZ   r]   r[   r\   rq   )r-   ra   rm   r   r   r    rs   ñ   s   

"üz_TaskOwners._finish_transitionc                 C  s   | j tƒ }| _ | d ¡ d S r)   )r_   r8   rT   )r-   Úchangedr   r   r    rq   ú   s   z_TaskOwners._notifyrU   )ra   rb   rM   rG   r@   rA   rc   rd   re   rf   r'   r(   )
rt   rv   ra   rb   rc   rd   rg   rA   r'   rw   )r~   rA   rc   rd   r   r€   r'   r(   )ra   r†   rm   r‡   r'   r(   )r   r   r   Ú__doc__r.   ru   rp   rƒ   r…   rs   rq   r   r   r   r    rY   w   s    



'

ÿ	rY   zHFinal[WeakKeyDictionary[ReadWriteLock | SoftReadWriteLock, _TaskOwners]]Ú_TASK_OWNERSzFinal[Lock]Ú_TASK_OWNERS_LOCKÚ	sync_lockú!ReadWriteLock | SoftReadWriteLockr'   c              	   C  s‚   t ƒ �4 t�! t | ¡ }du rtƒ  }t| < |W  d  ƒ W  d  ƒ S 1 s*w   Y  W d  ƒ dS 1 s:w   Y  dS )zNSingleton wrappers share one sync lock, so they must share its task holds too.N)r   r‹   rŠ   rz   rY   )rŒ   Úownersr   r   r    Ú_task_owners_for  s
   Rýr�   rv   c                  C  s    t  ¡  } d u rd}t|ƒ‚| S )NzDan async reader/writer lock must be used from inside an asyncio task)r:   Úcurrent_taskr{   )rt   r}   r   r   r    rn     s   rn   Úfutureú%asyncio.Future[_BackendOutcome[None]]úasyncio.CancelledError | Nonec                 Ã  sŽ   �z	t | ƒI d H  W n6 tjy@ } z)z	t| ƒI d H  W n ty3 } zt||ƒ W Y d }~nd }~ww |W  Y d }~S d }~ww t| ƒ d S r)   )r9   r:   ÚCancelledErrorÚ_drain_futurer<   Ú_raise_cancelled_errorÚ_future_result)r‘   r‚   r$   r   r   r    r�     s   €€ÿ€ûr�   ú#asyncio.Future[_BackendOutcome[_T]]c                 Ã  sT   �|   ¡ s&t tj¡� t| ƒI d H  W d   ƒ n1 sw   Y  |   ¡ rt| ƒS r)   )rH   rV   Úsuppressr:   r”   r9   r—   ©r‘   r   r   r    r•      s   €ÿÿr•   úasyncio.Future[_T]r(   c                 Ã  s$   �|   ¡ st | f¡I d H  d S d S r)   )rH   r:   rQ   rš   r   r   r    r9   '  s   €ÿr9   c                 C  sD   |   ¡ }|j }d u rtd|jƒS |j}z|‚ ty!   ||_‚ w )Nr   )Úresultr$   r   r#   Ú__context__r<   )r‘   Úoutcomer$   Úcontextr   r   r    r—   ,  s   þr—   Úloopúasyncio.AbstractEventLoopÚexecutorúExecutor | NoneÚfuncúCallable[[], _T]c                   s.   |   ¡ ‰ d‡ fdd„}|  |t|¡ |¡ ˆ S )NÚcallr˜   r'   r(   c                   sB   z|   ¡ }W n tjy   d}tt|ƒd�}Y nw ˆ  |¡ d S )Nz;the executor shut down before running the lock backend call©r$   )rœ   r:   r”   r"   r{   rT   )r¦   rœ   r}   ©rž   r   r    Úsettle=  s   üz _run_in_executor.<locals>.settle)r¦   r˜   r'   r(   )Úcreate_futureÚrun_in_executorÚ_capture_callr=   )r    r¢   r¤   r©   r   r¨   r    Ú_run_in_executor8  s   
r­   ú_BackendOutcome[_T]c              
   C  s>   zt | ƒ d�W S  ty } zt |d�W  Y d }~S d }~ww ©N)r#   r§   ©r"   r<   )r¤   r$   r   r   r    r¬   K  s   €ÿr¬   r‚   úasyncio.CancelledErrorr$   r<   r
   c                 C  sF   |j  }d ur|| ur| j  }d urt||ƒ || _ | |_ t|ƒ d S r)   )r�   r   r   )r‚   r$   rŸ   Zcancellation_contextr   r   r    r–   R  s   
r–   Ú	awaitableúAwaitable[_T]c              
   Ã  sD   �z	t | I d H d�W S  ty! } zt |d�W  Y d }~S d }~ww r¯   r°   )r²   r$   r   r   r    Ú_capture_awaitable^  s   €€ÿr´   )r&   r   r"   r´   r¬   r•   r—   r–   r­   r�   r9   )rŒ   r�   r'   rY   )r'   rv   )r‘   r’   r'   r“   )r‘   r˜   r'   r   )r‘   r›   r'   r(   )r    r¡   r¢   r£   r¤   r¥   r'   r˜   )r¤   r¥   r'   r®   )r‚   r±   r$   r<   r'   r
   )r²   r³   r'   r®   );r‰   Ú
__future__r   r:   rV   rN   Úconcurrent.futuresr   r8   Údataclassesr   Ú	threadingr   Útypingr   r   r   r	   r
   r   r   Úweakrefr   Ú_apir   r   r   r   Ú_errorr   Úcollections.abcr   r   r   r   Ú_read_writer   Ú_soft_rwr   r   Ú	Exceptionr   r"   r&   rY   rŠ   r%   r‹   r�   rn   r�   r•   r9   r—   r­   r¬   r–   r´   Ú__all__r   r   r   r    Ú<module>   sJ    $R 	









