o
    ôjÖº  ã                   @  s”  U d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl	Z	d dl
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mZmZmZ dd	l m!Z! dd
l"m#Z#m$Z$m%Z% ddl&m'Z' ddl(m)Z)m*Z* ddl+m,Z, ddl-m.Z.m/Z/ er—d dl0m1Z1m2Z2 ed Z3ed Z4e5ddhƒZ6de7d< dZ8de7d< dZ9de7d< dZ:de7d< dZ;de7d< d Z<de7d!< d"Z=de7d#< d$Z>de7d%< d&Z?de7d'< d"Z@de7d(< d)ZAd*e7d+< d,ZBde7d-< d.ZCd*e7d/< d0ZDd*e7d1< d.ZEd*e7d2< ejFd3ejGd4iZHd5e7d6< eIed7d ƒZJde7d8< e, K¡ ZLd9e7d:< e5h d;£ƒZMd<e7d=< eNed>ƒZOd?e7d@< ejPejQv ZRd?e7dA< ejSejQv ZTd?e7dB< ejejQv ZUd?e7dC< eO�oTejVejQv ZWd?e7dD< �ddGdH„ZXeXƒ ZYd?e7dI< �ddKdL„ZZeZƒ Z[d<e7dM< G dNdO„ dOeƒZ\edPdQ�G dRdS„ dSƒƒZ]G dTdU„ dUe^ƒZ_�dd_d`„Z`�d	dadb„Za�d
ddde„Zb�ddhdi„Zc�ddmdn„Zd�ddpdq„Ze�ddtdu„Zf�ddwdx„Zg�dd{d|„ZhdPd}œ�dd~d„Zi�dd„d…„Zj�dd‡dˆ„Zk�ddŒd�„Zl�ddŽd�„Zm�dd�d‘„Zn�dd”d•„Zo�dd›dœ„Zp�dd¢d£„Zq�dd¥d¦„Zr�dd©dª„Zs�dd¬d­„Zt�dd¯d°„Zu�dd±d²„Zv�ddµd¶„Zw�dd¸d¹„Zx�d dºd»„Zy�d!d¼d½„Zz�d"d¿dÀ„Z{�d#dÂdÃ„Z|�d$dÆdÇ„Z}	�d%�d&dÉdÊ„Z~dddËœ�d'dÑ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å„Z…�d.dædç„Z†�d/dédê„Z‡�d0dëdì„Zˆ�d1dîdï„Z‰�d2dñdò„ZŠ�d3död÷„Z‹�d4dødù„ZŒ�d5dúdû„Z��d6düdý„ZŽ�d7�d �d„Z��d8�d�d„Z�g �d¢Z‘dS (9  é    )ÚannotationsN)Ú	dataclass)ÚEACCESÚEEXISTÚENOENTÚENOSYSÚEPERMÚESTALEÚEXDEV)ÚPath)ÚTYPE_CHECKINGÚFinalÚLiteralÚcasté   )ÚBaseFileLockÚThreadLocalFileContextÚ
_canonicalÚ_raise_cleanup_errors)ÚSoftFileLockProtocolError)Ú	host_nameÚowner_is_staleÚprocess_start_token)Úparse_marker)ÚMALFORMED_LOCK_AGE_THRESHOLDÚ_parse_lock_holder)ÚSTRICT_SOFT_SENTINEL_RECORD)Úensure_directory_existsÚ	write_all)ÚCallableÚIterator)ÚintentÚheld)Úsentinelr"   ÚexitedÚdamagedÚ
unparsabler!   r"   zFinal[frozenset[str]]Ú_CLAIM_STATESz	.filelockz
Final[str]Ú_COORDINATION_SUFFIXÚclaimsÚ_CLAIM_DIRECTORY_NAMEzfilelock-strict-v1Ú_CLAIM_MAGICi   z
Final[int]Ú_CLAIM_RECORD_LIMITé   Ú_CLAIM_NAME_PART_COUNTé    Ú_TOKEN_HEX_LENGTHz.private-v1-Ú_PRIVATE_RECORD_MARKERú.tmpÚ_PRIVATE_RECORD_SUFFIXÚ!_PRIVATE_RECORD_RANDOM_HEX_LENGTHg       @zFinal[float]Ú_PRIVATE_RECORD_GRACEé
   Ú_UNLINK_MAX_RETRIESg      à?Ú_CLAIM_READ_GRACEgü©ñÒMb`?Ú_CLAIM_READ_RETRYÚ_SENTINEL_READ_GRACEza directoryz	a symlinkzFinal[dict[int, str]]Ú_NODE_DESCRIPTIONSÚO_BINARYÚ	_O_BINARYzFinal[bytes]Ú_LEGACY_SENTINEL>   r   é2   é   zFinal[frozenset[int]]Ú_WINDOWS_HARD_LINK_UNSUPPORTEDÚlinkzFinal[bool]Ú	_HAS_LINKÚ_OPEN_SUPPORTS_DIR_FDÚ_UNLINK_SUPPORTS_DIR_FDÚ_STAT_SUPPORTS_DIR_FDÚ_LINK_SUPPORTS_DIR_FDÚreturnÚboolc               
   C  s~   t sdS z-t ¡ �} t| dƒ}| ¡  tj|t| dƒdd� W d   ƒ W dS 1 s*w   Y  W dS  ttt	fy>   Y dS w )NFzprobe-sourcez
probe-link)Úfollow_symlinksT)
rC   ÚtempfileÚTemporaryDirectoryr   ÚtouchÚosrB   ÚOSErrorÚNotImplementedErrorÚ
ValueError)Ú	directoryÚsource© rT   úc/var/www/html/academy/tools/voices/clone/cosy-venv/lib/python3.10/site-packages/filelock/_strict.pyÚ_probe_link_follow_symlinksD   s   

ýúþÿrV   Ú_LINK_HONORS_FOLLOW_SYMLINKSúfrozenset[int]c                  C  s4   t tdt tdd ƒƒ} t| d u rtthƒS tt| hƒS )NÚENOTSUPÚ
EOPNOTSUPP)ÚgetattrÚerrnoÚ	frozensetr   r
   )Znot_supportedrT   rT   rU   Ú#_probe_hard_link_unsupported_errnosY   s    r^   Ú_HARD_LINK_UNSUPPORTED_ERRNOSc                      sê   e Zd ZU dZdZded< dZded< dZded< dZd	ed
< dZ	ded< dZ
ded< d4dd„Zd5dd„Zd6dd„Zd7dd„Zed8d!d"„ƒZed9d$d%„ƒZd:d'd(„Zd4‡ fd)d*„Zd;‡ fd,d-„Zd4d.d/„Zd4d0d1„Zed<d2d3„ƒZ‡  ZS )=ÚStrictSoftFileLockz:Portable fail-closed lock based on immutable owner claims.TrI   Ú_preserve_lock_file_supportedFÚ_on_acquired_supportedÚ_lifetime_supportedz<a strict claim is never broken by age, only by force_break()ÚstrÚ_lifetime_unsupported_reasongš™™™™™©?ÚfloatÚ_poll_backoff_capNz+tuple[tuple[float, int, int], float] | NoneÚ_occupant_seenrH   ÚNonec           
      C  sV  | j dd� | jj }d u rt| jƒ }| j_t|ƒ}t|› t› �ƒ}|t }tt	 
|¡ƒ t| j|ƒ t| j|ƒ t| j||  ¡ | jƒ }d u rKd S z	tt	 |¡ƒ}W n, ty€ } z zt	 |¡ W ‚  ty{ } ztd||ƒ W Y d }~‚ d }~ww d }~ww |  ||¡ z|  |¡}	W n tyš   |  ¡  ‚ w |	r¥|  ||¡ d S |  ¡  d S )NT©Úexited_onlyz)strict sentinel inspection cleanup failed)Ú_discard_pending_doorwaysÚ_contextÚ
claim_rootr   Ú	lock_filer   r(   r*   r   rN   ÚfspathÚ_ensure_protocol_directoryÚ_open_or_create_sentinelÚ
_open_modeÚ_occupant_unchanged_forÚ_file_identityÚfstatÚBaseExceptionÚcloser   Ú_mark_descriptor_pendingÚ_attempt_doorwayÚ_discard_doorwayÚ_mark_descriptor_owned)
Úselfrn   Ú	lock_pathZcoordination_directoryÚclaim_directoryZsentinel_fdZsentinel_identityZinspection_errorÚclose_errorZwonrT   rT   rU   Ú_acquiret   sL   ÿüþ€þ€ýþzStrictSoftFileLock._acquirerk   c             
   C  s¢   | j jr| js|  ¡  t| j  }tƒsd S |j}| j�, | j 	¡  
¡ D ]\}}|r.| ¡ r.q#||_z	|  ¡  W ||_q#||_w W d   ƒ d S 1 sJw   Y  d S ©N)rm   Úowner_claim_pathsÚ	is_lockedr{   Ú
isinstancer   ÚcurrentÚ_transition_lockÚ_thread_pendingÚcopyÚvaluesÚis_alive)r}   rk   ÚcontextÚownÚpendingÚthreadrT   rT   rU   rl   š   s   
ù"ÿz,StrictSoftFileLock._discard_pending_doorwaysÚoccupantúos.stat_resultc                 C  sN   |j |j|jft ¡ }}| j }d u s|d |kr!||f| _dS ||d  S )Nr   g        r   )Úst_mtimeÚst_inoÚst_sizeÚtimeÚ	monotonicrh   )r}   r�   ÚkeyÚnowÚseenrT   rT   rU   rt   «   s
   
z*StrictSoftFileLock._occupant_unchanged_forr   r   c              
   C  sÐ  t | j|ƒrdS t td ¡}td|ƒ}t|| ƒ}|f| j_zt	|t
|ƒ|  ¡ ƒ}W n3 ty5   Y dS  ttfy^ } zt| j|ƒ t|tƒrY|jtkrYd| j_W Y d }~dS ‚ d }~ww |d ure|‚t | j|ƒ}|r�tdd„ |D ƒƒs�tdd„ |D ƒƒ|krƒdS td|ƒ}t|| ƒ}	|	|f| j_zt|||ƒ}
W n$ ttfyÀ } zt| j|ƒ t|tƒr»|jtkr»|f| j_‚ d }~ww |
d urÇ|
‚t | j|ƒ}||h d	d„ |D ƒ¡oçtd
d„ |D ƒƒd|› d�kS )NFé   r!   rT   c                 s  s   � | ]}|j d kV  qdS )r"   N)Ústate©Ú.0ÚclaimrT   rT   rU   Ú	<genexpr>Î   ó   € z6StrictSoftFileLock._attempt_doorway.<locals>.<genexpr>c                 s  ó   � | ]}|j V  qd S r‚   ©Únamerœ   rT   rT   rU   rŸ   Ï   ó   € r"   c                 s  r¡   r‚   r¢   rœ   rT   rT   rU   rŸ   ç   r¤   c                 s  s   � | ]}t |jƒV  qd S r‚   )Ú_claim_token_keyr£   rœ   rT   rT   rU   rŸ   ç   s   € 

ÿzv1-ú.claim)Ú_read_existing_claimsro   ÚsecretsÚ	token_hexr0   Ú_claim_namerd   rm   rƒ   Ú_publish_recordÚ_claim_recordrs   Ú_PrivateRecordReclaimedErrorrP   rO   Ú _raise_if_hard_links_unsupportedr…   r\   r   ÚanyÚminÚ_link_no_replaceÚissubset)r}   r   ÚtokenZintent_nameZintent_pathÚpublication_cleanup_errorÚerrorr)   Z	held_nameZ	held_pathZlink_cleanup_errorrT   rT   rU   rz   ³   s^   

€úÿþ

€ü ÿ
þz#StrictSoftFileLock._attempt_doorwayútuple[StrictSoftFileClaim, ...]c                 C  s   t | j| jdd�S )z(Published claims that block acquisition.F©Úprobe_clock)r§   ro   Ú_claim_directory©r}   rT   rT   rU   r)   ë   s   zStrictSoftFileLock.claimsú
str | Nonec                 C  sL   zt tt| jƒƒƒ\}}}W n
 ty   Y dS w |du r|S t |¡ dS )aP  
        What sits at the lock path in place of the strict sentinel, or ``None`` when the sentinel or nothing is there.

        A soft-lock owner's marker blocks acquisition without appearing in :attr:`~filelock.StrictSoftFileLock.claims`;
        this describes it, naming the PID and host when the marker records them. A directory, a symlink, a marker whose
        owner on this host has exited, or a file it cannot parse that stays unchanged for two seconds makes acquisition
        raise :class:`~filelock.SoftFileLockProtocolError` instead and needs an operator to remove it.
        N)Ú_inspect_lock_pathr   r   ro   ÚFileNotFoundErrorrN   rx   )r}   ÚfdÚ_r�   rT   rT   rU   Úlock_path_occupantñ   s   
ÿ
z%StrictSoftFileLock.lock_path_occupantÚ
claim_namec                 C  s0   t |ƒ t| j|ƒ t| j|ƒ }dur|‚dS )zYRemove one named claim, allowing overlap if its owner still holds the protected resource.N)Ú_validate_force_break_nameÚ_require_exact_namer¹   Ú_unlink_in_directory)r}   rÁ   Úcleanup_errorrT   rT   rU   Úforce_break  s   þýzStrictSoftFileLock.force_breakc                   s`   t ƒ  ¡  t| ƒ d¡t ¡ krd S t t¡� | j	dd� W d   ƒ d S 1 s)w   Y  d S )NÚ_creator_pidFrj   )
ÚsuperÚ__del__ÚvarsÚgetrN   ÚgetpidÚ
contextlibÚsuppressÚ	Exceptionrl   rº   ©Ú	__class__rT   rU   rÉ     s   
"þzStrictSoftFileLock.__del__Ú	canonicalc                   s   d | j _tƒ  |¡ d S r‚   )rm   rn   rÈ   Ú_reconcile_failed_acquire)r}   rÒ   rÐ   rT   rU   rÓ     s   z,StrictSoftFileLock._reconcile_failed_acquirec              
   C  s    t d| jjƒ}d | j_t| jjƒ\}}t|ƒ| j_|r td|ƒ |  ¡  z	| j	|dd� W n t
