a
XC?h? @ s d Z dZdZdZdZdZdZdZdZddl Z ddl
Z
ddl Z ddl Z dd l T g d
Z
d d Zd
d Zdd Zdd Zdd Zdd Ze jj e_ dd Zdd Zdd Zd d Zd d Zd!d" Zd#d$ Zda da d%d& Z d'd( Z d)d* Z d+d,d-d.Z!d/d0 Z"e
j#d1kZ$d6d2d3Z%d4d5 Z&dS )7a 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
commonpath
ALLOW_MISSINGc C s t | trdS dS d S )N /r )
isinstancebytespath r3 ./opt/alt/python39/lib64/python3.9/posixpath.py_get_sep) s
r5 c C s
t | S )z6Normalize case of pathname. Has no effect under Posixosfspath)sr3 r3 r4 r 4 s r c C s t | } t| }| |S )z Test whether a path is absolute)r7 r8 r5
startswith)r9 r# r3 r3 r4 r < s
r c
G s t | } t| }| }z^|s,|dd | tt j|D ]8}||rL|}q8|rZ||rd||7 }q8||| 7 }q8W n. tttfy t j
d| g|R Y n0 |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 ) r7 r8 r5 mapr: endswith TypeErrorAttributeError BytesWarning genericpath_check_arg_types)apr# r2 br3 r3 r4 r G s
r 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. Nr7 r8 r5 rfindlenrstrip)rC r# iheadtailr3 r3 r4 r d s
r c C s6 t | } t| tr d}d}nd}d}t| |d |S )Nr. .r r )r7 r8 r/ r0 r@ _splitext)rC r# r' r3 r3 r4 r u s
r c C s t | } | dd | fS )zJSplit a pathname into drive and path. On Posix, drive is always
empty.Nr r6 )rC r3 r3 r4 r
s
r
c C s, t | } t| }| |d }| |d S )z)Returns the final component of a pathnamerE N)r7 r8 r5 rG )rC r# rJ r3 r3 r4 r
s
r
c C sN t | } t| }| |d }| d| }|rJ||t| krJ||}|S )z-Returns the directory component of a pathnamerE NrF )rC r# rJ rK r3 r3 r4 r s
r c
C s6 zt | }W n tttfy( Y dS 0 t|jS )z&Test whether a path is a symbolic linkF)r7 lstatOSError
ValueErrorr> statS_ISLNKst_mode)r2 str3 r3 r4 r s
r c C s, zt | W n ttfy& Y dS 0 dS )zCTest whether a path exists. Returns True for broken symbolic linksFT)r7 rO rP rQ r1 r3 r3 r4 r s
r c C s zt | }W n ttfy& Y dS 0 t|jr8dS t| trNt | d}n
t | d}t
|}zt |}W n ttfy Y dS 0 |j }|j }||krdS |j }|j }||krdS dS )z$Test whether a path is a mount pointF ..r T)
r7 rO rP rQ rR rS rT r/ r0 r r) st_devst_ino)r2 s1parents2dev1dev2ino1ino2r3 r3 r4 r s.
r c C s8 t | } t| trd}nd}| |s,| S t| }| |d}|dk rPt| }|dkrdt jvrddl }z|
t j }W q t
y | Y S 0 n
t jd }nTddl }| d| }t|trt|d}z||}W n t
y | Y S 0 |j }t| trt |}d}nd }||}|| |d p6|S )
zOExpand ~ and ~user constructions. If user or $HOME is unknown,
do nothing. ~~rE r HOMENASCIIr. r )r7 r8 r/ r0 r: r5 findrH environpwdgetpwuidgetuidpw_dirKeyErrorstrgetpwnamfsencoderI ) r2 tilder# rJ rf userhomenamepwentrootr3 r3 r4 r sB
r c C sX t | } t| trVd| vr | S ts:ddl}|d|jatj}d}d}t t dd}n:d| vrb| S t
s|ddl}|d |ja
t
j}d
}d }t j }d}|| |}|sqT| d\}}|
d } | |r| |r| d d
} z.|du rt t j t | }
n|| }
W n ty$ |}Y q0 | |d } | d| |
} t| }| | 7 } q| S )zZExpand shell variables of form $var and ${var}. Unknown variables
are left unchanged. $r Ns \$(\w+|\{[^}]*\}) { }environb$z\$(\w+|\{[^}]*\}){}rE )r7 r8 r/ r0 _varprogbrecompilerc searchgetattr_varprogre spangroupr: r< rm fsdecoderj rH ) r2 r| r~ startendre rJ mjrp valuerL r3 r3 r4 r sN
r c C s t | } t| tr&d}d}d}d}nd}d}d}d}| |krB|S | |}|rp| |d rp| |d
spd }| |}g }|D ]J}|||fv rq||ks|s|r|r|d |kr|| q|r| q|}||} |r|| | } | p|S ) z0Normalize path, eliminating double slashes, etc.r. rM rV r r r rz ) r7 r8 r/ r0 r: r appendpopr ) r2 r# emptydotdotdotinitial_slashescomps new_compscompr3 r3 r4 r N sJ
r c C s@ t | } t| s8t| tr&t }nt }t|| } t| S )zReturn an absolute path.) r7 r8 r r/ r0 getcwdbgetcwdr r )r2 cwdr3 r3 r4 r u s
r F)strictc 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 )r7 r8
_joinrealpathr )filenamer r2 okr3 r3 r4 r) s
r) c C s t | trd}d}d}nd}d}d}tj}|tu r8t}n|rBd}nt}d } t|rb|dd }|} |r~||\}
} }|
rb|
|krqb|
|kr| rt | \} }
|
|krt
| ||} qb|} qbt
| |
} zt | }
W n |y d }Y n0 t
|
j}|s| } qb| |v r@|| } | d ur qb|r2t | nt
| |d fS d || < t| t| ||\} }|stt
| |d fS | || < qb| d
fS ) Nr. rM rV r r r r3 rE FT)r/ r0 r7 r r- FileNotFoundErrorrP r partitionr r rO rR rS rT r readlink)r2 restr seenr# r! r" r
ignored_errormaxlinksrp _newpathrU is_linkr r3 r3 r4 r sd
r darwinc C s | s t dt| } t| tr.d}d}d}n d}d}d}|du rH|}n
t|}zrd d
t||D }d d
t| |D }tt||g}|gt|| ||d }|s|W S t | W S t
t t t
fy td | | Y n0 dS )
z#Return a relative version of a pathzno path specifiedrM r. rV r r r Nc S s g | ] }|r|qS r3 r3 .0xr3 r3 r4
r zrelpath..c S s g | ] }|r|qS r3 r3 r r3 r3 r4 r r r+ )rQ r7 r8 r/ r0 r r rH r r r= r> r? DeprecationWarningr@ rA ) r2 r r! r# r"
start_list path_listrJ rel_listr3 r3 r4 r+ s0
r+ c s2 | s t dtttj| } t| d tr4dd ndd zćfdd| D }z tfd d
| D \}W n t y t d d Y n0 fd
d|D }t|}t |}|}t
|D ]$\}}||| kr|d | } qq|rn
d d }| | W S t t
fy, tjdg| R Y n0 d S )zDGiven a sequence of path names, returns the longest common sub-path.z%commonpath() arg is an empty sequencer r. rM r r c s g | ]}| qS r3 )r )r r2 r# r3 r4 r
r z commonpath..c 3 s | ]}|d d kV qd S )NrE r3 )r rC r r3 r4 r z commonpath..z%Can't mix absolute and relative pathsNc s g | ]} fd d|D qS )c s g | ]}|r| kr|qS r3 r3 )r cr! r3 r4 r r z)commonpath...r3 )r r9 r r3 r4 r r r, )rQ tupler; r7 r8 r/ r0 setminmax enumerater r= r> r@ rA ) paths split_pathsr rY r[ commonrJ r prefixr3 )r! r# r4 r, s6 r, )N)'__doc__r! r" r' r# r$ r% r& r( r7 sysrR r@ __all__r5 r r r r r rN r
r
r r r r r r r{ r r r r) r platformr* r+ r, r3 r3 r3 r4 sL
*25' F
)