ó
    F\h¸G  ã                   ó‚  • S r SrSrSrSrSrSrSrSrSSK	r	SSK
r
SSKrSSKrSSKrSS	K7  / S
QrS rS rS rS rS rS r\R*                  R                   \l         S r SSKJr  S rS rS rS rSqSq S r! SSKJ"r#  S r$SS.S jr%\RL                  S:H  r'S"S  jr(S! r)g! \ a    S r NGf = f! \ a    S r# N<f = f)#aÙ  Common operations on Posix pathnames.

Instead of importing this module directly, import os and refer to
this module as os.path.  The "os.path" name is an alias for this
module on Posix systems; on other systems (e.g. Windows),
os.path provides the same operations in a manner specific to that
platform, and is an alias to another module (e.g. ntpath).

Some of this can actually be useful on non-Posix systems too, e.g.
for manipulation of the pathname component of URLs.
Ú.ú..Ú/Ú:z/bin:/usr/binNz	/dev/nullé    )Ú*)*ÚnormcaseÚisabsÚjoinÚ
splitdriveÚ	splitrootÚsplitÚsplitextÚbasenameÚdirnameÚcommonprefixÚgetsizeÚgetmtimeÚgetatimeÚgetctimeÚislinkÚexistsÚlexistsÚisdirÚisfileÚismountÚ
expanduserÚ
expandvarsÚnormpathÚabspathÚsamefileÚsameopenfileÚsamestatÚcurdirÚpardirÚsepÚpathsepÚdefpathÚaltsepÚextsepÚdevnullÚrealpathÚsupports_unicode_filenamesÚrelpathÚ
commonpathÚ
isjunctionÚ
isdevdriveÚALLOW_MISSINGc                 ó0   • [        U [        5      (       a  gg)Nó   /r   )Ú
isinstanceÚbytes©Úpaths    Ú /usr/lib/python3.13/posixpath.pyÚ_get_sepr9   *   s   € Ü�$œ×ÑØàó    c                 ó.   • [         R                  " U 5      $ )z6Normalize case of pathname.  Has no effect under Posix©ÚosÚfspath)Úss    r8   r   r   5   s   € ä�9Š9�Q‹<Ðr:   c                 óf   • [         R                  " U 5      n [        U 5      nU R                  U5      $ )zTest whether a path is absolute)r=   r>   r9   Ú
startswith)r?   r%   s     r8   r	   r	   =   s'   € ä
�	Š	�!‹€AÜ
�1‹+€CØ�<‰<˜ÓÐr:   c                 óx  • [         R                  " U 5      n [        U 5      nU n U H]  n[         R                  " U5      nUR                  U5      (       d  U(       d  UnM:  UR	                  U5      (       a  X4-  nMV  X2U-   -  nM_     U$ ! [
        [        [        4 a    [        R                  " SU /UQ76   e f = f)zÚJoin two or more pathname components, inserting '/' as needed.
If any component is an absolute path, all previous path components
will be discarded.  An empty last part will result in a path that
ends with a separator.r
   )
r=   r>   r9   rA   ÚendswithÚ	TypeErrorÚAttributeErrorÚBytesWarningÚgenericpathÚ_check_arg_types)ÚaÚpr%   r7   Úbs        r8   r
   r
   H   s©   € ô
 	�	Š	�!‹€AÜ
�1‹+€CØ€DðÛˆAÜ—	’	˜!“ˆAØ�|‰|˜C× Ñ ®Ø’Ø—‘˜s×#Ñ#Ø‘	’à˜a™‘’ñ ð €Køô ”~¤|Ð4ó Ü×$Ò$ V¨QÐ3°Ó3Øðús   ¥A#B
 Â
/B9c                 óÔ   • [         R                  " U 5      n [        U 5      nU R                  U5      S-   nU SU XS pCU(       a"  X1[	        U5      -  :w  a  UR                  U5      nX44$ )z|Split a pathname.  Returns tuple "(head, tail)" where "tail" is
everything after the final slash.  Either part may be empty.é   N©r=   r>   r9   ÚrfindÚlenÚrstrip)rJ   r%   ÚiÚheadÚtails        r8   r   r   d   sc   € ô 	�	Š	�!‹€AÜ
�1‹+€CØ	�‰�‹�qÑ€AØ�2�A�˜˜"˜ˆ$Þ�œC ›I™Ó%Ø�{‰{˜3ÓˆØˆ:Ðr:   c                 óš   • [         R                  " U 5      n [        U [        5      (       a  SnSnOSnSn[        R
                  " XS U5      $ )Nr3   ó   .r   r   )r=   r>   r4   r5   rG   Ú	_splitext)rJ   r%   r)   s      r8   r   r   u   sE   € Ü
�	Š	�!‹€AÜ�!”U×ÑØˆØ‰àˆØˆÜ× Ò  ¨¨vÓ6Ð6r:   c                 ó<   • [         R                  " U 5      n U SS U 4$ )zFSplit a pathname into drive and path. On Posix, drive is always
empty.Nr   r<   )rJ   s    r8   r   r   ƒ   s    € ô 	�	Š	�!‹€AØˆRˆaˆ5�!ˆ8€Or:   )Ú_path_splitroot_exc                 óÊ   • [         R                  " U 5      n [        U [        5      (       a  SnSnOSnSnU SS U:w  a  X"U 4$ U SS U:w  d	  U SS U:X  a  X!U SS 4$ X SS U SS 4$ )	zWSplit a pathname into drive, root and tail.

The tail contains anything after the root.r3   r:   r   Ú NrM   é   é   )r=   r>   r4   r5   )rJ   r%   Úemptys      r8   r   r   �   sŒ   € ô �IŠI�a‹LˆÜ�aœ×ÑØˆCØ‰EàˆCØˆEØˆRˆaˆ5�C‹<à �?Ð"Øˆq�ˆV�s‹]˜a  !˜f¨›mà˜q  ˜uÐ$Ð$ð ˜B˜Q˜%  1 2 Ð&Ð&r:   c                 ót   • [         R                  " U 5      n [        U 5      nU R                  U5      S-   nXS $ )z)Returns the final component of a pathnamerM   N)r=   r>   r9   rO   )rJ   r%   rR   s      r8   r   r   ¦   s3   € ä
�	Š	�!‹€AÜ
�1‹+€CØ	�‰�‹�qÑ€AØˆRˆ5€Lr:   c                 óÌ   • [         R                  " U 5      n [        U 5      nU R                  U5      S-   nU SU nU(       a"  X1[	        U5      -  :w  a  UR                  U5      nU$ )z-Returns the directory component of a pathnamerM   NrN   )rJ   r%   rR   rS   s       r8   r   r   °   sX   € ä
�	Š	�!‹€AÜ
�1‹+€CØ	�‰�‹�qÑ€AØˆRˆaˆ5€DÞ�œC ›I™Ó%Ø�{‰{˜3ÓˆØ€Kr:   c                 óX  •  [         R                  " U 5      n[        R                  " UR                  5      (       a  g [         R                  " U 5      n [        U [        5      (       a  [        U S5      nO[        U S5      n [         R                  " U5      nUR                  UR                  :g  =(       d    UR                  UR                  :H  $ ! [
        [        4 a     gf = f! [
         a6    [        U5      n [         R                  " U5      n N}! [
         a      gf = ff = f)z$Test whether a path is a mount pointFó   ..r   )r=   ÚlstatÚstatÚS_ISLNKÚst_modeÚOSErrorÚ
ValueErrorr>   r4   r5   r
   r+   Úst_devÚst_ino)r7   Ús1ÚparentÚs2s       r8   r   r   ¾   s÷   € ðÜ�XŠX�d‹^ˆô �<Š<˜Ÿ
™
×#Ñ#Øð $ô �9Š9�T‹?€DÜ�$œ×ÑÜ�d˜EÓ"‰ä�d˜DÓ!ˆðÜ�XŠX�fÓˆð �9‰9˜Ÿ	™	Ñ!×; R§Y¡Y°"·)±)Ñ%;Ð;øô/ ”ZÐ ó áðûô ó Ü˜&Ó!ˆð	Ü—’˜&Ó!ŠBøÜó 	Úð	úð	ús;   ‚C ÂC) ÃC&Ã%C&Ã)D)Ã?DÄ
D%Ä!D)Ä$D%Ä%D)c                 ó´  • [         R                  " U 5      n [        U [        5      (       a  SnOSnU R	                  U5      (       d  U $ [        U 5      nU R                  US5      nUS:  a  [        U 5      nUS:X  a]  S[         R                  ;  a5   SSK	n UR                  [         R                  " 5       5      R                  nOg[         R                  S   nOS SSK	nU SU n[        U[        5      (       a  [         R                  " U5      n UR!                  U5      nUR                  nUc  ["        R$                  S:X  a  U $ [        U [        5      (       a  [         R&                  " U5      nUR)                  U5      nXPUS -   =(       d    U$ ! [         a    U s $ f = f! [         a    U s $ f = f! [         a    U s $ f = f! [         a    U s $ f = f)zKExpand ~ and ~user constructions.  If user or $HOME is unknown,
do nothing.ó   ~Ú~rM   r   ÚHOMENÚvxworks)r=   r>   r4   r5   rA   r9   ÚfindrP   ÚenvironÚpwdÚImportErrorÚgetpwuidÚgetuidÚpw_dirÚKeyErrorÚfsdecodeÚgetpwnamÚsysÚplatformÚfsencoderQ   )r7   Útilder%   rR   ru   ÚuserhomeÚnameÚpwents           r8   r   r   å   sª  € ô �9Š9�T‹?€DÜ�$œ×ÑØ‰àˆØ�?‰?˜5×!Ñ!ØˆÜ
�4‹.€CØ�	‰	�#�qÓ€AØˆ1ƒuÜ�‹IˆØˆAƒvØœŸ™Ó#ðÛðØŸ<™<¬¯	ª	«Ó4×;Ñ;‘ô —z‘z &Ñ)‰Hð	Ûð �A�aˆyˆÜ�dœE×"Ñ"Ü—;’;˜tÓ$ˆDð	Ø—L‘L Ó&ˆEð
 —<‘<ˆàÑœCŸL™L¨IÓ5ØˆÜ�$œ×ÑÜ—;’;˜xÓ(ˆØ�‰˜sÓ#€HØ˜A˜B�xÑ×' CÐ'øôC ó à’ðûô
 ó ð ’ðûô ó 	àŠKð	ûô ó 	ð ŠKð	úsH   ÂF Â.F$ ÃF6 ÄG ÆF!Æ F!Æ$F3Æ2F3Æ6GÇGÇGÇGc                 ór  • [         R                  " U 5      n [        U [        5      (       aY  SU ;  a  U $ [        (       d   SSKnUR                  SUR                  5      q[        R                  nSnSn[        [         SS5      nOWSU ;  a  U $ [        (       d   SSKnUR                  S	UR                  5      q
[        R                  nS
nSn[         R                  nSn U" X5      nU(       d   U $ UR                  S5      u  phUR                  S5      n	U	R                  U5      (       a  U	R                  U5      (       a  U	SS n	 Uc<  [         R                   " [         R                  [         R"                  " U	5         5      n
OXY   n
XS nU SU U
-   n [%        U 5      nX-  n MÈ  ! [&         a    Un Nf = f)zVExpand shell variables of form $var and ${var}.  Unknown variables
are left unchanged.ó   $r   Ns   \$(\w+|\{[^}]*\})ó   {ó   }ÚenvironbÚ$z\$(\w+|\{[^}]*\})Ú{Ú}rM   éÿÿÿÿ)r=   r>   r4   r5   Ú	_varprogbÚreÚcompileÚASCIIÚsearchÚgetattrÚ_varprogrt   ÚspanÚgrouprA   rC   r   r{   rP   rz   )r7   rŽ   r‘   ÚstartÚendrt   rR   ÚmÚjr‚   ÚvaluerT   s               r8   r   r   "  s‹  € ô �9Š9�T‹?€Dä�$œ×ÑØ�tÓØˆKßŠyÛØŸ
™
Ð#8¸"¿(¹(ÓCˆIÜ×!Ñ!ˆØˆØˆÜœ"˜j¨$Ó/‰à�d‹?ØˆKßŠxÛØ—z‘zÐ"6¸¿¹ÓAˆHÜ—‘ˆØˆØˆÜ—*‘*ˆØ	€AØ
Ù�4‹OˆÞØð" €Kð! �v‰v�a‹y‰ˆØ�w‰w�q‹zˆØ�?‰?˜5×!Ñ! d§m¡m°C×&8Ñ&8Ø˜˜"�:ˆDð	Ø‰ÜŸš¤B§J¡J¬r¯{ª{¸4Ó/@Ñ$AÓB‘à™�ð ˜�8ˆDØ˜˜�8˜eÑ#ˆDÜ�D“	ˆAØ‰LˆDñ' øô ó 	ØŠAð	ús   ÅAF' Æ'F6Æ5F6)Ú_path_normpathc                 óÒ  • [         R                  " U 5      n [        U [        5      (       a  SnSnSnOSnSnSnU (       d  U$ [	        U 5      u  pEn U R                  U5      n/ nU H`  nU(       a  X‚:X  a  M  Xƒ:w  d  U(       d  U(       a  U(       a  US   U:X  a  UR                  U5        MG  U(       d  MP  UR                  5         Mb     UnXQR                  U5      -   n U =(       d    U$ )z0Normalize path, eliminating double slashes, etc.r3   rV   rb   r   r   r   rŒ   )	r=   r>   r4   r5   r   r   ÚappendÚpopr
   )	r7   r%   ÚdotÚdotdotÚ_Úinitial_slashesÚcompsÚ	new_compsÚcomps	            r8   r   r   [  sÊ   € ä�yŠy˜‹ˆÜ�dœE×"Ñ"ØˆCØˆCØ‰FàˆCØˆCØˆFÞØˆJÜ#,¨T£?Ñ ˆ˜DØ—
‘
˜3“ˆØˆ	ÛˆDÞ˜4›;ÙØ“¦¾yÞ 	¨"¡°Ó 7Ø× Ñ  Ö&ß�Ø—‘–ñ ð ˆØ§¡¨%£Ñ0ˆØ�{�sÐr:   c                 óD  • [         R                  " U 5      n [        U [        5      (       a6  U R	                  S5      (       d  [        [         R                  " 5       U 5      n O5U R	                  S5      (       d  [        [         R                  " 5       U 5      n [        U 5      $ )zReturn an absolute path.r3   r   )	r=   r>   r4   r5   rA   r
   ÚgetcwdbÚgetcwdr   r6   s    r8   r   r   x  si   € ä�9Š9�T‹?€DÜ�$œ×ÑØ�‰˜t×$Ñ$ÜœŸ
š
› dÓ+ˆDøà�‰˜s×#Ñ#ÜœŸ	š	› TÓ*ˆDÜ�D‹>Ðr:   F)Ústrictc                ót  • [         R                  " U 5      n [        U [        5      (       a  SnSnSn[         R                  nOSnSnSn[         R
                  nU[        L a	  [        nSnOU(       a  SnO[        nS	nU R                  U5      S	S	S
2   n[        U5      n	U R                  U5      (       a  UOU" 5       n
0 nU	(       Ga×  UR                  5       nUc  X«UR                  5       '   M/  U	S-  n	U(       a  XÃ:X  a  MB  XÄ:X  a  U
S	U
R                  U5       =(       d    Un
Mf  X¢:X  a  X¬-   nOX¢-   U-   n [         R                  " U5      R                  n[         R"                  " U5      (       dk  U(       a_  U	(       aX  [         R$                  " U5      (       d=  [        [&        R(                  [         R*                  " [&        R(                  5      U5      eUn
GM  XÛ;   a,  X½   n
U
b  GM-  U(       a  [         R                   " U5        Un
GMO  [         R,                  " U5      nUR                  U5      (       a  Un
Uc&  S	X½'   UR/                  U5        UR/                  S	5        UR                  U5      S	S	S
2   nUR1                  U5        U	[        U5      -  n	GMß  U
$ ! U a     Of = fUn
U	(       a  GMñ  N)zlReturn the canonical path of the specified filename, eliminating any
symbolic links encountered in the path.r3   rV   rb   r   r   r   T© NrŒ   rM   )r=   r>   r4   r5   r§   r¨   r1   ÚFileNotFoundErrorrg   r   rP   rA   rž   Úrindexrc   rf   rd   re   ÚS_ISDIRÚerrnoÚENOTDIRÚstrerrorÚreadlinkr�   Úextend)Úfilenamer©   r%   r#   r$   r¨   Úignored_errorÚmaxlinksÚrestÚ
part_countr7   Úseenr‚   Únewpathrf   ÚtargetÚtarget_partss                    r8   r+   r+   ‡  sk  € ô �yŠy˜Ó"€HÜ�(œE×"Ñ"ØˆØˆØˆÜ—‘‰àˆØˆØˆÜ—‘ˆØ”ÒÜ)ˆØ‰Þ	Ø‰äˆà€Hð �>‰>˜#Ó™t ˜tÑ$€Dô �T“€Jð ×%Ñ% c×*Ñ*‰3±³€Dð €Dç
Ø�x‰x‹zˆØ‰<à#�—‘“ÑÙØ�a‰ˆ
Þ�t“~áØ‹>àÐ)˜Ÿ™ SÓ)Ð*×1¨cˆDÙØ‹;Ø‘k‰Gà‘j 4Ñ'ˆGð(	Ü—h’h˜wÓ'×/Ñ/ˆGÜ—<’< ×(Ñ(Þžj´·²¸g×1FÑ1FÜ!¤%§-¡-´·²¼U¿]¹]Ó1KØ")ó+ð +à�ÚØ‹à‘}�ØÑ#âæä—G’G˜GÔ$Ø�ÚÜ—[’[ Ó)ˆFð
 × Ñ  ×%Ñ%à�ØÑà $�‘ð —‘˜GÔ$Ø—‘˜DÔ!à!Ÿ<™<¨Ó,©T¨r¨TÑ2ˆLØ�K‰K˜Ô%Øœ#˜lÓ+Ñ+ˆJÚð €Køð/ ó 	Ùð	úð* ˆ÷y Š*s%   Ä8B#J! ÇJ! Ç-J! ÈJ! Ê!J*Ê)J*Údarwinc                 ó˜  • [         R                  " U 5      n U (       d  [        S5      e[        U [        5      (       a  SnSnSnOSnSnSnUc  UnO[         R                  " U5      n [        U5      R                  U5      n[        U 5      R                  U5      nU(       a  UR                  U5      O/ nU(       a  UR                  U5      O/ n[        [        Xx/5      5      n	U/[        U5      U	-
  -  X‰S -   n
U
(       d  U$ UR                  U
5      $ ! [        [        [        [        4 a    [        R                   " S	X5        e f = f)
z#Return a relative version of a pathzno path specifiedrV   r3   rb   r   r   r   Nr-   )r=   r>   rh   r4   r5   r   Úlstripr   rP   r   r
   rD   rE   rF   ÚDeprecationWarningrG   rH   )r7   r–   r#   r%   r$   Ú
start_tailÚ	path_tailÚ
start_listÚ	path_listrR   Úrel_lists              r8   r-   r-   ö  s)  € ô �9Š9�T‹?€DÞÜÐ,Ó-Ð-ä�$œ×ÑØˆØˆØ‰àˆØˆØˆà�}Ø‰ä—	’	˜%Ó ˆðÜ˜U“^×*Ñ*¨3Ó/ˆ
Ü˜D“M×(Ñ(¨Ó-ˆ	Þ.8�Z×%Ñ% cÔ*¸bˆ
Þ,5�I—O‘O CÔ(¸2ˆ	ä”˜jÐ4Ó5Ó6ˆà�8œs :›¨qÑ0Ñ1°I¸b°MÑAˆÞØˆMØ�x‰x˜Ó!Ð!øÜ”~¤|Ô5GÐHó Ü×$Ò$ Y°Ô<Øðús   Á(BD ÄD Ä3E	c           	      ó  • [        [        [        R                  U 5      5      n U (       d  [	        S5      e[        U S   [        5      (       a  SnSnOSnSn U  Vs/ s H  o3R                  U5      PM     nn U  Vs1 s H  oUR                  U5      iM     snu  nU VVs/ s H$  ow Vs/ s H  oˆ(       d  M  X‚:w  d  M  UPM     snPM&     nnn[        U5      n	[        U5      n
U	n[        U	5       H  u  pÈXŠU   :w  d  M  U	SU n  O   U(       a  UOUSS nXÑR                  U5      -   $ s  snf s  snf ! [         a    [	        S5      Sef = fs  snf s  snnf ! [        [        4 a    [        R                   " S	/U Q76   e f = f)
zDGiven a sequence of path names, returns the longest common sub-path.z%commonpath() arg is an empty sequencer   r3   rV   r   r   z%Can't mix absolute and relative pathsNr.   )ÚtupleÚmapr=   r>   rh   r4   r5   r   rA   ÚminÚmaxÚ	enumerater
   rD   rE   rG   rH   )Úpathsr%   r#   r7   Úsplit_pathsrJ   r	   r?   Úcrk   rm   ÚcommonrR   Úprefixs                 r8   r.   r.   !  s}  € ô ”#”b—i‘i Ó'Ó(€EæÜÐ@ÓAÐAä�%˜‘(œE×"Ñ"ØˆØ‰àˆØˆðÙ38Ó9²5¨4—z‘z #–±5ˆÐ9ð	PÙ16Ó7²¨A—l‘l 3Ö'±Ñ7‰FˆEñ EPÔPÂK¸q 1Ó:¢1˜a«›¨a©kŸ¡1Ô:ÁKˆÑPÜ�ÓˆÜ�ÓˆØˆÜ˜b–M‰DˆAØ�q‘E�zØ˜B˜Q˜�Ùñ "ö
 ‘ 3 r¨ 7ˆØŸ™ Ó(Ñ(Ð(ùò# :ùò 8øÜó 	PÜÐDÓEÈ4ÐOð	Püò ;ùÓPøô ”~Ð&ó Ü×$Ò$ \Ð:°EÓ:Øðús~   ÁE ÁD+Á6E Á9D5 Á=D0ÂD5 ÂE Â!	EÂ*
EÂ8EÂ?EÃEÃ1E Ä)E Ä+E Ä0D5 Ä5EÅE ÅEÅE Å)F)N)*Ú__doc__r#   r$   r)   r%   r&   r'   r(   r*   r¯   r=   r}   rd   rG   Ú__all__r9   r   r	   r
   r   r   rW   r   ÚposixrY   r   rv   r   r   r   r   r“   r�   r   r›   r   r   r+   r~   r,   r-   r.   r«   r:   r8   Ú<module>rÔ      s  ðñ
ð 
€Ø	€Ø	€Ø	€Ø
€Ø
€Ø	€Ø
€ã Û 	Û 
Û Û Ü òD€òòòòò8	ò"7ð ×(Ñ(×0Ñ0€Ô ò
ð'Ý5ò6òò<òN3(ðt €Ø€	ò.ðjÝ0ò@	ð "'õ jðZ "Ÿl™l¨hÑ6Ð ô#óV$øðk ó 'ô'ð'ûð\ ó ôðús$   Á!B# Á;B2 Â#	B/Â.B/Â2	B>Â=B>