yD } z| |¡ W Y d }~nd }~ww |rNtd|ƒ d S d S )NÚintzstrict claim release failedF©Údefault_suppresseszstrict release cleanup failed)r   rm   Úlock_file_fdrn   Ú_unlink_owner_pathsrƒ   ÚtupleÚ_raise_recorded_errorsÚ_mark_descriptor_releasedÚ_close_released_fdrw   Úappend)r}   r¾   Ú	remainingÚerrorsr€   rT   rT   rU   Ú_release  s    
€ÿÿzStrictSoftFileLock._releasec              
   C  s˜   t | jjƒ\}}t|ƒ| j_|rtd|ƒ td| jjƒ}|  ¡  z	| j|dd� W n t	y@ } z| 
|¡ W Y d }~nd }~ww |rJtd|ƒ d S d S )Nz#strict doorway claim cleanup failedrÔ   FrÕ   zstrict doorway cleanup failed)rØ   rm   rƒ   rÙ   rÚ   r   Úpending_lock_file_fdrÛ   rÜ   rw   rÝ   )r}   rÞ   rß   r¾   r€   rT   rT   rU   r{   *  s   
€ÿÿz#StrictSoftFileLock._discard_doorwayc                 C  s4   | j jrt| j jd ƒjS tt| jƒ› t› �ƒt S )Nr   )rm   rƒ   r   Úparentr   ro   r(   r*   rº   rT   rT   rU   r¹   :  s   z#StrictSoftFileLock._claim_directory)rH   ri   )rk   rI   rH   ri   )r�   r‘   rH   rf   )r   r   rH   rI   )rH   r¶   )rH   r»   )rÁ   rd   rH   ri   )rÒ   rd   rH   ri   )rH   r   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__ra   Ú__annotations__rb   rc   re   rg   rh   r�   rl   rt   rz   Úpropertyr)   rÀ   rÆ   rÉ   rÓ   rà   r{   r¹   Ú__classcell__rT   rT   rÐ   rU   r`   f   s.   
 

