U
ʦi< & @ sb d Z dZdZdZdZdZdZdZdZddl Z ddl
Z
ddl Z ddl Z dd l T d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/g&Z
d0d1 Zd2d
Zd3d Zd4d Zd5d Zd6d Ze jj e_ d7d
Zd8d Zd9d Zd:d Zd;d ZdZ da da d?d Z d@d Z dAd Z!dBd, Z"dCdD Z#e
j$dEkZ%dHdFd.Z&dGd/ Z'dS )Ia 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 )*normcaseisabsjoin
splitdrivesplitsplitextbasenamedirname commonprefixgetsizegetmtimegetatimegetctimeislinkexistslexistsisdirisfileismount
expanduser
expandvarsnormpathabspathsamefile sameopenfilesamestatcurdirpardirseppathsepdefpathaltsepextsepdevnullrealpathsupports_unicode_filenamesrelpath
commonpathc C s t | trdS dS d S )N /r )
isinstancebytespath r2 /usr/lib/python3.8/posixpath.py_get_sep) s
r4 c C s
t | S )z6Normalize case of pathname. Has no effect under Posixosfspath)sr2 r2 r3 r 4 s c C s t | } t| }| |S )z Test whether a path is absolute)r6 r7 r4
startswith)r8 r# r2 r2 r3 r < s
c
G s t | } t| }| }z^|s,|dd | tt j|D ]8}||rL|}q8|rZ||rd||7 }q8||| 7 }q8W n. tttfk
r t j
d| f| Y nX |S )zJoin 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.Nr r ) r6 r7 r4 mapr9 endswith TypeErrorAttributeError BytesWarning genericpath_check_arg_types)apr# r1 br2 r2 r3 r G s
c C s` t | } t| }| |d }| d| | |d }}|rX||t| krX||}||fS )zSplit a pathname. Returns tuple "(head, tail)" where "tail" is
everything after the final slash. Either part may be empty. Nr6 r7 r4 rfindlenrstrip)rB r# iheadtailr2 r2 r3 r d s
c C s6 t | } t| tr d}d}nd}d}t| |d |S )Nr- .r r )r6 r7 r. r/ r? _splitext)rB r# r' r2 r2 r3 r u s
c C s t | } | dd | fS )zJSplit a pathname into drive and path. On Posix, drive is always
empty.Nr r5 )rB r2 r2 r3 r
s
c C s, t | } t| }| |d }| |d S )z)Returns the final component of a pathnamerD N)r6 r7 r4 rF )rB r# rI r2 r2 r3 r
s
c C sN t | } t| }| |d }| d| }|rJ||t| krJ||}|S )z-Returns the directory component of a pathnamerD NrE )rB r# rI rJ r2 r2 r3 r s
c
C s8 zt | }W n tttfk
r* Y dS X t|jS )z&Test whether a path is a symbolic linkF)r6 lstatOSError
ValueErrorr= statS_ISLNKst_mode)r1 str2 r2 r3 r s
c C s. zt | W n ttfk
r( Y dS X dS )zCTest whether a path exists. Returns True for broken symbolic linksFT)r6 rN rO rP r0 r2 r2 r3 r s
c C s zt | }W n ttfk
r( Y dS X t|jr:dS t| trPt | d}n
t | d}t
|}zt |}W n ttfk
r Y dS X |j }|j }||krdS |j }|j }||krdS dS )z$Test whether a path is a mount pointF ..r T)
r6 rN rO rP rQ rR rS r. r/ r r) st_devst_ino)r1 s1parents2dev1dev2ino1ino2r2 r2 r3 r s.
c C s< t | } t| trd}nd}| |s,| S t| }| |d}|dk rPt| }|dkrdt jkrddl }z|
t j }W q t
k
r | Y S X n
t jd }nVddl }| d| }t|trt|d}z||}W n t
k
r | Y S X |j }t| trt |}d}nd }||}|| |d p:|S )
zOExpand ~ and ~user constructions. If user or $HOME is unknown,
do nothing. ~~rD r HOMENASCIIr- r )r6 r7 r. r/ r9 r4 findrG environpwdgetpwuidgetuidpw_dirKeyErrorstrgetpwnamfsencoderH ) r1 tilder# rI re userhomenamepwentrootr2 r2 r3 r sB
z\$(\w+|\{[^}]*\}?)c s t | } t| trZd| kr | S ts@ddl}|t |j j
at}dd t t ddn:d| krf| S t sddl}|t|j j
a t }dd t j
fd
d }||| S ) zZExpand shell variables of form $var and ${var}. Unknown variables
are left unchanged. $r N { }environb${}c s | d }| r0| s$| d S |dd }z,d krRttjt| }n| }W n tk
rx | d Y S X |S d S )NrD r )r9 r; r6 rl rd fsdecoderi )mro valueendrd startr2 r3 repl4 s
zexpandvars..repl)r6 r7 r. r/ _varsubbrecompile _varpatternencoderb subgetattr_varsubrd )r1 r r r r2 r} r3 r s,
c C s t | } t| tr&d}d}d}d}nd}d}d}d}| |krB|S | |}|rp| |d rp| |d
spd }| |}g }|D ]J}|||fkrq||ks|s|r|r|d |kr|| q|r| q|}||} |r|| | } | p|S ) z0Normalize path, eliminating double slashes, etc.r- rL rU r r r ry ) r6 r7 r. r/ r9 r appendpopr ) r1 r# emptydotdotdotinitial_slashescomps new_compscompr2 r2 r3 r K sJ
c C s@ t | } t| s8t| tr&t }nt }t|| } t| S )zReturn an absolute path.) r6 r7 r r. r/ getcwdbgetcwdr r )r1 cwdr2 r2 r3 r q s
c C s* t | } t| dd | i \}}t|S )zlReturn the canonical path of the specified filename, eliminating any
symbolic links encountered in the path.Nr )r6 r7
_joinrealpathr )filenamer1 okr2 r2 r3 r) s
c
C s t | trd}d}d}n d}d}d}t|r<|dd }|} |r||\}}}|r<||kr`q<||kr| rt| \} }||krt| ||} q<|} q s zrelpath..c S s g | ] }|r|qS r2 r2 r r2 r2 r3 r s r+ )rP r6 r7 r. r/ r r rG r r r< r= r> DeprecationWarningr? r@ ) r1 r r! r# r"
start_list path_listrI rel_listr2 r2 r3 r+ s0
c s2 | s t dtttj| } t| d tr4dd ndd zƇfdd| D }z tfd d
| D \}W n t k
r t d d Y nX fd
d|D }t|}t |}|}t
|D ]$\}}||| kr|d | } qq|rn
d d }| | W S t t
fk
r, tjd| Y nX d S )zDGiven a sequence of path names, returns the longest common sub-path.z%commonpath() arg is an empty sequencer r- rL r r c s g | ]}| qS r2 )r )r r1 r# r2 r3 r s z commonpath..c 3 s | ]}|d d kV qd S )NrD r2 )r rB r r2 r3 s z commonpath..z%Can't mix absolute and relative pathsNc s g | ]} fd d|D qS )c s g | ]}|r| kr|qS r2 r2 )r cr! r2 r3 r s z)commonpath...r2 )r r8 r r2 r3 r s r, )r, )rP tupler: r6 r7 r. r/ setminmax enumerater r< r= r? r@ ) paths split_pathsr rX rZ commonrI r prefixr2 )r! r# r3 r, s6 )N)(__doc__r! r" r' r# r$ r% r& r( r6 sysrQ r? __all__r4 r r r r r rM r
r
r r r r r r r r r r r r) r platformr* r+ r, r2 r2 r2 r3 s
*21& 3
)