h+(%SSKrSSKJr SSKrSSKJr SSKJrJrJ r J r J r SSK r SSK JrJrJrJr SSKrSSKrSSKJr SSKJrJrJrJrJrJrJrJrJrJ r J!r!J"r"J#r#J$r$J%r%J&r&J'r'J(r( SSK)J*r* SS K+J,r, \%(aSS K-J.r.J/r/J0r0J1r1J2r2 \RfS :aSS KJ4r4 OSS K5J4r4 \RfS :aSSKJ6r6 OSSK5J6r6 \RfS:aSSK J7r7 SSK J8r9 SSK J:r: S2Sjr8Oj\RfSSS:XaSSK J:r: SSK J;r7 SSK J8r8 OD\RfSSS:XaSSKJ?r? SSK@JArA SSKBJCrCJDrDJErEJFrFJGrGJHrHJIrIJJrJJKrKJLrLJMrMJNrNJOrOJPrPJQrQ \%(aSSKRJSrS SSKTJUrU "SS5rV\"\V5rW\\X\V4\YS '\&"S!5rZ\&"S"S#S$9r[S%\XS&\\$\[/\$\[44S'jr\"S(S)\R5r^"S*S#\^S+9r_S,\S&\X4S-jr`"S.S/5ra"S0S15rbg)3N defaultdict)contextmanager)BufferedRandomBufferedReaderBufferedWriterFileIO TextIOWrapper)Path PosixPath PurePosixPath WindowsPath) MethodType)BinaryIOLiteraloverloadAnyCallable ContainerIterableIODict GeneratorListOptionalTupleType TYPE_CHECKINGTypeVarUnioncast)urlparse)warn)OpenBinaryModeOpenBinaryModeReadingOpenBinaryModeUpdatingOpenBinaryModeWriting OpenTextMode) ) TypeGuard)r) )Selfr) )_posix_flavour)_make_selector) _PathParentsc,[[U5U5$N)_make_selector_pathlibtuple) pattern_parts_flavourcase_sensitives P/home/james-whalen/.local/lib/python3.13/site-packages/cloudpathlib/cloudpath.pyr1r1As%eM&:HEE) posixpathr) )r)) FileCacheMode)anypath)ClientMismatchErrorCloudPathFileExistsErrorCloudPathFileNotFoundErrorCloudPathIsADirectoryErrorCloudPathNotADirectoryErrorCloudPathNotExistsErrorCloudPathNotImplementedErrorDirectoryNotEmptyErrorIncompleteImplementationErrorInvalidPrefixErrorMissingDependenciesError NoStatErrorOverwriteDirtyFileErrorOverwriteNewerCloudErrorOverwriteNewerLocalError)Client CloudPathInfoc\rSrSr%\\S'Sr\\S'\S\S'\S\S'SS jr \ S \S4S j5r \ S \S4S j5r Sr g )CloudImplementationonameTdependencies_loadedrS _client_class CloudPath _path_classreturnNc SS/nUVs/sHn[USU35bMUPM nnU(a[SU35eUR(d0[SURR SUR S35egs snf)N client_class path_class_z1Implementation is missing registered components: zMissing dependencies for z6. You can install them with 'pip install cloudpathlib[z]'.)getattrrLrZrNr[__name__rY)selfexpectedclsmissings r:validate_completeness)CloudImplementation.validate_completenessus"L1"*O(3gdauI.F3(O /CG9M ''*+D,>,>,G,G+HI226))CA ( Ps BBc:UR5 UR$r4)rir[res r:r` CloudImplementation.client_classs ""$!!!r;c:UR5 UR$r4)rir]rls r:raCloudImplementation.path_classs ""$r;r^N)rd __module__ __qualname____firstlineno__str__annotations__rZboolrripropertyr`ra__static_attributes__rpr;r:rWrWosk I $$>!k"" "d8n"" D-  r;rWimplementation_registryT CloudPathTr\)boundkeyr^cL^S[[S[[4U4SjjnU$)Nrgr^c>[U[5(d [S5eU[Tl[TUlU$)Nz/Only subclasses of CloudPath can be registered.) issubclassr\ TypeErrorrzr] _cloud_meta)rgr~s r: decorator®ister_path_class..decorators;#y))MN N36$01#6 r;)rr|)r~rs` r:register_path_classrs(tJ'D,< r;c \rSrSr\S\\S\S\S\S\4 Sj5r \S\\S\ \ S4S\S\S\4 S j5r S\\S\ \ \4S\S\S\ \S\44 S jr S \ S \ \ S 4S\\ \4SS4SjrSrg) CloudPathMetarg cloud_pathargskwargsr^cgr4rprgrrrs r:__call__CloudPathMeta.__call__sr;r\cgr4rprs r:rrs r;cn[U[5(d[S[RS35eU[La[R 5HXnUR nUcMURUSS9(dM+[RU5nUR"Xa/UQ70UD6 Us $ [R 5Vs/sH(nUR cMUR RPM* nn[SUSUS35e[RU5nUR"Xa/UQ70UD6 U$s snf)NzOnly subclasses of z) can be instantiated from its meta class.Fraise_on_errorPath z$ does not begin with a known prefix .) rr\rrdrzvaluesr]is_valid_cloudpathobject__new____init__ cloud_prefixrM) rgrrrimplementationranew_objimplvalid_prefixess r:rrsA#y))%i&8&8%99bc  ) "9"@"@"B+77 )j.K.Ku/L//%nnZ8G''MdMfM"N#C4::<jjr9S \6\ SS44S?jr:\;SS@j5r<SSA\SB\ \=SC\S \6\>\ \?\\?\4SS44SDjjr@\SS'SESF\SG\ \SH\ \SI\ \SJ\ \SK\ \S SL4SMjj5rA\SS'SNSF\BSOSGSSHSSISSJ\ \SK\ \S SP4SQjj5rA\SS'SRSF\BSSSGSSHSSISSJ\ \SK\ \S ST4SUjj5rA\SS'SVSF\BSSSGSSHSSISSJ\ \SK\ \S SW4SXjj5rA\SS'SYSF\BSSSGSSHSSISSJ\ \SK\ \S SZ4S[jj5rA\SS'SNSF\SGSSHSSISSJ\ \SK\ \S S\4S]jj5rA\SS'\SF\SG\ \SH\ \SI\ \SJ\ \SK\ \S S^4S_jj5rASS'\SF\SG\ \SH\ \SI\ \SJ\ \SK\ \S S^4S`jjrASa\ S \ 4SbjrCSa\ S \ 4ScjrDSSdjrESe\\\2Rf4S \4SfjrFSSg\S S4ShjjrGSi\HS \4SjjrISSi\SG\ \SH\ \SI\ \S \4 SkjjrJS \H4SljrKSSG\ \SH\ \SI\ \S \4SmjjrLSnrMSo\S \4SpjrNS\\\O4S \ 4SqjrPSr\\\2Rf4S \ 4SsjrQS \ 4StjrRS \4SujrSSSv\S \ 4SwjjrTSS\ Sx\S \O4SyjjrUS\ S \4SzjrV\ S \4S{j5rWSS6\S;\ \S \4S|jjrXSS}\S;\ \S \4S~jjrY\ S \ 4Sj5rZ\ S \ 4Sj5r[\ S \>\ S44Sj5r\\ S \>\S44Sj5r]\ S \4Sj5r^\ S \4Sj5r_\ S \?\4Sj5r`S\S \ 4SjraS\S \ 4SjrbS \ 4SjrcS\S \ 4SjrdSo\S \4SjreSSC\S \2R4SjjrgSSjrhS\\\2Rf4S \i4SjrjSSjrkSS\\\2Rf4SK\ \S \ 4SjjrlSSa\\\2RfS4SC\S\SK\ \S\S \\i\ 44 Sjjrm\SSa\ SK\ \S \ 4Sjj5rn\SSa\iSK\ \S \i4Sjj5rn\SSa\SK\ \S \\iS44Sjj5rnSSa\\\2Rf\ 4SC\S\SK\ \S \\i\ 44 Sjjrn\SS\ SC\S\SK\ \S \ 4 Sjj5ro\SS\iSC\S\SK\ \S \i4 Sjj5ro\SS\SC\S\SK\ \S \\iS44 Sjj5roSS\\\2Rf\ 4SC\S\SK\ \S \\i\ 44 Sjjro\SS\ SK\ \S\ \=\\p\/\q\4S \ 4Sjj5rr\SS\iSK\ \S\ \=\\p\/\q\4S \i4Sjj5rr\SS\\\2Rf\ 4SK\ \S\ \=\\p\/\q\4S \\iS44Sjj5rrSSjrr\SSa\ SC\S\SK\ \S \ 4 Sjj5rs\SSa\iSC\S\SK\ \S \i4 Sjj5rs\SSa\SC\S\SK\ \S \\iS44 Sjj5rsSSa\\\2Rf\ 4SC\S\SK\ \S \\i\ 44 Sjjrs\SS\ SC\S\SK\ \S \ 4 Sjj5rt\SS\iSC\S\SK\ \S \i4 Sjj5rt\SS\SC\S\SK\ \S \\iS44 Sjj5rtSS\\\2Rf\ 4SC\S\SK\ \S \\i\ 44 SjjrtSru\ S \i4Sj5rvS\\\2Rf4S\S \ 4SjrwSSJ\ \S S4SjjrxSSK\ \S \ 4SjjrySS\iSK\ \S \ 4Sjjrz\S\4Sj5r{\S\S \ 4Sj5r|\S \6\=\/\ 4SS44Sj5r}\S\S \ 4Sj5r~Srg)r\ajBase class for cloud storage file URIs, in the style of the Python standard library's [`pathlib` module](https://docs.python.org/3/library/pathlib.html). Instances represent a path in cloud storage with filesystem path semantics, and convenient methods allow for basic operations like joining, reading, writing, iterating over contents, etc. `CloudPath` almost entirely mimics the [`pathlib.Path`](https://docs.python.org/3/library/pathlib.html#pathlib.Path) interface, so most familiar properties and methods should be available and behave in the expected way. Analogous to the way `pathlib.Path` works, instantiating `CloudPath` will instead create an instance of an appropriate subclass that implements a particular cloud storage service, such as [`S3Path`](../s3path). This dispatching behavior is based on the URI scheme part of a cloud storage URI (e.g., `"s3://"`). rrN)clientrpartsrrSr^c SUlSUlU(aQ[U5RS5(d[U5S-n[U5SR SU55-nUR USS9 UR R5 [U5Ul[UR5Ul [SUR35Ul Uc'[U[5(aUR UlOX lUba[X R R"5(d=[%SUR&SUR&SUR R"S35eS Ulg) N/c3B# UHoRS5v M g7f)rN)strip.0ps r: %CloudPath.__init__..s3P%QGGCLL%sTrzClient of type [z'] is not valid for cloud path of type [z]; must be instance of [z;], or None to use default client for this cloud path class.F)_handle_clientruendswithjoinrrri_strr"_urlr _no_prefix_pathrr\rr`rD __class___dirty)rerrrs r:rCloudPath.__init__sF&* +/ z?++C00 _s2 Z3883P%3P+PPJ  4@ ..0 O TYY' "Qt&7#89  >*i00)00 !L  j9I9I9V9V&W&W%"6#3#3"45NN##;D>r;.pathrcgr4rprgrrs r:rCloudPath.is_valid_cloudpathCsr;cgr4rprs r:rrIsPSr;c[U5R5RURR55nU(a#U(d[ SUSURS35eU$)N'z4' is not a valid path since it does not start with ')rulowerrrrM)rgrrvalids r:rrMsbD !,,S-=-=-C-C-EF %$D6McN^N^M__`a  r;c:URRSUS3$)Nz('z'))rrdrls r:__repr__CloudPath.__repr__Zs ..))*"TF"55r;cUR$r4)rrls r:__str__CloudPath.__str__]s yyr;cT[[U5R[U545$r4)hashrrdrurls r:__hash__CloudPath.__hash__`s T$Z((#d)455r;otherch[U[U55=(a [U5[U5:H$r4)rrrurers r:__eq__CloudPath.__eq__cs%%d,HTc%j1HHr;cvUR5(aUR5 [UR5$r4)is_file_refresh_cacherurrls r: __fspath__CloudPath.__fspath__fs( <<>>    !4;;r;ct[U[U55(d[$URUR:$r4rrNotImplementedrrs r:__lt__CloudPath.__lt__k,%d,,! !zzEKK''r;ct[U[U55(d[$URUR:*$r4rrs r:__le__CloudPath.__le__p,%d,,! !zzU[[((r;ct[U[U55(d[$URUR:$r4rrs r:__gt__CloudPath.__gt__ur r;ct[U[U55(d[$URUR:$r4rrs r:__ge__CloudPath.__ge__zr r;cg)zVFor example "bucket" on S3 or "container" on Azure; needs to be defined for each classNrprls r:rCloudPath.drives r;parentsexist_okmodecg)zPShould be implemented using the client API without requiring a dir is downloadedNrp)rerrrs r:mkdirCloudPath.mkdirs r;cg)zMShould be implemented using the client API to create and update modified timeNrp)rerrs r:touchCloudPath.touchs r;presignexpire_secondscU(aURRXS9nU$URRU5nU$)N)r )r_generate_presigned_url_get_public_url)rerr urls r:as_urlCloudPath.as_urls> ++55d5ZC ++--d3C r;c[S5e)NzZCannot change a cloud path's root since all paths are absolute; create a new path instead.) ValueErrorrs r: __rtruediv__CloudPath.__rtruediv__s h  r;cUR$r4)rrls r:rCloudPath.anchors   r;c[U5$r4)rurls r:as_uriCloudPath.as_uris 4yr;c8URRU5$r4)r_existsrefollow_symlinkss r:rCloudPath.existss{{""4((r;c>URRU5S:H$)Nrr_is_file_or_dirr2s r:is_dirCloudPath.is_dirs{{**40E99r;c>URRU5S:H$)Nfiler6r2s r:rCloudPath.is_files{{**40F::r;c"UR5$r4)rrls r:fspathCloudPath.fspaths  r;uricU"U5$r4rp)rgr@s r:from_uriCloudPath.from_uris 3xr;patternc[U[R5(aG[U[5(a[ UR U55nO"[R "U5nO [ U5nSU;a [S5eURUR5(dURS5(a [S5eURS:Xa [S5eU$)N..z8Relative paths with '..' not supported in glob patterns.rz%Non-relative patterns are unsupportedz.glob is only supported within a bucket or container; you can use `.iterdir` to list buckets; for example, CloudPath('s3://').iterdir()) rosPathLiker\ru relative_tor>rJrrr)rerD str_patterns r: _glob_checksCloudPath._glob_checkss gr{{ + +'9--!'"5"5d";<  ii0 g,K ; .J   ! !$"3"3 4 4 8N8Ns8S8S./VW W :: .Z r;cH^^U4SjmUU4SjmT"5nURRXS9Heup4[URU55R S5n[ U5S:Xa USS:XaMHSU5nT"U[ US5Xd5 Mg [U5$) Nc>[T5$r4r)Treesr:*CloudPath._build_subtree..s T!2r;cb>[US5nUcU(aT"5OSX'gT"XXBU5 g)z]Utility to build a tree from nested defaultdicts with a generator of nodes (parts) of a path.N)next)trunkbranchnodesr8 next_branchrP _build_trees r:rY-CloudPath._build_subtree.._build_trees4ud+K"*0d EM;vFr; recursiverr@rrc3$# UHov M g7fr4rprs r:r+CloudPath._build_subtree..s&1Qs)r _list_dirrurJsplitrrTdict) rer\ file_treefr8rrWrPrYs @@r:_build_subtreeCloudPath._build_subtrees2 GF ..t.IIA d+,2237E5zQ58s?&&E  4t#4e DJIr;r\c## URU5n[UR/U5nURU5H,nU[ U5[ UR5S-S- v M. g7f)Nr@)rd_CloudPathSelectablerY select_fromrur)reselectorr\rbrootrs r:_globCloudPath._globsg'' 2 # II    %%d+A#a&TYY!!3!566 7,sA+A-r9recurse_symlinksc## URU5n[U5Rn[[ U5[ US9nUR USU;=(d SU;5ShvN gN7f)Nr9r**rLr rr1r6r0rkrerDr9rmr7ris r:globCloudPath.globso ##G,%g.44 ! - . ::  7N    sA#A-%A+&A-c## URU5n[U5Rn[S[ U5-[ US9nUR US5ShvN gN7f)N)rproTrqrrs r:rglobCloudPath.rglob'sX ##G,%g.44 ! eM* *N> ::h---sAA!AA!c#h# URRUSS9HupX:wdM Uv M g7f)NFr[)rr_)rercrbs r:iterdirCloudPath.iterdir6s0KK))$%)@DAyAs#2 2c#"# /n/nUR5H,upVUcURU5 MURU5 M. U(aXU4v UH$n[RX- XUS9ShvN M& U(dXU4v ggN7f)zmUtility to yield tuples in the form expected by `.walk` from the file tree constructed by `_build_substree`. Ntop_down)itemsappendr\_walk_results_from_tree)rjtreer}dirsfilesitemrVrs r:r!CloudPath._walk_results_from_tree;s  JJLLD"(.ELL dkk$6G) e# #C 88TYYa8b b be# # csA3B5B 6Br}on_errorr3c## URSS9nURXUS9ShvN gN![anUb U"U5 SnAgeSnAff=f7f)NTr[r|)rdr Exception)rer}rr3rbes r:walkCloudPath.walkNsW  ++d+;I33Dh3W W W #   s<A".,.A. A A AA  AAr( bufferingencodingerrorsnewlineforce_overwrite_from_cloudforce_overwrite_to_cloudr cgr4rprerrrrrrrs r:openCloudPath.open^sr;r$rr cgr4rprs r:rrjsr;r&)r@rcgr4rprs r:rrvr;r'rcgr4rprs r:rrrr;r%rcgr4rprs r:rrrr;rcgr4rprs r:rrsr;zIO[Any]cgr4rprs r:rrsr;cr^^^^ ^ ^TR5nU(a$TR5(d[STS35eU(d([U4SjS55(a[ ST35eTS:Xa$TR5(a[ STS35eTR US 9 TRR5(d'TRRRS S S 9 S m O$TRR5Rm TRRTUUUUS 9n [U4SjS55(a+U Rm SUU UU 4Sjjn Xl U TlS TlTR R"[$R&:XaU RmUU4Sjn Xl U $)Nz2Cannot open directory, only files. Tried to open ()c3,># UH oT;v M g7fr4rprmrs r:r!CloudPath.open..s&E*QDy*)raz@File opened for read or append, but it does not exist on cloud: xzCannot open existing file (z) for creation.)rTrrg)rrrrrc3,># UH oT;v M g7fr4rprs r:rrs7"6QDy"6r)w+rrc>T"U0UD6 TR(dgTRR5RT:a%TS-n[R "TRX"4S9 TR TS9 STlg)Nr@timesrF)rrstatst_mtimerHutime_upload_local_to_cloud)rr new_mtimeroriginal_mtimere wrapped_closes r:_patched_close_upload-CloudPath.open.._patched_close_uploadsqt.v.{{ ;;##%..? . 2IHHT[[0FG++E]+^# r;c6>T"U0UD6 TR5 gr4)r)rrrewrapped_close_for_caches r:_patched_close_empty_cache2CloudPath.open.._patched_close_empty_caches'88  "r;rq)rrrGanyrFrErrparentrrrrrrrrrrB close_file)rerrrrrrrexists_on_cloudbufferrrrrrs`` ` @@@r:rrs++- 4<<>>,DTF!L 3&E*&E#E#E,RSWRXY  3;4;;==*-Ho+^_ _ 7QR{{!!## KK   $ $TD $ A N![[--/88N!! "  7"67 7 7"LLM $ $$1L"DLDK ;; & &-*B*B B'-ll # # 6L r;targetc8[U5[U5La[S[U535eUR5(a[SUS35eX:XaU$UR 5(aUR 5 UR RX5 U$)NzBThe target based to rename must be an instantiated class of type: rz6 is a directory; rename/replace the files recursively.)rrr8rGrunlinkr _move_filerers r:replaceCloudPath.replaces :T&\ )TUYZ^U_T`a  ;;==,vST  >K ==?? MMO t, r;c$URU5$r4)rrs r:renameCloudPath.rename%s||F##r;cUR5(a[SUS35e[UR55 [ SUS35e![ a Of=fUR RU5 g)Nrz) is a file; call unlink instead of rmdir.zDirectory not empty: 'z$'. Use rmtree to delete recursively.)rrHrTryrK StopIterationr_removerls r:rmdirCloudPath.rmdir*sz <<>>-vFG    ((.RS     D!s(A AA other_pathc X:H$r4rp)rers r:samefileCloudPath.samefile8s !!r; missing_okcUR5(a[SUS35eURRX5 g)Nrz. is a directory; call rmdir instead of unlink.)r8rGrr)rers r:rCloudPath.unlink<s; ;;==,vKL  D-r;datac[U5nURSS9nURU5sSSS5 $!,(df  g=f)zOpen the file in bytes mode, write to it, and close the file. NOTE: vendored from pathlib since we override open https://github.com/python/cpython/blob/3.8/Lib/pathlib.py#L1235-L1242 wbrN) memoryviewrwrite)rerviewrcs r: write_bytesCloudPath.write_bytesDs5$ YYDY !Q774=" ! !s 6 Ac[U[5(d"[SURR-5eUR SX#US9nUR U5sSSS5 $!,(df  g=f)zOpen the file in text mode, write to it, and close the file. NOTE: vendored from pathlib since we override open https://github.com/python/cpython/blob/3.10/Lib/pathlib.py#L1146-L1155 zdata must be str, not %srrrrrN)rrurrrdrr)rerrrrrcs r: write_textCloudPath.write_textOsY$$$69P9PPQ Q YYC(7Y SWX774=T S Ss A$$ A2cvURSS9nUR5sSSS5 $!,(df  g=f)Nrbrrread)rercs r: read_bytesCloudPath.read_bytesas' YYDY !Q668" ! !s* 8czURSXUS9nUR5sSSS5 $!,(df  g=f)Nrrr)rerrrrcs r: read_textCloudPath.read_textes/ YYC(7Y SWX668T S Ss, :cgNFrprls r: is_junctionCloudPath.is_junctionnr;funcc^TRRU5n[U5(aU"U0UD6n[U[5(a[ U5nTR U5$[U[RR5(a_[U5S:aP[US[5(a8[U[5(d [U5O[nU"U4SjU55$U$)zSome functions we can just dispatch to the pathlib version We want to do this explicitly so we don't have to support all of pathlib and subclasses can override individually if necessary. rc3># UH:n[U5UR:wdMTR[U55v M< g7fr4)_resolverj_new_cloudpath)rrres r:r.CloudPath._dispatch_to_path..s<":FQ(ST+YZY_Y_J_0##HQK00,s A!A)r__getattribute__callablerr rr collectionsabcSequencerr2rr6)rerrr path_versionsequence_classs` r:_dispatch_to_pathCloudPath._dispatch_to_pathus zz2248  L ! !'88L lM 2 2#L1L&&|4 4 |[__%=%= > >L!A%<?M::+5\<*P*P\"V[ "":F"  r;ch[U[[45(d[$UR SU5$)N __truediv__)rrur rrrs r:rCloudPath.__truediv__s-%#}!566! !%%mU;;r; pathsegmentsc(UR"S/UQ76$)Njoinpathrrers r:rCloudPath.joinpaths%%j@<@@r;cU$r4rprls r:absoluteCloudPath.absolute r;cgNTrprls r: is_absoluteCloudPath.is_absolutesr;strictcU$r4rp)rers r:resolveCloudPath.resolverr;walk_upc [U[5(d[USUS35eURUR:wa+[USURSUSURS35e[ US9n[ R S:aURS5 URR"UR40UD6$) Nz is a cloud path, but z is notz is a z path, but z path)rr.r) rr\r(rrasys version_infopoprrJ)rerrrs r:rJCloudPath.relative_tos%++v%;E7'JK K ;;%,, &&t{{m;ugVELL>QVW g&   g % JJy !zz%%ekkz)full_match requires Python 3.13 or higherr@ro) rrNotImplementedErrorrrrrr r full_match)rerDr9s r:r&CloudPath.full_matchs   g %%&QR R   dkkDJJ6 7 7c$++ ":;=>G    , ,c$++.245GT556AA B  r; path_patternc6URURUR-S-5(a(U[URUR-S-5Sn[ US9n[ R S:aURS5 UR"SU40UD6$)Nrror.r9match) rrrrrarrrr)rer(r9rs r:r*CloudPath.matchs  " "4;;#;c#A B B'DKK$**,Ds,J(K(MNL^4   g % JJ' (%%g|FvFFr;cb[RS:a [S5eURS5$)Nr>z%parser requires Python 3.13 or higherparser)rrr%rrls r:r-CloudPath.parsers-   g %%&MN N%%h//r;c$URS5$)Nrrrls r:rCloudPath.parent%%h//r;c$URS5$)Nrrrls r:rCloudPath.parentss%%i00r;c`URS5nUSS:XaUSSnUR/UQ7$)Nrrrr@)rr)rers r:rCloudPath.partss:&&w/ 8s?!"IE $e$$r;c$URS5$)Nstemrrls r:r7CloudPath.stemr#r;c$URS5$)Nsuffixrrls r:r:CloudPath.suffixr1r;c$URS5$)Nsuffixesrrls r:r=CloudPath.suffixess%%j11r;r7cURSU5$![a URXR-5s$f=f)N with_stem)rAttributeError with_namer:)rer7s r:r@CloudPath.with_stems? 6))+t< < 6>>$"45 5 6s '>>rYc&URSU5$)NrBr)rerYs r:rBCloudPath.with_name s%%k488r;cBURSRU55$)zCreate a new CloudPath with the same client out of the given segments. The first segment will be interpreted as the bucket/container name. r)rrr s r: with_segmentsCloudPath.with_segmentss""388L#9::r;r:c&URSU5$)N with_suffixr)rer:s r:rJCloudPath.with_suffixs%%mV<UR 5(aXR - nUR RX5$URSS9 UR5HSn[U5nURS5(dUS-n[U5[U5SnURX- 5 MU U$)Nz-Cannot download because path does not exist: T)rr)r rrIrr8rYr_download_filerryrurr download_to)rerTrcrelrel_dests r:rWCloudPath.download_to=s;' {{}}),YZ^Y_*`a a <<>>!!##)II5 ;;--d@ @   t  ,\\^$i||C(()Cq6#c(*- k45 $ r;cUR5(a[SUS35eURRU5 g)z Delete an entire directory tree.rz* is a file; call unlink instead of rmtree.N)rrHrrrls r:rmtreeCloudPath.rmtreeSs; <<>>-vGH  D!r;sourcecB[U5nUR5(a4UR5HnXR- R X2S9 M U$UR 5(a$UR5(aXR- nOUnUR XS9 U$)z-Upload a file or directory to the cloud path.r)r r8ryrY upload_fromr_upload_file_to_cloud)rer^rrdsts r:r`CloudPath.upload_from[s f ==??^^%++A+a&K{{}}[[(  % %f % `Jr;preserve_metadata remove_srcc UR5(d[SUS35e[R"U5nUR 5(a-UR UUS9n[ [[[4U5$[U[5(dURU5$URURLaUR5(a#UR 5(aX`R- nUc1[R R#SS5R%5S;nU(d]UR5(aHUR'5R(UR'5R(:a[+SUSUS 35e[ [URR-XUS 95$UR5(aUR/5(a5[ [[[4UR1UR2US95$[ [[[4X`R- R1UR2US95$) Nrz must exist to copy.r%CLOUDPATHLIB_FORCE_OVERWRITE_TO_CLOUDFalse1truezFile (z) is newer than (z5). To overwrite pass `force_overwrite_to_cloud=True`.)re)rr(rC to_anypathr8copytreer!r r r-rr\rWrrYrHenvirongetrrrrQrrr`r>)rerr3rdrrerTresults r:_copyCloudPath._copyss {{}}uTF*>?@ @((0 ;;==]])A#FdDj)62 2+y11##K0 0 ;;+,, ,!!## (:(:(<(<)II5 '/+-::>>;W,%'],+( -&&(($$&//499;3G3GG.[M):4&A<= dkk44TS]4^_ _%%'';+>+>+@+@$*%++ >V,$*% 99,99 >V:r;cgr4rprerr3rdrs r:rCloudPath.copyr;cgr4rprts r:rrurvr;cgr4rprts r:rru$'r;c(URUUUUSS9$)z6Copy self to target folder or file, if self is a file.Fr3rdrrerqrts r:rrus)zz +/%=   r; target_dircgr4rprer}r3rdrs r: copy_intoCloudPath.copy_intorvr;cgr4rprs r:rrrvr;cgr4rprs r:rrryr;c[R"U5UR- nURUUUUSS9n[ [ [ [4U5$)z9Copy self into target directory, preserving the filename.Fr{rCrlrYrqr!r r r-rer}r3rdr target_pathrps r:rrsW((4tyy@  +/%=  E$*%v..r;ignorecgr4rprerTrrs r:rmCloudPath.copytree  r;cgr4rprs r:rmrrr;cgr4rprs r:rmrs $'r;c UR5(d[SUS35e[R"U5nUR 5(a$UR 5(a[ SUS35e[UR55nUb.U"URUVs/sHoURPM sn5nO [5nURSSS9 UHnURU;aMUR 5(aURXR- US9 MHUR5(dM_URXRURRS5(aS OS-- UUS 9 M U$s snf) z1Copy self to a directory, if self is a directory.z Origin path z@ must be a directory. To copy a single file use the method copy.zDestination path z! of copytree must be a directory.TrrrrG)rr)r8rHrCrlrrrElistryrrYsetrrrmr)rerTrrcontentsr ignored_namessubpaths r:rmr"se{{}}-tf$de ((5     K$7$7$9$9*#K=0QR  '  "4#;#;h=Whffh=WXMEM$6G||},   ,,.Ia!!  <<9N9Ns9S9S2Y\#]^-E!! )>Xs!F cgr4rprts r:moveCloudPath.moveIrvr;cgr4rprts r:rrRrvr;cgr4rprts r:rr[ryr;c(URUUUUSS9$)z2Move self to target location, removing the source.Tr{r|rts r:rrds)zz +/%=   r;cgr4rprs r: move_intoCloudPath.move_intotrvr;cgr4rprs r:rr}rvr;cgr4rprs r:rrryr;c[R"U5UR- nURUUUUSS9n[ [ [ [4U5$)zQMove self into target directory, preserving the filename and removing the source.Tr{rrs r:rrsW((4tyy@  +/%=  E$*%v..r;cURR5(a[URR5(aURR5 g[R "UR5 gg)zRemoves cache if it existsN)rrrrshutilr\rls r:rCloudPath.clear_cachesM ;;    {{""$$ ""$ dkk* r;cHURRUR- $)z!Cached local version of the file.)r_local_cache_dirrrls r:rCloudPath._locals{{++doo==r;c[U5nURS5(aUSSnURUR5(dURU3nURR"U/UQ76$)zUse the scheme, client, cache dir of this cloudpath to instantiate a new cloudpath of the same type with the path passed. Used to make results of iterdir and joins have a unified client + cache. rr@N)rurrrr\)rerrs r:rCloudPath._new_cloudpathsj 4y ??3  8Dt{{++kk]4&)D{{$$T2E22r;c<UR5nUc1[RR SS5R 5S;nU(dQUR R5(a2UR R5RUR:atUR RRSSS9 URUR 5 [R"UR URUR4S9 UR(a[SUR SUS 35eUR R5RUR:a[SUR SUS 35eg![a gf=f) N'CLOUDPATHLIB_FORCE_OVERWRITE_FROM_CLOUDrhriTrr Local file () for cloud path (a ) has been changed by your code, but is being requested for download from cloud. Either (1) push your changes to the cloud, (2) remove the local file, or (3) pass `force_overwrite_from_cloud=True` to overwrite; or set env var CLOUDPATHLIB_FORCE_OVERWRITE_FROM_CLOUD=1.z) is newer on disk, but is being requested for download from cloud. Either (1) push your changes to the cloud, (2) remove the local file, or (3) pass `force_overwrite_from_cloud=True` to overwrite; or set env var CLOUDPATHLIB_FORCE_OVERWRITE_FROM_CLOUD=1.)rrOrHrnrorrrrrrrWrrrPrR)rerstatss r:rCloudPath._refresh_cachese IIKE & -)+97*eg*' & ';;%%''   "++enn< KK   $ $TD $ A   T[[ ) HHT[[(H I ;;)t{{m+=dVDWX  ;;    & & 7*t{{m+=dVDWX  8C   sF FFc4URR5(a [S5eURURUS9nUR 5n[ R "URURUR4S9 SUlSUl U$)z.Uploads cache file at self._local to the cloudz2Only individual files can be uploaded to the cloudrrFN) rr8r(rarrHrrrr)reruploadedrs r:r CloudPath._upload_local_to_clouds ;;    QR R-- KK2J.    U^^U^^$DE  r; local_pathcUc1[RRSS5R5S;nU(aURR UU5 U$UR 5nU(a(UR 5RUR:aURR UU5 U$[SURSUS35e![a SnNwf=f)zVUploads file at `local_path` to the cloud if there is not a newer file already there. Nrgrhrirrz) is newer in the cloud disk, but is being requested to be uploaded to the cloud. Either (1) redownload changes from the cloud or (2) pass `force_overwrite_to_cloud=True` to overwrite; or set env var CLOUDPATHLIB_FORCE_OVERWRITE_TO_CLOUD=1.) rHrnrorr _upload_filerrOrrQr)rerrrs r:raCloudPath._upload_file_to_clouds $ +')zz~~7(eg(' $ $ KK $ $ K IIKE *33ennD KK $ $  K'4;;-'9$@Q R   E sC C#"C# _source_typecSSKJn URURUR 55$![ a gf=f)zNPydantic special method. See https://docs.pydantic.dev/2.0/usage/types/custom/r) core_schemaN) pydantic_corer no_info_after_validator_functionvalidate any_schema ImportError)rgr_handlerrs r:__get_pydantic_core_schema__&CloudPath.__get_pydantic_core_schema__2sD  1?? &&(   s /2 ??vcU"U5$)zSUsed as a Pydantic validator. See https://docs.pydantic.dev/2.0/usage/types/custom/rp)rgrs r:rCloudPath.validate@s 1v r;c#(# URv g7f)z_Pydantic special method. See https://pydantic-docs.helpmanual.io/usage/types/#custom-data-typesN) _validate)rgs r:__get_validators__CloudPath.__get_validators__FsmmsvaluecU"U5$)zdUsed as a Pydantic validator. See https://pydantic-docs.helpmanual.io/usage/types/#custom-data-typesrp)rgrs r:rCloudPath._validateLs5zr;)rrrrrrrq).F)FFN)TN)FiTr)TNF)rrNNNNN)NNNNN)rNNNNN)NNNr4)r^rU)TFNF)TFN)NN)rdrrrsrtrrWrvrur r-rrrxrrrrrrrrr classmethodrwr+rrrintrrrrr rrrabstractmethodrrrr%r)rr.rr8rr>rBrHrIrLrdrrkrsrvry staticmethodrrrrrrrrrrrrbytesrrrrrrr rrr rrrJrrYr&r*r-rrrr7r:r=r@rBrGrJrM stat_resultrrRr rWr\r`rqrrrrrmrrrrrrrrarrrrryrpr;r:r\r\s %$ &* )#t[01))" )  )V d38n$$sCx.$T$-C--?S??7:04 4ScS4S$SSCH k)* <@  tYt_$ %  6#66#6ICIDI C (C(D( )C)D) (C(D( )C)D)> s   SW  /3 CKC=     d # $  dCc # $ !!!)d):d:;t;!!!34E#r{{*:$;0: 8 8)D$      %-TN #+4.    %'5937 % 5>      %-TN #+4.    %'5937 % 5>      %-TN #+4.    5937        %-TN #+4.    "& $!%5937   3-    # %-TN #+4.    "& $!%5937\\\3- \  \ # \%-TN\#+4.\ \|dt*$T$d$ ""5bkk)9#:"t"... ! !# !#' $!% !!3-! ! # ! !$E #' $!% 3- #  ! c! s! F<sM'9!:>>35bkk)9#:3C3D3$*$*SW*\48"*4. 648) ) #+4.)   ) X    9XseTk-BD$-N#O cdr;) metaclassrcSnSn[U5RU5H6nU(aUS:XaMUS:XaURU5un nM/X!-U-nM8 U=(d U$)NrrGrrF)rur` rpartition)rsepnewpathrYrbs r:rrZsi CGD $ts{  4<#..s3MGQ -$&% >cr;c&\rSrSrS\SS4SjrSrg)_CloudPathSelectableAccessoriu scandir_funcr^NcXlgr4scandir)rers r:r%_CloudPathSelectableAccessor.__init__vs# r;r)rdrrrsrtrrryrpr;r:rrus$X$$$r;rc \rSrSrSS\S\\S\S\SS4 SjjrS\4S jr SS \S\4S jjr S\4S jr S\4S jr \ S\4Sj5rSr\\SSS\\SSS44Sj55r\rSrSrg)rgizrYrchildrenrr^NchXlX0lX lX@l[ UR 5Ulgr4)_name _all_children_parentsr1rr _accessor)rerYrrrs r:r_CloudPathSelectable.__init__{s) %  5dllCr;cTSRURUR/-5$)Nr)rrrYrls r:r_CloudPathSelectable.__repr__s xx  344r;r3cURSL$r4)rr2s r:r8_CloudPathSelectable.is_dirs!!--r;cUR$r4)r1rls r:r_CloudPathSelectable.existss ||r;cgrrprls r: is_symlink_CloudPathSelectable.is_symlinkrr;cUR$r4)rrls r:rY_CloudPathSelectable.names zzr;c[UURUR/-URR US5XR;S9$)N)r)rgrrYrro)reparts r:_make_child_relpath(_CloudPathSelectable._make_child_relpathsF#  MMTYYK '    " "4 .---   r;rj)rgNNc#Z^# U4SjTRR55v g7f)Nc3r># UH,up[UTRTR/-U5v M. g7fr4)rgrr)rchildgrand_childrenrjs r:r/_CloudPathSelectable.scandir..s6 )C% !  (Dn U U)Cs47)rr~)rjs`r:r_CloudPathSelectable.scandirs'  )-););)A)A)C  s(+c## [[5nURU5nUH$nXR5R U5 M& XSVs/sHoDR PM snUSVs/sHoDR PM sn4v USHnUR 5ShvN M SSS5 gs snfs snfN!,(df  g=f7fr)rrrr8rrYr)re dirs_filesr~rrc child_dirs r:r_CloudPathSelectable.walks & \\$ 5<<>*11%8D)9:)9A)9:ZX]M^<_M^VVM^<__ _'- $>>+++.  ;<_, sF!C2CB;* C3C !C)C*C2 C; C CC)rrr1rrrr)rdrrrsrtrurrrwrrr8rrrxrYrrrrr_scandirrryrpr;r:rgrgzs  D Dc D D  D  D5#5.d.t.Dc  $ 9?@$L M  H ,r;rgr)crrrcollections.abc contextlibriorrrr r rHpathlibr r r rrrtypesrtypingrrrrrrrrrrrrrrrrr r! urllib.parser"warningsr# _typeshedr$r%r&r'r(rr+typing_extensionsr-r0r1r5r2r=pathlib._local legacy.globcloudpathlib.enumsrBrGrC exceptionsrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrrScloudpath_inforUrWrzrurvr{r|rABCMetarr\rrrgrpr;r:rs #%TT  ("w +w&g&@$F bqW$$3&bqW$+&+ $&+-&)  <;FFY:Zc#667Z CL \ 5 SXtJ/?.@$zBR.R%S>@CKK>@Do-or+=S6$$ ?,?,r;