&

8
		

r`   T)Úfrozenc                   @  sF   e Zd ZU dZded< ded< ded< ded< ded	< d
Zded< d
S )ÚStrictSoftFileClaimz"One parsed strict soft-lock claim.rd   r£   ÚStrictSoftFileClaimStater›   r³   rÔ   ÚpidÚhostnameNú
int | NoneÚstart)rã   rä   rå   ræ   rç   rð   rT   rT   rT   rU   rë   A  s   
 rë   c                   @  s   e Zd ZdS )r­   N)rã   rä   rå   rT   rT   rT   rU   r­   O  s    r­   ro   rd   Úpathr   ÚmoderÔ   Úunchanged_forú!Callable[[os.stat_result], float]rï   c              
   C  sÌ   zt | ||ƒW S  ty   Y nw t|ƒ ztt |¡t|ƒ}W n- ty*   Y d S  tt	fyM } zt
| |ƒ t|t	ƒrB|jtkrC‚ W Y d }~nd }~ww |d urT|‚zt | ||ƒW S  tye   Y d S w r‚   )Ú_open_sentinelr½   Ú!_reclaim_sentinel_private_recordsr«   rN   rp   r>   r­   rP   rO   r®   r…   r\   r   )ro   rñ   rò   ró   r´   rµ   rT   rT   rU   rr   S  s0   ÿ
ÿ€þÿrr   c                 C  s¨   d }	 t |ƒ\}}}|d us|dkr|S d|› �}|dkr4|| ¡ ƒtk r'd S t| d |› dtd›d�ƒ‚|d u r>t ¡ t }|dksHt ¡ |krNt| d |ƒ‚t t¡ q)	NTr"   z5expected the strict sentinel at the lock path, found r&   z, unchanged for Úgz secondsr$   )	r¼   Úlstatr   r   r•   r–   r:   Úsleepr9   )ro   rñ   ró   Údeadliner¾   r›   r�   ÚreasonrT   rT   rU   rõ   m  s$   
ÿ
ñrõ   ú&tuple[int | None, _OccupantState, str]c              
   C  sú   t  |  ¡ j }¡sd dt t  |¡d¡fS z	t| tƒ\}}W nB t	y'   ‚  t
yD } zd dd|jp5|› d�fW  Y d }~S d }~w tya } zd dd|jpR|› d�fW  Y d }~S d }~ww |tkrk|ddfS t |¡ d gt|jdd	d
�ƒ¢R S )Nr%   za special filer"   za file it cannot read (ú)r#   zthe strict sentinelúutf-8Úreplace)rß   )ÚstatÚS_ISREGrø   Úst_moder;   rË   ÚS_IFMTÚ_open_recordr,   r½   ÚPermissionErrorÚstrerrorrO   r>   rN   rx   Ú_describe_soft_markerÚdecode)rñ   rò   r¾   Úrecordrµ   rT   rT   rU   r¼   „  s"   $€$€ÿ

r¼   Úcontentútuple[_OccupantState, str]c                 C  s~   t | ƒ }d ur|j|j|j}}}nt| ƒ }d ur"|\}}}ndS t|||ƒr5dd|› d|› d�fS dd|› d|› �fS )N)r&   zGa file that is neither the sentinel nor a soft-lock marker it can parser$   za soft-lock marker left by pid z on z, which has exitedr"   za soft-lock marker held by pid )r   rí   rî   rð   r   r   )r
  r	  rí   rî   rð   ÚholderrT   rT   rU   r  ™  s   r  rR   r¸   r¶   c                C  sh   g }t | ||d�D ]&}t|ƒ }d u rt| |dƒ‚t| |||d� }d ur/| t| |||ƒ¡ q	t|ƒS )Nr·   z&unknown claim name or protocol version)Ú_list_claim_namesÚ_parse_claim_namer   Ú_read_claim_recordrÝ   Ú_parse_claimrÙ   )ro   rR   r¸   r)   r£   Ú
name_partsr	  rT   rT   rU   Ú_read_claims§  s   €r  ú	list[str]c             
   C  s~   z t  |¡�}t|||d�W  d   ƒ W S 1 sw   Y  W d S  ty> } zd|jp0t|ƒj› �}t| d |ƒ|‚d }~ww )Nr·   zcannot list claim directory: )rN   ÚscandirÚ_public_claim_namesrO   r  Útyperã   r   )ro   rR   r¸   Úentriesrµ   rû   rT   rT   rU   r  ±  s   (ÿ€þr  r£   úbytes | Nonec                C  s    d }	 t | ||ƒ\}}|d u r|S |d u rt ¡ t }n.t ¡ |krJ|jtkr)d S |t| ||d�vr4d S d|jp@t|ƒp@t	|ƒj
› �}t| ||ƒ|‚t t¡ q)NTr·   úcannot read claim: )Ú_attempt_claim_readr•   r–   r8   r\   r	   r  r  rd   r  rã   r   rù   r9   )ro   rR   r£   r¸   rú   r	  rŽ   rû   rT   rT   rU   r  º  s    

ïr  ú#tuple[bytes | None, OSError | None]c              
   C  s´   z
t || tƒd fW S  ty   Y dS  ty) } z
d |fW  Y d }~S d }~w tyY } z%|jtkr?d |fW  Y d }~S d|jpKt|ƒpKt	|ƒj
› �}t| ||ƒ|‚d }~ww )N)NNr  )Ú_read_recordr,   r½   r  rO   r\   r	   r  rd   r  rã   r   )ro   rR   r£   rµ   rû   rT   rT   rU   r  ×  s   €
€ür  r  úIterator[os.DirEntry[str]]c                C  s–   g }|rt  t  t| tdt td ¡ƒ¡¡ndd„ }|D ]*}|j 	d¡s+| 
|j¡ qt|jƒ }d urFt|ƒd urFtt | ¡d f|j|ƒ qt|ƒS )Nr"   rš   c                   S  s   d S r‚   rT   rT   rT   rT   rU   Ú<lambda>ñ  s    z%_public_claim_names.<locals>.<lambda>Ú.)Ú	functoolsÚcacheÚpartialÚ_filesystem_nowrª   r¨   r©   r0   r£   Ú
startswithrÝ   Ú_private_public_namer  Ú_reclaim_private_recordrN   rp   Úsorted)rR   r  r¸   Únamesr˜   ÚentryÚpublic_namerT   rT   rU   r  è  s(   ûÿÿù	ÿþ€r  r·   c                C  s   |  ¡ sdS t| ||d�S )NrT   r·   )Úexistsr  )ro   rR   r¸   rT   rT   rU   r§   ý  s   r§   r  ú$tuple[StrictSoftFileClaimState, str]r	  Úbytesc              
   C  s  z$|  d¡ d¡\}}}}}}	t|ƒ}
|rt|ƒnd }t |¡  d¡}W n ttfy9 } zt| |dƒ|‚d }~ww t|	 |t	k||d kd|
  koNdkn  t
|
ƒ|k|d u pb|dkobt
|ƒ|k| ¡  ¡ |kow| ¡ owtdd	„ |D ƒƒ fƒs€t| |dƒ‚t||d ||
||d
�S )NÚasciiÚ
rþ   zmalformed claim recordr   iÿÿÿr   c                 s  s   � | ]}|  ¡ V  qd S r‚   )Úisspace©r�   Ú	characterrT   rT   rU   rŸ     ó   € z_parse_claim.<locals>.<genexpr>)r£   r›   r³   rí   rî   rð   )r  ÚsplitrÔ   r-  ÚfromhexÚUnicodeDecodeErrorrQ   r   Úallr+   rd   ÚencodeÚhexÚisprintabler¯   rë   )ro   r£   r  r	  Úmagicr³   Zpid_textÚhostname_hexÚ
start_textZtrailingrí   rð   rî   rµ   rT   rT   rU   r    s.   €ÿ

ÿ÷r  ú+tuple[StrictSoftFileClaimState, str] | Nonec                 C  s‚   |   d¡sd S |  d¡ d¡}t|ƒtks!|d tvs!|d dkr#d S |d }t|ƒtks6tdd„ |D ƒƒr8d S td	|d ƒ|fS )
Nr¦   ú-r   r   Zv1rš   c                 s  ó   � | ]}|d vV  qdS ©Ú0123456789abcdefNrT   r1  rT   rT   rU   rŸ   (  r3  z$_parse_claim_name.<locals>.<genexpr>rì   )	ÚendswithÚremovesuffixr4  Úlenr.   r'   r0   r¯   r   )r£   Úpartsr³   rT   rT   rU   r  !  s   
$r  r›   rì   r³   c                 C  s   | › d|› d�S )Nz-v1-r¦   rT   )r›   r³   rT   rT   rU   rª   -  ó   rª   c                 C  s   |   d¡  d¡S )Nzheld-zintent-)Úremoveprefixr¢   rT   rT   rU   r¥   1  rG  r¥   c              
   C  sZ   t ƒ  ¡  ¡ }tt ¡ ƒ}|d u rdnt|ƒ}t› d| › dt ¡ › d|› d|› d�
 d¡S )NÚ r/  r.  )r   r8  r9  r   rN   rÌ   rd   r+   )r³   r<  rð   r=  rT   rT   rU   r¬   5  s   ,r¬   Úpublic_pathúBaseException | Nonec           
      C  sü   t j | ¡\}}|pt j}t|ƒ}trt|ƒnd }||f}zt|||f||ƒ W n2 tyZ } z&z|d ur<t  	|¡ W ‚ W ‚  tyU }	 zt
d||	ƒ W Y d }	~	‚ d }	~	ww d }~ww |d ur|zt  	|¡ W d S  ty{ }	 z|	W  Y d }	~	S d }	~	ww d S )Nz+strict publication directory cleanup failed)rN   rñ   r4  ÚcurdirÚ_private_record_namerD   Ú_open_directoryÚ_publish_record_in_directoryrw   rx   r   )
rJ  r	  rò   rR   r*  Úprivate_nameÚdirectory_fdÚdirectory_refÚpublication_errorr€   rT   rT   rU   r«   <  s<   
üþ€þ€üþ€ÿr«   rR  útuple[str, int | None]r(  útuple[str, str]ri   c              
   C  sø   t jt jB t jB tB }tt dd ƒ }d ur||O }t| |d ||ƒ}d }ztt  |¡ƒ}t	||ƒ t
| ||ƒ W n' ty_ } zt| |d ||ƒ\}	}
|	d usS|
d urZtd||	|
ƒ ‚ d }~ww t| |d ||ƒ\}	}
|	d uss|
d urzt|	|
ƒ d S d S )NÚ
O_NOFOLLOWr   z(strict record publication cleanup failed)rN   ÚO_RDWRÚO_CREATÚO_EXCLr=   r[   Ú_open_relativeru   rv   r   Ú_link_private_recordrw   Ú _close_and_unlink_private_recordr   Ú!_raise_record_finalization_errors)rR  r(  rò   r	  ÚflagsÚ
o_nofollowÚ
private_fdÚprivate_identityrS  r€   Úunlink_errorrT   rT   rU   rO  W  sF   
üü€òüÿrO  rP  r`  ra  útuple[int, int] | Noneú1tuple[BaseException | None, BaseException | None]c              
   C  sº   d }zt  |¡ W n ty } z|}W Y d }~nd }~ww d }z|d u r+t| |ƒ nt| ||ƒ W ||fS W ||fS  tyF   Y ||fS  ty\ } z|}W Y d }~||fS d }~ww r‚   )rN   rx   rw   Ú_unlink_relativeÚ_unlink_relative_if_identityr½   )rR  rP  r`  ra  r€   rµ   rb  rT   rT   rU   r\    s.   €ÿùüþ€þr\  útuple[int, int]c              
   C  sv   zt | g|¢|‘R Ž  W n ty) } zt| |d ƒd ur‚ d}t|ƒ|‚d }~ww t| |d ƒ|kr5d S d}t|ƒ‚)Nr   z(private publication record was reclaimedr   z'private publication record was replaced)Ú_link_or_find_committedr½   Ú_relative_identityr­   )rR  r(  ra  rµ   ÚmsgZmsg_0rT   rT   rU   r[  —  s   
€ür[  r€   rb  c                 C  sD   dd„ | |fD ƒ}t |ƒdkrtd|d g|dd … ¢R Ž  |d ‚)Nc                 S  s   g | ]}|d ur|‘qS r‚   rT   )r�   rµ   rT   rT   rU   Ú
<listcomp>­  ó    z5_raise_record_finalization_errors.<locals>.<listcomp>r   z!strict record finalization failedr   ©rE  r   )r€   rb  rß   rT   rT   rU   r]  ©  s   r]  r*  c                 C  s   d| › t › t td ¡› d�S )Nr  rš   r2   )r1   r¨   r©   r4   )r*  rT   rT   rU   rM  ³  s   rM  r»   c                 C  sd   |   d¡r
|  t¡sd S | dttƒ …  t¡\}}}|tks.t|ƒtks.tdd„ |D ƒƒr0d S |S )Nr  r   c                 s  r@  rA  rT   r1  rT   rT   rU   rŸ   ¾  r3  z'_private_public_name.<locals>.<genexpr>)r$  rC  r3   rE  Ú
rpartitionr1   r4   r¯   )rP  r*  ÚmarkerZ
random_hexrT   rT   rU   r%  ·  s   ÿr%  c                 C  s‚   t  | j¡d f}t t t| j| j¡¡}t  | j¡�}|D ]}t	|jƒ| jkr.t
||j|ƒ qW d   ƒ d S 1 s:w   Y  d S r‚   )rN   rp   râ   r   r!  r"  r#  r£   r  r%  r&  )rñ   rR  r˜   r  r)  rT   rT   rU   rö   Ä  s   €þ"ÿrö   r˜   úCallable[[], float | None]c           	   
   C  sô   | \}}z|d urt rtj||dd�nt||ƒ ¡ }W n
 ty%   Y d S w t |j¡s8t||ƒ› d�}t|ƒ‚|j	dkrM|ƒ  }d u sK||j
 tk rMd S zt| |ƒ W d S  ty_   Y d S  tyy } z|jtthvrn‚ W Y d }~d S d }~ww )NF©Údir_fdrJ   z  is not a regular private recordr   )rF   rN   r   r   rø   r½   r  r  rO   Úst_nlinkr’   r5   Ú_unlink_private_record_oncer\   r   r   )	rR  rP  r˜   rR   rQ  Zprivate_statrj  r†   rµ   rT   rT   rU   r&  Í  s2   ÿýÿ
ÿ€ÿr&  úfloat | Nonec                 C  s¼  | t |ƒ }zt |tjtjB tjB tB ttddƒB d¡}W n
 ty(   Y d S w z€z@t	|dƒ t 
|¡jW W t t¡� t |¡ W d   ƒ n1 sLw   Y  t t¡� | ¡  W d   ƒ S 1 sew   Y  S  ty©   Y W t t¡� t |¡ W d   ƒ n1 sˆw   Y  t t¡� | ¡  W d   ƒ d S 1 s¢w   Y  d S w t t¡� t |¡ W d   ƒ n1 s¿w   Y  t t¡� | ¡  W d   ƒ w 1 sØw   Y  w )NrV  r   i€  ó   
)rM  rN   ÚopenÚO_WRONLYrX  rY  r=   r[   rO   r   rv   r’   rÍ   rÎ   rx   Úunlink)rR   r*  Úprober¾   rT   rT   rU   r#  é  s<   0ÿ
ÿ
ÿûÿ
"ÿûÿ
ÿr#  c                 C  s8   | \}}|d urt rtj||d� d S t||ƒ ¡  d S ©N©rr  )rE   rN   ry  r   )rR  rP  rR   rQ  rT   rT   rU   rt  þ  s   rt  c                 C  s^   | \}}z |d urt rtj||dd�}nt||ƒ ¡ }W t|ƒS W t|ƒS  ty.   Y d S w )NFrq  )rF   rN   r   r   rø   r½   ru   )rR  r£   rR   rQ  Ú	path_statrT   rT   rU   ri    s   ûþÿri  Úidentityc                 C  sL   t | |ƒ|kr$t t¡� t| |ƒ W d   ƒ d S 1 sw   Y  d S d S r‚   )ri  rÍ   rÎ   r½   re  )rR  r£   r~  rT   rT   rU   rf    s
   "ÿÿrf  r^  c                 C  s6   | \}}|d urt j||||d�S t  t||ƒ||¡S r{  )rN   rw  r   )rR  r£   r^  rò   rR   rQ  rT   rT   rU   rZ    s   ÿÿýrZ  Úsource_nameÚdestination_namec                 C  sB   | \}}|d urt rt||||d� d S tt||ƒt||ƒƒ d S )N©Ú
src_dir_fdÚ
dst_dir_fd)rG   Ú_link_no_followr   )rR  r  r€  rR   rQ  rT   rT   rU   Ú_link_relative'  s
   r…  Úsource_identityc                 C  sN   z	t | ||ƒ W d S  ty&   t| |ƒ }d u s"||p t| |ƒkr#‚ Y d S w r‚   )r…  ÚFileExistsErrorri  )rR  r  r€  r†  r~  rT   rT   rU   rh  /  s   ÿýürh  r�  rS   ú
str | PathÚdestinationr‚  rƒ  c                C  sB   t sd}t|ƒ‚trtj| |||dd� d S tj| |||d� d S )Nz'os.link is unavailable on this platformF)r‚  rƒ  rJ   r�  )rC   rP   rW   rN   rB   )rS   r‰  r‚  rƒ  rj  rT   rT   rU   r„  A  s   r„  c                 C  sT   | \}}|d urt rtj||d� d S tjdkr!tt|ƒ|ƒ d S t||ƒ ¡  d S )Nr|  Úwin32)rE   rN   ry  ÚsysÚplatformrÄ   r   )rR  r£   rR   rQ  rT   rT   rU   re  V  s   
re  c                 C  sÔ   t r^tt| ƒƒ}ztt| ƒ|f||ƒ W n, ty@ } z zt |¡ W ‚  ty; } ztd||ƒ W Y d }~‚ d }~ww d }~ww zt |¡ W d S  ty] } z|W  Y d }~S d }~ww tt| ƒd f||ƒ d S )Nz$strict link directory cleanup failed)rG   rN  rd   rh  rw   rN   rx   r   )rR   r  r€  rQ  Z
link_errorr€   rT   rT   rU   r±   `  s0   þ€þ€ýþ€ÿr±   c                 C  s$   t j | ¡\}}tt|pt jƒ|ƒS r‚   )rN   rñ   r4  rÄ   r   rL  )rñ   rR   r£   rT   rT   rU   Ú_unlink_owner_patht  s   r�  Úpathsútuple[str, ...]ú%tuple[list[str], list[BaseException]]c                 C  s*   dd„ | D ƒ}dd„ |D ƒdd„ |D ƒfS )Nc                 S  s   g | ]}|t |ƒf‘qS rT   )Ú_unlink_owner_path_result)r�   rñ   rT   rT   rU   rk  z  rl  z'_unlink_owner_paths.<locals>.<listcomp>c                 S  s   g | ]
\}\}}|s|‘qS rT   rT   )r�   rñ   Zremovedr¿   rT   rT   rU   rk  {  s    c                 S  s    g | ]\}\}}|d ur|‘qS r‚   rT   )r�   r¿   rµ   rT   rT   rU   rk  {  s    rT   )rŽ  ÚresultsrT   rT   rU   rØ   y  s   ÿrØ   ú!tuple[bool, BaseException | None]c              
   C  sR   z	t | ƒ}W d|fS  ty   Y dS  ty( } z
