+ KicsRt^RIt^RIt^RIHt^RIHtHt^RIH t ^RI H t ^RI H t ^RIHtHtRRR lltRR R lltR R ltRRltRRltRRltRRltRRltR#)z!Module for handling the PGA cacheN)gettext)OptionalTuple)urlparse)settings)logger) merge_folders path_containsc0V^8dQhR\R\/#)createreturn)boolstrZformat"1/usr/lib/python3.14/site-packages/lutris/cache.py __annotate__rs ( (4 (C (csV\4pV'd\PPV4p\PP V4'gC\PP \PP V44'dV#\ P#)zReturns the directory under which Lutris caches install files. This can be specified by the user, but defaults to a location in ~/.cache.)get_custom_cache_pathospath expanduserisdirdirnamerZINSTALLER_CACHE_DIR)r cache_path& rget_cache_pathrsg'(JWW'' 3 77== $ $ bggooj6Q(R(R   ' ''rc sTV^8dQhR\R\R\R\R\/#)r urlfile_id game_slugpreparer r r rrrrrs0C##Y\rcsB\4p\V4pVPPR4'dRpMTp\P P WBV4pV'd<\P PV4'g\P!V4V#)aReturn the directory used as a cache a file that will be downloaded from a URL. You also provide the file id from the file list and the slug for the game. The files will be cached in a directory named after the slug, but in a further subdirectory for the file-id; since GOG file-ids are inconvenient for this, we special case URLs pointed to 'gog.com' here. If 'prepare' is true, this will also create the directory.zgog.comZgog) rrZnetlocZendswithrrZjoinZexistsZmakedirs)rrrrrZ url_partsZfolderrs&&&& rget_url_cache_pathr!sq !J I  ++ 77<< v 6Dww~~d## KK  Krcs:V^8dQhR\\,/#r r )rr rrrrr3s..x}.rcsF\P!R4pV'dV#R#)zReturns the custom path, wether it is usable or not. Returns None if the path is not set, so that the default INSTALLER_CACHE_DIR should be used.pga_cache_pathN)rZ read_setting)rs rrr3s"&&'78J#:--rcs$V^8dQhR\/#r")r rrrrr;s  T rcs\4pV'gR#\V4wrV'd\P!V4V#)zTrue if the custom cache path is set and refers to a usable directory, so that get_cache_path() will return it. The directory does not have to exist for this, but at least its *parent* directory does.F)rvalidate_custom_cache_pathrZwarning)rZvalidZmsgs rhas_valid_custom_cache_pathr%;s2 '(J +J7JE s LrcshV^8dQhR\R\\\\,3,/#)r rr )r rr rrrrrrKs(35x}9L3Mrcsf\PPV4p\PPV4'gm\PP V4p\PPV4'dR\ R4V,3#R\ R4V,3#R#)zChecks the validity of a given path; returns a flag for whether it can be used, and an optional message for what's wrong with it, if anything is.TzZThe cache path '%s' does not exist, but its parent does so it will be created when needed.FzNThe cache path %s does not exist, nor does its parent, so it won't be created.)TN)rrrrr_)rZparentrrr$r$Ks##J/J 77== $ $, 77== l !`  rcs(V^8dQhR\RR/#)r rr Nr rrrrr^s3333rcs4\P!RV4R#)z(Saves the PGA cache path to the settingsr#N)rZ write_setting)rs&rsave_custom_cache_pathr(^s +T2rcr)r rr r rrrrrcs@@#@$@rcsR\4p\T;'d \W44#)zTrue if the 'path' is inside the custom cache (so we should not causally delete it). False for files in INSTALLER_CACHE_DIR - that is a cache, but not the custom cache, and we do delete those files freely.)rr r)rrrris_file_in_custom_cacher)cs$ '(J  >>}Z> ??rcs4V^8dQhR\R\RR/#)r source destinationr Nr'rrrrrls! 9 9# 9C 9D 9rcsbV'g \R4h\PPV4V8Xd\P !RW4R#\PP V4'd \W4M\P!W4\P!RW4R#)z"Copy a file or folder to the cachezMissing sourcezFile %s is already cached in %sNzCached %s to %s) Z ValueErrorrrrrZinforrshutilZcopyZdebug)r*r+s&&r save_to_cacher-lsn )** wwv+- 5vK ww}}Vf* F( LL"F8r)F)Z__doc__rr,rr&ZtypingrrZ urllib.parserZlutrisrZlutris.util.logrZlutris.util.systemrrrr!rr%r$r(r)r-)rrr.sI' "!"; (2.  &3 @ 9r