python (3.12.0)
ˑe d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z ddl m
Z
mZmZmZ ddlmZmZmZmZmZmZmZ ddlmZ g dZ e h dd D ch c] } d
| c} z d D ch c] } d | c} z Z d Z d
Z dZ!e
eeefZ"e e e!fZ#d Z$ejJ d Z& ejN d jQ d \ Z)Z* e+ e,e) e,e* Z-e.j_ ddd e.j_ ddd dZ0 ejb d Z2 ejb d d Z3 ejb d Z4 G d d Z5 G d d Z6 G d! d"e5 Z7 G d# d$e5 Z8 G d% d&e5 Z9 G d' d(e9 Z: G d) d*e Z; G d+ d,e< Z=ej| j e= G d- d.e= Z@ G d/ d0e= ZA G d1 d2e= ZB G d3 d4eBe@ ZC G d5 d6eBeA ZDyc c} w c c} w )7zObject-oriented filesystem paths.
This module provides classes to represent abstract paths and concrete
paths with operations that have semantics appropriate for different
operating systems.
N)Sequence)ENOENTENOTDIREBADFELOOP)S_ISDIRS_ISLNKS_ISREGS_ISSOCKS_ISBLKS_ISCHRS_ISFIFO)quote_from_bytes)PurePath
PurePosixPathPureWindowsPathPath PosixPath WindowsPath> CONIN$CONOUT$AUXCONNULPRNu 123456789¹²³COMLPT { i c R t | dd t v xs t | dd t v S )Nerrnowinerror)getattr_IGNORED_ERRNOS_IGNORED_WINERRORS) exceptions ;/BuggyBox/python/3.12.0/bootstrap/lib/python3.12/pathlib.py
_ignore_errorr( 4 s1 Iw - @
G Iz4 04F FH c * | j d dk( S )NAa)normcase)flavours r' _is_case_sensitiver. 9 s D !T ))r) _
/)r1 r0 \)r2 r0 )r1 r2 c & | d }|s
t S |dk( rKd}|t | k r$| | dk( r |dz
}|t | k r | | dk( r | |d }d|v rt }n-t }n&| dd }|dk( rt }nd|v r t d t } ||||| S )Nr ** ..z:Invalid pattern: '**' can only be an entire path component)_TerminatingSelectorlen _DoubleRecursiveWildcardSelector_RecursiveWildcardSelector_ParentSelector
ValueError_WildcardSelector)
pattern_partsr- case_sensitivepatchild_parts_idx child_partsclss r' _make_selectorrD Q s
C #%%
d{ M 22}_7UY]7] q O M 22}_7UY]7]#O$45 ; 2C,C#AB' $;!C
S[ YZ Z#C sK. 99r) )maxsizec |rt j nt j }t j t j
| | j S N)reNOFLAG
IGNORECASEcompilefnmatch translatematch)r@ r? flagss r' _compile_patternrQ j s5 'BIIR]]E
::g'',e 4 : ::r) c h dg}| j d D ]? }|dk( rd}n$|dk( rd}n t j | t }|j | A |j d t
j }|s|t
j z }t j d j | |
S ) aY Compile the given pattern lines to an `re.Pattern` object.
The *pattern_lines* argument is a glob-style pattern (e.g. '*/*.py') with
its path separators and newlines swapped (e.g. '*
*.py`). By using
newlines to separate path components, and not setting `re.DOTALL`, we
ensure that the `*` wildcard cannot match path separators.
The returned `re.Pattern` object may have its `match()` method called to
match a complete pattern, or `search()` to match from the right. The
argument supplied to these methods must also have its path separators and
newlines swapped.
^T)keependsz*
z.+\n*z.+z\Z )rP )
splitlinesrM rN _FNMATCH_SLICEappendrI MULTILINErK rL join)
pattern_linesr? partspartrP s r' _compile_pattern_linesr_ p s EE (($(7
5=D
S[D $$T*>:D
T
LL LLE
::bggenE 22r) c e Zd ZdZd Zd Zy) _SelectorzYA selector matches a specific glob pattern part against the children
of a given path.c v || _ |rt ||| | _ d| _ y t | _ d| _ y )NTF)rB rD successordironlyr7 )selfrB r- r? s r' __init__z_Selector.__init__ s5 & +K. QDN DL 1 3DN DLr) c t | }|j }|j s t g S | j || S )zuIterate over all child paths of `parent_path` matched by this
selector. This can contain parent_path itself.)type_scandiris_diriter _select_from)re parent_pathpath_clsscandirs r' select_fromz_Selector.select_from sA $##!!#8O g66r) N)__name__
__module__ __qualname____doc__rf rp r) r' ra ra s !7r) ra c e Zd Zd Zy)r7 c # K | y wrH ru )re rm ro s r' rl z!_TerminatingSelector._select_from s s N)rq rr rs rl ru r) r' r7 r7 s r) r7 c e Zd Zd Zd Zy)r; c 4 t j | ||| y rH ra rf )re namerB r- r? s r' rf z_ParentSelector.__init__ 4g~Fr) c # x K |j d }| j j || D ] }| y w)Nr6 )_make_child_relpathrc rl )re rm ro pathps r' rl z _ParentSelector._select_from s; ..t4 ,,T7; AG s 8:Nrq rr rs rf rl ru r) r' r; r; s
Gr) r; c e Zd Zd Zd Zy)r= c p t j | ||| | t | }t || | _ y rH )ra rf r. rQ rO re r@ rB r- r? s r' rf z_WildcardSelector.__init__ s4 4g~F ! / 8N%c>:
r) c # K || 5 }t | }d d d D ]u }| j r |j s! |j }| j | s@|j
| }| j j || D ] }| w y # 1 sw Y xY w# t $ r Y w xY w# t $ r Y y w xY wwrH ) listrd rj OSErrorr{ rO r~ rc rl ) re rm ro
scandir_itentriesentryr{ r r s r' rl z _WildcardSelector._select_from s %
+ z*
+
!
<<! $||~ $ . zz::d#&::4@D !^^ 8 8w G
+
+ # ! ! sf CB6 BB6 CB' C"9CB$ B6 ' B30C2B33C6 C?CCCNr ru r) r' r= r= s ; r) r= c e Zd Zd Zd Zd Zy)r: c 4 t j | ||| y rH rz r s r' rf z#_RecursiveWildcardSelector.__init__ r| r) c # z K | |j D ] \ }}}|D ] }|j | " y wrH )walkr~ )re rm dirpathdirnamesr/ dirnames r' _iterate_directoriesz/_RecursiveWildcardSelector._iterate_directories sK $/$4$4$6 ; GXq#
; 11'::
; ;s 9;c # K | j j }| j | D ] } ||| D ] }| y wrH )rc rl r )re rm ro successor_selectstarting_pointr s r' rl z'_RecursiveWildcardSelector._select_from sK >>66 " 7 7 D N%ng>
s A AN)rq rr rs rf r rl ru r) r' r: r: s G; r) r: c " e Zd ZdZ fdZ xZS )r9 z
Like _RecursiveWildcardSelector, but also de-duplicates results from
successive selectors. This is necessary if the pattern contains
multiple non-adjacent '**' segments.
c # K t } t | || D ] }||vs| |j | |j y # |j w xY wwrH )setsuperrl addclear)re rm ro yieldedr __class__s r' rl z-_DoubleRecursiveWildcardSelector._select_from sZ % W)+w?
#G#GKKN
#
MMOGMMOs A%A A A%A""A%)rq rr rs rt rl
__classcell__r s @r' r9 r9 s r) r9 c , e Zd ZdZdZd Zd Zd Zd Zy) _PathParentszvThis object provides sequence-like access to the logical ancestors
of a path. Don't try to construct it yourself.)_path_drv_root_tailc x || _ |j | _ |j | _ |j
| _ y rH )r driver rootr r re r s r' rf z_PathParents.__init__ s*
JJ YY
ZZ
r) c , t | j S rH )r8 r re s r' __len__z_PathParents.__len__ s 4:: r) c
t |t r2t fdt |j t D S |t k\ s|t k r t
| |dk r|t z
} j j j j j d | dz
S )Nc 3 ( K | ] }| y wrH ru ).0ire s r' <genexpr>z+_PathParents.__getitem__.<locals>.<genexpr> s IQaIs r r5 )
isinstanceslicetuplerangeindicesr8
IndexErrorr _from_parsed_partsr r r )re idxs ` r' __getitem__z_PathParents.__getitem__ s c5 !I%SY1G*HII I #d) sc$iZ / S/ ! 7 3t9 Czz,,TYY
-1ZZ #-BD Dr) c ^ dj t | j j S )Nz <{}.parents>)formatrh r rq r s r' __repr__z_PathParents.__repr__ s" $$T$**%5%>%>??r) N) rq rr rs rt __slots__rf r r r ru r) r' r r s" 73I D@r) r c e Zd ZdZdZej Zd Zd Z d Z
d Z e d Z
d Zd Ze d
Zd Zd Zd
Zd Zd Zd Zed Zed Zed Zd Zd Z d Z d Z d Z d Z ed Z!ed Z"ed Z#ed Z$ed Z%ed Z&ed Z'ed! Z(d" Z)d# Z*d$ Z+d%d&d'Z,d( Z-ed) Z.d* Z/d+ Z0d, Z1ed- Z2ed. Z3d/ Z4d0 Z5d1d2d3Z6y1)4r a| Base class for manipulating paths without I/O.
PurePath represents a filesystem path and offers operations which
don't imply any actual filesystem I/O. Depending on your system,
instantiating a PurePath will return either a PurePosixPath or a
PureWindowsPath object. You can also instantiate either of these classes
directly, regardless of your system.
)
_raw_pathsr r _tail_cached_str_str_normcase_cached_parts_normcase_cached
_lines_cached_hashc z | t u r t j dk( rt nt } t
j
| S )zConstruct a PurePath from one or several strings and or existing
PurePath objects. The strings and path objects are combined so as
to yield a canonicalized path, which is incorporated into the
new PurePath object.
nt)r osr{ r r object__new__rC argskwargss r' r zPurePath.__new__W s+ (?%'WW_/-C~~c""r) c 2 | j | j fS rH )r r] r s r'
__reduce__zPurePath.__reduce__a s
++r) c g }|D ] }t |t rc|j t u r5| j t u r#|j d |j D Z|j |j v t j | }t |t s!t dt | j |j | || _ y # t $ r |}Y Yw xY w)Nc 3 @ K | ] }|j d d yw)r2 r1 N)replace)r r s r' r z$PurePath.__init__.<locals>.<genexpr>l s TT dC!8 Ts zVargument should be a str or an os.PathLike object where __fspath__ returns a str, not )r r _flavourntpath posixpathextendr r fspath TypeErrorstrrh rq rY )re r pathsargr s r' rf zPurePath.__init__f s #C#x(<<6)dmmy.HLL TS^^ TTLL 0 99S>D "$,# #Dz 2 2 578 8 T"# #$ ! D s <C C+*C+c t | | S )zConstruct a new path object from any number of path-like objects.
Subclasses may override this method to customize how new path objects
are created from methods like `iterdir()`.
)rh re pathsegmentss r'
with_segmentszPurePath.with_segments| s
tDz<((r) c " |sddg fS | j j }| j j }|r|j || }| j j | \ }}}|s[|j | rJ|j
| s9|j | }t | dk( r
|d dvr|}nt | dk( r|}|j | D cg c]) }|s|dk7 s t j t | + } }||| fS c c}w )NrV z?. .) r sepaltsepr splitroot
startswithendswithsplitr8 sysinternr )
rC r r r drvr rel drv_partsxparseds
r' _parse_pathzPurePath._parse_path s r2: ll $$ <<,D //5T3s+CLL4E #I9~"y|4'?Y 1$.1iinOa3h#**SV$OOD& Ps D D % D c | j }t | dk( rd}n-t | dk( r|d }n | j j | }| j | \ }}}|| _ || _ || _ y )Nr rV r5 )r r8 r r[ r r r r )re r r r r tails r' _load_partszPurePath._load_parts sq u:?D
Z1_8D%4==%%u-D **40T4
r) c | j ||| }| j | }|xs d|_ ||_ ||_ ||_ |S Nr )_format_parsed_partsr r r r r )re r r r path_strr s r' r zPurePath._from_parsed_parts sL ,,S$=!!(+ O
r) c |s|r+||z | j j j | z S |r'| j j |d d rdg|z }| j j j | S )Nr r )r r r[
splitdrive)rC r r r s r' r z PurePath._format_parsed_parts sn $: 0 0 5 5d ;; ;
cll--d1g6q954<D|| $$T**r) c | j S # t $ rI | j | j | j | j
xs d| _ | j cY S w xY w)z[Return the string representation of the path, suitable for
passing to system calls.r )r AttributeErrorr r r r r s r' __str__zPurePath.__str__ s[ 99 11$**dii26**> EAD
I99 s AA A c t | S rH )r r s r'
__fspath__zPurePath.__fspath__ s 4yr) c d | j }t | j |j d S )zNReturn the string representation of the path with forward (/)
slashes.r1 )r r r r re fs r' as_posixzPurePath.as_posix s(
MM4y ,,r) c , t j | S )zaReturn the bytes representation of the path. This is only
recommended to use under Unix.)r fsencoder s r' __bytes__zPurePath.__bytes__ s {{4 r) c j dj | j j | j S )Nz{}({!r}))r r rq r r s r' r zPurePath.__repr__ s% !8!8$--/JJr) c 4 | j s t d | j }t | dk( r!|d dk( rd|z }| j dd }n"|rd}| j }n
d}t | }|t
t j | z S ) z Return the path as a 'file' URI.z.relative path can't be expressed as a file URIr r5 :zfile:///Nzfile:zfile://) is_absoluter< r r8 r r urlquote_from_bytesr r )re r prefixr s r' as_urizPurePath.as_uri s ! MN N
u:?uQx3 %'F==?12&D
F==?D Ft9D+BKK,=>>>r) c | j S # t $ rS t | j rt | | _ n t | j | _ | j cY S w xY wrH )r r r. r r lowerr s r'
_str_normcasezPurePath._str_normcase sY -,, , -!$--0,/I),/IOO,=),, , -s AA*)A*c | j S # t $ rC | j j | j j
| _ | j cY S w xY wrH )r r r r r r r s r' _parts_normcasezPurePath._parts_normcase sQ /.. . /*.*<*<*B*B4==CTCT*UD '.. . /s A AAc | j S # t $ rZ t | }|dk( rd| _ n3t | j j
}|j
| | _ | j cY S w xY w)Nr rV )r r r _SWAP_SEP_AND_NEWLINEr r rN )re r transs r' _lineszPurePath._lines sm &%% % &4yH3%'"-dmm.?.?@%-%7%7%>"%% % &s A A10A1c t |t st S | j |j k( xr | j |j u S rH )r r NotImplementedr r re others r' __eq__zPurePath.__eq__ s; %*! !!!U%8%88\T]]enn=\\r) c | j S # t $ r) t | j | _ | j cY S w xY wrH )r r hashr r s r' __hash__zPurePath.__hash__ s< :: d 0 01DJ:: s /A A c t |t r| j |j urt S | j |j k S rH r r r r r r s r' __lt__zPurePath.__lt__ 8 %*dmm5>>.Q! !##e&;&;;;r) c t |t r| j |j urt S | j |j k S rH r" r s r' __le__zPurePath.__le__ 8 %*dmm5>>.Q! !##u'<'<<<r) c t |t r| j |j urt S | j |j kD S rH r" r s r' __gt__zPurePath.__gt__ r$ r) c t |t r| j |j urt S | j |j k\ S rH r" r s r' __ge__zPurePath.__ge__" r' r) c r | j S # t $ r | j | j cY S w xY w)z.The drive prefix (letter or UNC path), if any.)r r r r s r' r zPurePath.drive' s6 99 99 %66c r | j S # t $ r | j | j cY S w xY w)z The root of the path, if any.)r r r r s r' r z
PurePath.root0 s6 :: :: r- c r | j S # t $ r | j | j cY S w xY wrH )r r r r s r' r zPurePath._tail9 s: %$$ $ % $$ $ %r- c 8 | j | j z }|S )z/The concatenation of the drive and root, or ''.)r r )re anchors r' r1 zPurePath.anchorA s dii'
r) c * | j }|sy|d S )z!The final path component, if any.rV )r )re r s r' r{ z
PurePath.nameG s zzBxr) c | | j }|j d }d|cxk rt | dz
k rn y||d S y)z{
The final component's last suffix, if any.
This includes the leading period. For example: '.txt'
r r r5 NrV r{ rfindr8 re r{ r s r' suffixzPurePath.suffixO sD yy JJsO q 3t9q= 8Or) c | j }|j d rg S |j d }|j d dd D cg c] }d|z c}S c c}w )z
A list of the final component's suffixes, if any.
These include the leading periods. For example: ['.tar', '.gz']
r r5 N)r{ r lstripr )re r{ r8 s r' suffixeszPurePath.suffixes] sS yy == I{{3 +/::c?12+>?f ???s Ac | j }|j d }d|cxk rt | dz
k r n |S |d| S |S )z0The final path component, minus its last suffix.r r r5 Nr5 r7 s r' stemz
PurePath.stemj sH yy JJsO q 3t9q= K 8OKr) c ` | j st | d | j }|j | \ }}}|s,|s*|r(|j |v s|j
r |j
|v rt d|z | j
| j | j | j dd |gz S )z-Return a new path with the file name changed. has an empty namezInvalid name %rNr3 )
r{ r< r r r r r r r r )re r{ r r r r s r' with_namezPurePath.with_namet s yy t => > MM++d+T4 $daeetmQXXQUEU .$ 78 8&&tzz499'+zz#2$'?A Ar) c > | j || j z S )z(Return a new path with the stem changed.)r@ r8 )re r= s r' with_stemzPurePath.with_stem s ~~dT[[ 011r) c | j }|j |v s|j r |j |v rt d| |r|j d r|dk( rt d|z | j
}|st | d | j }|s||z }n|dt | |z }| j | j | j | j dd |gz S )zReturn a new path with the file suffix changed. If the path
has no suffix, add given suffix. If the given suffix is an empty
string, remove the suffix from the path.
zInvalid suffix r zInvalid suffix %rr? Nr3 ) r r r r< r r{ r8 r8 r r r r )re r8 r r{
old_suffixs r' with_suffixzPurePath.with_suffix s
MM 55F?ahh188v+= F <= = &++C0FcM 0F ;< <yy t => >[[
&=D)#j/)*V3D&&tzz499'+zz#2$'?A Ar) F)walk_upc & |rd}t j d|d | j |g| }t |gt |j
z D ]c \ }}| j
| r np|s"t t | dt | |j dk( sMt dt | d t t | d t | d
dg|z | j t |j d z } | j | S ) a* Return the relative path to another path identified by the passed
arguments. If the operation is not possible (because this is not
related to the other path), raise ValueError.
The *walk_up* parameter controls whether `..` may be used to resolve
the path.
zsupport for supplying more than one positional argument to pathlib.PurePath.relative_to() is deprecated and scheduled for removal in Python {remove}z#pathlib.PurePath.relative_to(*args) removez is not in the subpath of r6 z'..' segment in z cannot be walkedz and z have different anchorsN) warnings _deprecatedr enumerater parentsis_relative_tor< r r{ r r8 )re r rF rN msgstepr r] s r' relative_tozPurePath.relative_to s >C
!F(/
1"""57;7#UGd5==.A$AB YJD$""4( CI=0J3u:.!YZZd" #3CJ>AR!STT
Y D }E#e* ?V WX X
3tzz?+; <<!t!!5))r) c |rd}t j d|d | j |g| }|| k( xs || j v S )zFReturn True if the path is relative to another path or False.
zsupport for supplying more than one argument to pathlib.PurePath.is_relative_to() is deprecated and scheduled for removal in Python {remove}z&pathlib.PurePath.is_relative_to(*args)rH rK )rM rN r rP )re r rN rR s r' rQ zPurePath.is_relative_to sU >C
!I!$W
6"""57;7}5 55r) c | j s | j r0| j | j z ft | j z S t | j S )zZAn object providing sequence-like access to the
components in the filesystem path.)r r r r r s r' r] zPurePath.parts sD ::JJ*,uTZZ/@@ @$ $r) c ( | j | g| S )zCombine this path with one or several arguments, and return a
new path representing either a subpath (if all arguments are relative
paths) or a totally different path (if one of the arguments is
anchored).
)r r s r' joinpathzPurePath.joinpath s "t!!$6 66r) c P | j | S # t $ r t cY S w xY wrH )rX r r re keys r' __truediv__zPurePath.__truediv__ s+ "==% % "! ! "s %%c R | j || S # t $ r t cY S w xY wrH )r r r rZ s r' __rtruediv__zPurePath.__rtruediv__ s/ "%%c40 0 "! ! "s &&c ~ | j }| j }| j }|s| S | j |||dd S )z The logical parent of the path.Nr3 )r r r r )re r r r s r' parentzPurePath.parent sB jjyyzzK&&sD$s)<<r) c t | S )z*A sequence of this path's logical parents.)r r s r' rP zPurePath.parents s
D!!r) c " | j t u r#t | j xr | j S | j t
u r%| j D ] }|j d s y y| j j t | S )zSTrue if the path is absolute (has both a root and, if applicable,
a drive).r1 TF)
r r boolr r r r r isabsr r s r' r zPurePath.is_absolute st ==F "
0tyy1 1
]]i
'
??3'
==&&s4y1 1r) c ( | j t u s | j sy| j j d ry| j d j d d j d d j
d }|j t v S )zaReturn True if the path contains one of the special names reserved
by the system, if any.Fz\\r3 r r r ) r r r r r partitionrstripupper_WIN_RESERVED_NAMESre r{ s r' is_reservedzPurePath.is_reserved sz ==I %TZZ :: (zz"~'',Q/99#>qAHHMzz| 222r) Nr? c p t |t s| j | }|t | j }t |j | }|j s |j r |j | j duS |j r |j | j duS t d )zE
Return True if this path matches the given pattern.
Nz
empty pattern)
r r r r. r r_ r r r rO r searchr< )re path_patternr? patterns r' rO zPurePath.match s ,1 --l;L ! /
>N( )<)<nM !2!2==-T9 9
>>$++.d: : _- -r) )7rq rr rs rt r r r r r r rf r classmethodr r r r r r r r r r propertyr r r r r r# r& r) r+ r r r r1 r{ r8 r; r= r@ rB rE rT rQ r] rX r\ r^ r` rP r rl rO ru r) r' r r $ s &IN wwH#,
,) ! !& ! + + - !
K?( - - / / & &]
<
=
<
=
% %
@
@ A2A* ;@ *6
6 % %7" " = = " "
2 3 59 .r) r c e Zd ZdZeZdZy)r zPurePath subclass for non-Windows systems.
On a POSIX system, instantiating a PurePath should return this object.
However, you can also instantiate it directly on any system.
ru N)rq rr rs rt r r r ru r) r' r r " s
HIr) r c e Zd ZdZeZdZy)r zPurePath subclass for Windows systems.
On a Windows system, instantiating a PurePath should return this object.
However, you can also instantiate it directly on any system.
ru N)rq rr rs rt r r r ru r) r' r r , s
HIr) r c | e Zd ZdZdZdddZd ZdddZd Zd Z d
Z
d Z d Z d
Z
d Zd Zd Zd Z d5dZd Zd6dZd Zd7dZd Zd Zd Zddd Zddd Zd8d Z fd Z d Z d! Z d" Z e!d# Z"e!d$ Z#d% Z$d9d&Z%d' Z&d( Z'd) Z(d:d*Z)d;d+Z*ddd,Z+d- Z,d9d.Z-d/ Z.d0 Z/d1 Z0d9d2Z1d3 Z2d4 Z3 xZ4S )<r a PurePath subclass that can make system calls.
Path represents a filesystem path but unlike PurePath, also offers
methods to do system calls on path objects. Depending on your system,
instantiating a Path will return either a PosixPath or a WindowsPath
object. You can also instantiate a PosixPath or WindowsPath directly,
but cannot instantiate a WindowsPath on a POSIX system or vice versa.
ru Tfollow_symlinksc 0 t j | | S )zh
Return the result of the stat() system call on this path, like
os.stat() does.
rw )r stat)re rx s r' rz z Path.statD s
wwt_==r) c & | j d S )z
Like stat(), except if the path points to a symlink, the symlink's
status information is returned, rather than its target's.
Frw )rz r s r' lstatz
Path.lstatK s
yyy//r) c | j | y# t $ r}t | s Y d}~yd}~wt $ r Y yw xY w)z
Whether this path exists.
This method normally follows symlinks; to check whether a symlink exists,
add the argument follow_symlinks=False.
rw NFT)rz r r( r< )re rx es r' existsz Path.existsU sE IIoI 6 # s > / >>c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z3
Whether this path is a directory.
NF)r rz st_moder r( r< re r~ s r' rj z Path.is_dirg I
499;../ / # "% A ? A
Ac t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)zq
Whether this path is a regular file (also True for symlinks pointing
to regular files).
NF)r
rz r r r( r< r s r' is_filez Path.is_filew sI
499;../ / # r c 8 | j j | S )z5
Check if this path is a mount point
)r ismountr s r' is_mountz
Path.is_mount s }}$$T**r) c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z7
Whether this path is a symbolic link.
NF)r r| r r r( r< r s r'
is_symlinkzPath.is_symlink sG 4::<//0 0 # r c 8 | j j | S )z2
Whether this path is a junction.
)r
isjunctionr s r' is_junctionzPath.is_junction s }}''--r) c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z6
Whether this path is a block device.
NF)r rz r r r( r< r s r' is_block_devicezPath.is_block_device r r c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z:
Whether this path is a character device.
NF)r
rz r r r( r< r s r' is_char_devicezPath.is_char_device r r c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z.
Whether this path is a FIFO.
NF)r rz r r r( r< r s r' is_fifoz Path.is_fifo I
DIIK / /0 0 # r c t | j j S # t $ r}t | s Y d}~yd}~wt
$ r Y yw xY w)z0
Whether this path is a socket.
NF)r rz r r r( r< r s r' is_socketzPath.is_socket r r c | j } |j }| j j || S # t $ r" | j | j }Y Fw xY w)zoReturn whether other_path is the same or not as this file
(as returned by os.path.samefile()).
)rz r r r samestat)re
other_pathstother_sts r' samefilez
Path.samefile sc YY[ =!(H }}%%b(33 =))*5::<H =s > (A)(A)Nc h d|vrt j | }t j | ||||| S )z|
Open the file pointed by this path and return a file object, as
the built-in open() function does.
b)io
text_encodingopen)re mode bufferingencodingerrorsnewlines r' r z Path.open s4 d?''1HwwtT9hHHr) c r | j d 5 }|j cddd S # 1 sw Y yxY w)zK
Open the file in bytes mode, read it, and close the file.
rbr N)r readr s r'
read_byteszPath.read_bytes s2 YYDY
! Q668 s -6c t j | }| j d|| 5 }|j cddd S # 1 sw Y yxY w)zJ
Open the file in text mode, read it, and close the file.
r)r r r N)r r r r )re r r r s r' read_textzPath.read_text sF ##H-
YYC(6Y
B a668 s AA
c t | }| j d 5 }|j | cddd S # 1 sw Y yxY w)zO
Open the file in bytes mode, write to it, and close the file.
wbr N)
memoryviewr write)re dataviewr s r' write_byteszPath.write_bytes s>
$
YYDY
! !Q774= ! ! !s 9Ac t |t s"t d|j j z t j | }| j d||| 5 }|j | cddd S # 1 sw Y yxY w)zN
Open the file in text mode, write to it, and close the file.
zdata must be str, not %sw)r r r r N) r r r r rq r r r r )re r r r r r s r'
write_textzPath.write_text sw $$ 6 NN 3 3 4 5
5##H-
YYC(67Y
S !WX774= ! ! !s A88Bc # f K t j | D ] }| j | yw)zYield path objects of the directory contents.
The children are yielded in arbitrary order, and the
special entries '.' and '..' are not included.
N)r listdirr~ rk s r' iterdirz Path.iterdir s1 JJt$ 1D**40 0 1s /1c , t j | S rH )r ro r s r' ri z
Path._scandir$ s zz$ r) c t | }| j }|r | | j j | }n|dk7 r| | }n|}| j | }||_ | j |_ | j |_ ||gz |_
|S r ) r r r r r r r r r r r )re r{ r r r s r' r~ zPath._make_child_relpath* s t9zz "DMM$5$5#6tf=H
_"D6*HH!!(+ JJ YY
D6M r) rm c # K t j d| | |st dj | | j | \ }}}|s|r t d |d | j j | j j fv r|j d t t | | j | }|j | D ] }| yw)zIterate over this subtree and yield all existing files (of any
kind, including directories) matching the given relative pattern.
zpathlib.Path.globzUnacceptable pattern: {!r}%Non-relative patterns are unsupportedr3 rV N)
r auditr< r r NotImplementedErrorr r r rY rD r rp re rq r? r r r> selectorr s r' globz Path.glob: s %tW5 9 @ @ IJ J#'#3#3G#< T= $%&MN N 2;4==,,dmm.B.BC C $!%
"6
~V%%d+ AG s CCc # K t j d| | | j | \ }}}|s|r t d |rB|d | j j
| j j fv r|j d t dt | z | j | }|j | D ] }| yw)zRecursively yield all existing files (of any kind, including
directories) matching the given relative pattern, anywhere in
this subtree.
zpathlib.Path.rglobr r3 rV )r4 N) r r r r r r r rY rD r rp r s r' rglobz
Path.rglobJ s
&g6#'#3#3G#< T= $%&MN N wr{t}}'8'8$--:N:N&OO $!'E-,@"@$--Q_`%%d+ AG s B>C c # K t j d| || | g}|r|j }t |t r| ' |j }|5 g }g } |D ]N }
|
j | } | r |j |
j 4| j |
j P ddd |r| f n|j | f |t | D cg c] } |j | c} z
}|ryy# t $ r}| || Y d}~d}~ww xY w# t $ r d} Y w xY w# 1 sw Y xY wc c} w w)zBWalk the directory tree from this directory, similar to os.walk().zpathlib.Path.walkNrw F) r r popr r ri r rj rY r{ reversedr~ )
re top_downon_errorrx r r r errorr filenamesr rj ds
r' r z Path.walkY sK %tXG99;D$&
!]]_
5 '
5E'!& o !N
3!((4
5
5 Hi// dHi 89 8H;MNad..q1N NEM
' UO
# '!&'
5
5( Os~ AE
D E
D9#D(5;D914E
%E=E
E
D%
D E
D%%E
( D63D95D66D99E> E
c V |rd}t j d|d t | | y )Nzvsupport for supplying keyword arguments to pathlib.PurePath is deprecated and scheduled for removal in Python {remove}zpathlib.PurePath(**kwargs)rH rK )rM rN r rf )re r r rR r s r' rf z
Path.__init__ s. PC !=s7 S
$ r) c z | t u r t j dk( rt nt } t
j
| S )Nr )r r r{ r r r r r s r' r z Path.__new__ s) $;!#D +iC~~c""r) c > t j dt d | S )Nz}pathlib.Path.__enter__() is deprecated and scheduled for removal in Python 3.13; Path objects as a context manager is a no-opr )
stacklevel)rM warnDeprecationWarningr s r' __enter__zPath.__enter__ s#
+ )Q 8 r) c y rH ru )re tvtbs r' __exit__z
Path.__exit__ s r) c , | j S )z<Return a new path pointing to the current working directory.)absoluterC s r' cwdzPath.cwd s u~~ r) c . | d j S )zrReturn a new path pointing to the user's home directory (as
returned by os.path.expanduser('~')).
~)
expanduserr s r' homez Path.home s
3x""$$r) c : | j r| S | j r&| j j | j }nFt j
}| j s&| j s| j | }||_ |S | j || S )zReturn an absolute version of this path by prepending the current
working directory. No normalization or symlink resolution is performed.
Use resolve() to get the canonical path to a file.
)
r r r abspathr getcwdr r r r )re r results r' r z
Path.absolute s} K
ZZ--''
3C))+C 99TZZ ++C0 !
!!#t,,r) c d } | j j | | }| j | }|s |j |S |S # t $ r} || d}~ww xY w# t $ r} || Y d}~|S d}~ww xY w)zl
Make the path absolute, resolving all symlinks on the way and also
normalizing it.
c t | dd }| j t k( s |t k( rt d| j
z y )Nr" r zSymlink loop from %r)r# r! r _WINERROR_CANT_RESOLVE_FILENAME RuntimeErrorfilename)r~ r" s r' check_eloopz!Path.resolve.<locals>.check_eloop s? q*a0Hww% 8/N#N"#9AJJ#FGG $Or) )strictN)r realpathr r rz )re r r sr~ r s r' resolvez Path.resolve s H
&&tF&;A
q !
q N
A
s. A
A$
A! A A!$ B -A;;B c ddl }|j | j j j S # t
$ r t
d w xY w)z:
Return the login name of the file owner.
r Nz*Path.owner() is unsupported on this system)pwdgetpwuidrz st_uidpw_name ImportErrorr )re r s r' ownerz
Path.owner sI T << 2 23;; ; T%&RS S T 69 Ac ddl }|j | j j j S # t
$ r t
d w xY w)z8
Return the group name of the file gid.
r Nz*Path.group() is unsupported on this system)grpgetgrgidrz st_gidgr_namer r )re r s r' groupz
Path.group sI
T << 2 23;; ; T%&RS S Tr c t t d s t d | j t j | S )zD
Return the path to which the symbolic link points.
readlinkz*os.readlink() not available on this system)hasattrr r r r r s r' r z
Path.readlink s4 r:&%&RS S!!"++d"344r) c |r t j | d yt j t j z }|s|t j
z }t j | || }t j | y# t $ r Y nw xY w)zS
Create this file with the given access mode, if it doesn't exist.
N)r utimer O_CREATO_WRONLYO_EXCLr close)re r exist_okrP fds r' touchz
Path.touch ss
t$
R[[( RYY E
WWT5$
'
s A> > B
B
c t j | | y# t $ rF |r| j | k( r | j j dd | j |d| Y yt $ r |r| j s Y yw xY w)z<
Create a new directory at this given path.
T)rP r FN)r mkdirFileNotFoundErrorr` r rj )re r rP r s r' r
z
Path.mkdir s{ HHT4 ?dkkT 1 KK dT : JJtUXJ > 4;;= $1 s A B'BBc 4 t j | || y)zF
Change the permissions of the path, like os.chmod().
rw N)r chmod)re r rx s r' r z
Path.chmod, s t_=r) c * | j |d y)z
Like chmod(), except if the path points to a symlink, the symlink's
permissions are changed, rather than its target's.
Frw N)r )re r s r' lchmodz Path.lchmod2 s
4
/r) c T t j | y# t $ r |s Y yw xY w)zd
Remove this file or link.
If the path is a directory, use rmdir() instead.
N)r unlinkr )re
missing_oks r' r z Path.unlink9 s,
IIdO s ''c . t j | y)zF
Remove this directory. The directory must be empty.
N)r rmdirr s r' r z
Path.rmdirD s r) c P t j | | | j | S )a2
Rename this path to the target path.
The target path may be absolute or relative. Relative paths are
interpreted relative to the current working directory, *not* the
directory of the Path object.
Returns the new Path instance pointing to the target path.
)r renamer re targets r' r z Path.renameJ s# $ !!&))r) c P t j | | | j | S )aS
Rename this path to the target path, overwriting if that path exists.
The target path may be absolute or relative. Relative paths are
interpreted relative to the current working directory, *not* the
directory of the Path object.
Returns the new Path instance pointing to the target path.
)r r r r s r' r z Path.replaceW s#
4 !!&))r) c h t t d s t d t j || | y)z
Make this path a symlink pointing to the target path.
Note the order of arguments (link, target) is the reverse of os.symlink.
symlinkz)os.symlink() not available on this systemN)r r r r )re r target_is_directorys r'
symlink_tozPath.symlink_tod s+
r9%%&QR R
64!45r) c f t t d s t d t j || y)z
Make this path a hard link pointing to the same file as *target*.
Note the order of arguments (self, target) is the reverse of os.link's.
linkz&os.link() not available on this systemN)r r r r" r s r' hardlink_tozPath.hardlink_tom s( r6"%&NO O
r) c ^ | j s| j s| j r| j d dd dk( rs| j j | j d }|dd dk( r t d | j
| \ }}}| j |||| j dd z S | S )zl Return a new path with expanded ~ and ~user constructs
(as returned by os.path.expanduser)
r Nr5 r z#Could not determine home directory.)r r r r r r r r )re homedirr r r s r' r zPath.expanduserw s tyy JJ4::a=!,3mm..tzz!}=Gr{c!"#HII " . .w 7OCt**3dTZZ^6KL L r) )r r3 NNN)NN)NNN)TNF)F)i T)i FF)5rq rr rs rt r rz r| r rj r r r r r r r r r r r r r r r ri r~ r r r rf r r r rr r r r r r r r r r
r r r r r r r r# r r r s @r' r r 9 s7 I&* >0 )- $ "+
. 4 59"&I ! !1 /3 04
+OZ #
% % -06T T5," .2 > 0 * *6 r) r c : e Zd ZdZdZej dk( rd Zyy)r zsPath subclass for non-Windows systems.
On a POSIX system, instantiating a Path should return this object.
ru r c 4 t d| j d Nzcannot instantiate z on your systemr rq r s r' r zPosixPath.__new__ " %%cll%5_EG
Gr) Nrq rr rs rt r r r{ r ru r) r' r r $ I ww$ G r) r c : e Zd ZdZdZej dk7 rd Zyy)r zqPath subclass for Windows systems.
On a Windows system, instantiating a Path should return this object.
ru r c 4 t d| j d r( r) r s r' r zWindowsPath.__new__ r* r) Nr+ ru r) r' r r r, r) r )Ert rM functoolsr r r r rI r rM _collections_abcr r! r r r r rz r r r
r r r
r urllib.parser r
__all__ frozensetrj _WINERROR_NOT_READY_WINERROR_INVALID_NAMEr r$ r% r( cacher. rN r _FNMATCH_PREFIX_FNMATCH_SUFFIXr r8 rX r maketransr lru_cacherD rQ r_ ra r7 r; r= r: r9 r r r PathLikeregisterr r r r r )cs 0r' <module>r> sh
% / / P P P @ 5/01s1#Y01/01s1#Y01 "& 7E51 #%
H
* * $57#4#4S#9#?#?#D s?+c/.B-BC T- .
--t40
1 : :0 S!; ";
#3 #3L7 7. i @ $ 'A ,@8 @:v.v v.v X H h J 8 J Z
Gm
G
G$
G]+ 10s H
2 H
Browse
Usage
Versions