d|fW  Y d }~S d }~ww )N)TNFT)r�  r½   rw   )rñ   rÅ   rµ   rT   rT   rU   r‘  €  s   
ü€ÿr‘  Úmessagerß   úlist[BaseException]c                 C  s2   t |ƒdkrt| |d g|dd … ¢R Ž  |d ‚)Nr   r   rm  )r”  rß   rT   rT   rU   rÚ   Š  s   rÚ   c                 C  s4  t r[tt| ƒƒ}z	tj||d� W n, ty= } z zt |¡ W ‚  ty8 } ztd||ƒ W Y d }~‚ d }~ww d }~ww zt |¡ W d S  tyZ } z|W  Y d }~S d }~ww tj	dkrjt
| | ƒ ¡  d S d}ttƒD ]'}t| | ƒ }d u r d S |jtthvsŒ|td krŽ|‚t |¡ |d9 }qpd S )Nr|  z&strict unlink directory cleanup failedrŠ  gü©ñÒMbP?r   rš   )rE   rN  rd   rN   ry  rw   rx   r   r‹  rŒ  r   Úranger7   Ú_unlink_errorr\   r   r   r•   rù   )rR   r£   rQ  rb  r€   Úretry_delayÚattemptrµ   rT   rT   rU   rÄ   �  sD   þ€þ€ýþ€ÿ


rÄ   úOSError | Nonec              
   C  s8   z|   ¡  W d S  ty } z|W  Y d }~S d }~ww r‚   )ry  rO   )rñ   rµ   rT   rT   rU   r—  ®  s   
þ€ÿr—  c                 C  s&   t  | t jtt ddƒB tt ddƒB ¡S )NÚO_DIRECTORYr   rV  )rN   rw  ÚO_RDONLYr[   )rR   rT   rT   rU   rN  ¶  s   þrN  Úlimitc                 C  s   t | |ƒ\}}t |¡ |S r‚   )r  rN   rx   )rñ   r�  r¾   r	  rT   rT   rU   r  ½  s   
r  útuple[int, bytes]c           	      C  sÆ   |   ¡ }t |j¡s| › d�}t|ƒ‚tjtB ttddƒB ttddƒB }t 	| |¡}zt
|| ||ƒ}W ||fS  tyb } z zt |¡ W ‚  ty] } ztd||ƒ W Y d }~‚ d }~ww d }~ww )Nú is not a regular filerV  r   Ú
O_NONBLOCKz!strict record read cleanup failed)rø   r   r  r  rO   rN   rœ  r=   r[   rw  Ú_read_opened_recordrw   rx   r   )	rñ   r�  r}  rj  r^  r¾   r	  Z
read_errorr€   rT   rT   rU   r  Ã  s(   
"úþ€þ€ýr  r¾   r}  r‘   c                 C  s‚   t  | ¡}t |j¡s|› d�}t|ƒ‚t|ƒt|ƒkr%|› d�}t|ƒ‚t  | |d ¡}t|ƒ|kr?|› d|› d�}t|ƒ‚|S )NrŸ  z changed while openingr   z	 exceeds z bytes)	rN   rv   r   r  r  rO   ru   ÚreadrE  )r¾   rñ   r}  r�  Zopened_statrj  r	  rT   rT   rU   r¡  Õ  s   


r¡  c                 C  sˆ   z|  ¡  W d S  tyC   z| ¡ j}W n ty+ } z
t| d d|› �ƒ|‚d }~ww t |¡r9t |¡s9Y d S t| d |› d�ƒd ‚w )Nzcannot inspect z is not a real directory)	Úmkdirr‡  rø   r  rO   r   r   ÚS_ISDIRÚS_ISLNK)ro   rR   rò   rµ   rT   rT   rU   rq   ä  s   €ÿùrq   c                   sJ   ˆ  pˆ   d¡pˆ tjtjhv }|st‡ fdd„dD ƒƒr#d}t|ƒ‚d S )Nr  c                 3  s   � | ]}|ˆ v V  qd S r‚   rT   )r�   Ú	separatorr¢   rT   rU   rŸ   ó  r3  z-_validate_force_break_name.<locals>.<genexpr>)ú/ú\ú z,claim_name must be one public claim basename)r$  rN   rL  Úpardirr¯   rQ   )r£   Zinvalid_componentrj  rT   r¢   rU   rÂ   ñ  s
    þrÂ   c                   sX   t  | ¡�}t‡ fdd„|D ƒƒsttt  t¡ˆ ƒ‚W d   ƒ d S 1 s%w   Y  d S )Nc                 3  s   � | ]}|j ˆ kV  qd S r‚   r¢   )r�   r)  r¢   rT   rU   rŸ   ú  r    z&_require_exact_name.<locals>.<genexpr>)rN   r  r¯   r½   r   r  )rR   r£   r  rT   r¢   rU   rÃ   ø  s
   ÿ"ÿrÃ   rµ   úNotImplementedError | OSErrorc                 C  s>   t |tƒp|jtv pt|dd ƒtv }|rd}t| d |ƒ|‚d S )NÚwinerrorzCfilesystem does not support atomic no-replace hard-link publication)r…   rP   r\   r_   r[   rA   r   )ro   rµ   Úunsupportedrû   rT   rT   rU   r®   þ  s   
ÿýþr®   Ústc                 C  s   | j | jfS r‚   )Úst_devr“   )r®  rT   rT   rU   ru   	  s   ru   )rë   rì   r`   )rH   rI   )rH   rX   )
ro   rd   rñ   r   rò   rÔ   ró   rô   rH   rï   )ro   rd   rñ   r   ró   rô   rH   rï   )rñ   r   rH   rü   )r
  rd   rH   r  )ro   rd   rR   r   r¸   rI   rH   r¶   )ro   rd   rR   r   r¸   rI   rH   r  )
ro   rd   rR   r   r£   rd   r¸   rI   rH   r  )ro   rd   rR   r   r£   rd   rH   r  )rR   r   r  r  r¸   rI   rH   r  )
ro   rd   r£   rd   r  r,  r	  r-  rH   rë   )r£   rd   rH   r>  )r›   rì   r³   rd   rH   rd   )r£   rd   rH   rd   )r³   rd   rH   r-  )rJ  rd   r	  r-  rò   rÔ   rH   rK  )
rR  rT  r(  rU  rò   rÔ   r	  r-  rH   ri   )
rR  rT  rP  rd   r`  rÔ   ra  rc  rH   rd  )rR  rT  r(  rU  ra  rg  rH   ri   )r€   rK  rb  rK  rH   ri   )r*  rd   rH   rd   )rP  rd   rH   r»   )rñ   r   rH   ri   )rR  rT  rP  rd   r˜   rp  rH   ri   )rR   r   r*  rd   rH   ru  )rR  rT  rP  rd   rH   ri   )rR  rT  r£   rd   rH   rc  )rR  rT  r£   rd   r~  rg  rH   ri   )
rR  rT  r£   rd   r^  rÔ   rò   rÔ   rH   rÔ   )rR  rT  r  rd   r€  rd   rH   ri   r‚   )
rR  rT  r  rd   r€  rd   r†  rc  rH   ri   )
rS   rˆ  r‰  rˆ  r‚  rï   rƒ  rï   rH   ri   )rR  rT  r£   rd   rH   ri   )rR   r   r  rd   r€  rd   rH   rK  )rñ   rd   rH   rK  )rŽ  r�  rH   r�  )rñ   rd   rH   r“  )r”  rd   rß   r•  rH   ri   )rR   r   r£   rd   rH   rK  )rñ   r   rH   rš  )rR   rd   rH   rÔ   )rñ   r   r�  rÔ   rH   r-  )rñ   r   r�  rÔ   rH   rž  )
r¾   rÔ   rñ   r   r}  r‘   r�  rÔ   rH   r-  )ro   rd   rR   r   rH   ri   )r£   rd   rH   ri   )rR   r   r£   rd   rH   ri   )ro   rd   rµ   r«  rH   ri   )r®  r‘   rH   rg  )’Ú
__future__r   rÍ   r\   r   rN   r¨   r   r‹  rK   r•   Údataclassesr   r   r   r   r   r   r	   r
   Úpathlibr   Útypingr   r   r   r   Ú_apir   r   r   r   Ú_errorr   Ú	_identityr   r   r   Ú_markerr   Ú_softr   r   Ú_soft_protocolr   Ú_utilr   r   Úcollections.abcr   r    rì   Z_OccupantStater]   r'   rç   r(   r*   r+   r,   r.   r0   r1   r3   r4   r5   r7   r8   r9   r:   ÚS_IFDIRÚS_IFLNKr;   r[   r=   r8  r>   rA   ÚhasattrrC   rw  Úsupports_dir_fdrD   ry  rE   rF   rB   rG   rV   rW   r^   r_   r`   rë   rÏ   r­   rr   rõ   r¼   r  r  r  r  r  r  r§   r  r  rª   r¥   r¬   r«   rO  r\  r[  r]  rM  r%  rö   r&  r#  rt  ri  rf  rZ  r…  rh  r„  re  r±   r�  rØ   r‘  rÚ   rÄ   r—  rN  r  r  r¡  rq   rÂ   rÃ   r®   ru   Ú__all__rT   rT   rT   rU   Ú<module>   sà    $
 \
	ÿ(
	

	üû

