+ ܳja0t$^RIHt^RIt^RIt^RIHt^RIHt^RI t ]'d'^RI H t ^RIHtHtHt^RIHt]]]3,tR]R &!R R 4tR# ] d]'g^RI t LOi;i) ) annotationsN) TYPE_CHECKING) atomic_write)Iterator)AnyLiteral TypeAlias)CachingFileSystemr Detailc]tRt^tRtRRltRRltRRltRRR lltR R lt R R lt RRlt RRlt RRlt RRltRRltRtR#) CacheMetadataaCache metadata. All reading and writing of cache metadata is performed by this class, accessing the cached files and blocks is not. Metadata is stored in a single file per storage directory in JSON format. For backward compatibility. No longer supports pickle. cV^8dQhRR/#)storagez list[str])formats"f/home/luca/screen-checking/.venv/lib/python3.14/site-packages/fsspec/implementations/cache_metadata.py __annotate__CacheMetadata.__annotate__"s / / /c HV'g \R4hWn/.VnR#)z Parameters ---------- storage: list[str] Directories containing cached files, must be at least one. Metadata is stored in the last of these directories by convention. z3CacheMetadata expects at least one storage locationN) ValueError_storage cached_files)selfrs&&r__init__CacheMetadata.__init__"s"RS S +-$rc V^8dQhRRRR/#)rfnstrreturnr r)rs"rrr1src 8\VR4;_uu_4p\P!V4pRRR4XP4F?p\ VP R4\ 4'gK*\VR,4VR&KA V# +'giLe;i)z6Low-level function to load metadata from specific filerNblocks)openjsonloadvalues isinstancegetlistset)rrfloadedcs&& r_loadCacheMetadata._load1sg "c]]aYYq\FA!%%/400!!H+.( ! ]s B  B c$V^8dQhRRRRRR/#)rmetadata_to_saver rr r!Noner)rs"rrr:s!++f+#+$+rc \VRR7;_uu_4p\P!W4RRR4R# +'giR#;i)z4Low-level function to save metadata to specific filew)modeN)rr&dump)rr3rr-s&&& r_saveCacheMetadata._save:s- "3 ' '1 II& *( ' ' 's 7 A c V^8dQhRRRR/#)r writable_onlyboolr!zIterator[tuple[str, str, bool]]r)rs"rrr?s DD!D (Drc# "\VP4p\VP4FFwr4W2^, 8HpV'd V'gK"\PP VR4WE3xKH R#5i)zYield locations (filenames) where metadata is stored, and whether writable or not. Parameters ---------- writable: bool Set to True to only yield writable locations. Returns ------- Yields (str, str, bool) cacheN)lenr enumerateospathjoin)rr<nirwritables&& r_scan_locationsCacheMetadata._scan_locations?sW  #DMM2JAEzHX'',,w0'C C 3s A A9 ,A9c$V^8dQhRRRRRR/#)rrCr cfszCachingFileSystem | Noner!z#Literal[False] | tuple[Detail, str]r)rs"rrrUs$6 ,rc L\VP4VP4Fwwr4rVW9dKWa,P4pVeVP'd*VR,VP P V48wdKeVP'd5\P!4VR,, VP8dK\PPWGR,4p\PPV4'gKWs3u# R#)zIf path is in cache return its details, otherwise return ``False``. If the optional CachingFileSystem is specified then it is used to perform extra checks to reject possible matches, such as if they are too old. uidtimerF) ziprHrcopy check_filesfsukeyexpiryrNrBrCrDexists)rrCrKrbase_r?details&&& r check_fileCacheMetadata.check_fileUs%((<(<(>@Q@Q$R MRq [%%'F???ve} D8I'I:::$))+v">"Kd4L1Bww~~b!!z!%S rc V^8dQhRRRR/#)r expiry_timeintr!ztuple[list[str], bool]r)rs"rrrps3331G3rc .pVPR,P4P4Fwr4\P!4VR,, V8gK/VP RR4pV'g\ RV 24h\ PPVPR,V4pVPV4VPR,PV4K VPR,'dU\ PPVPR,R4pVPVPR,V4VPR,'*pW'3#)zRemove expired metadata from the cache. Returns names of files corresponding to expired metadata and a boolean flag indicating whether the writable cache is empty. Caller is responsible for deleting the expired files. rNrz)Cache metadata does not contain 'fn' for r?) rrPitemsrNr* RuntimeErrorrBrCrDrappendpopr9)rr\ expired_filesrCrXr cache_pathwritable_cache_emptys&& r clear_expiredCacheMetadata.clear_expiredps   --b1668>>@LDyy{VF^+k9ZZb)&CD6JWW\\$--"3R8$$R(!!"%))$/A   R dmmB&7AJ JJt((,j 9#'#4#4R#8822rcV^8dQhRR/#rr!r4r)rs"rrrs 1 1d 1rc .pVP4F_wpp\PPV4'd#VP VP V44KNVP /4Ka T;'g/.VnR#)z>Load all metadata from disk and store in ``self.cached_files``N)rHrBrCrUrcr0r)rrrrWs& rr'CacheMetadata.loadsk ,,.HB1ww~~b!!##DJJrN3##B' / )00RDrc$V^8dQhRRRRRR/#)rr-rrCr r!r4r)rs"rrrs!crc VPR,V,pVR,RJd<\VR,4VP,VP8dRVR&R#R#R#)z{Perform side-effect actions on closing a cached file. The actual closing of the file is the responsibility of the caller. r$TNr`)rr@ blocksizesize)rr-rCr/s&&& ron_close_cached_file"CacheMetadata.on_close_cached_filesT   b !$ ' X;d "s1X;'7!++'E'OAhK(P "rc V^8dQhRRRR/#)rrCr r!z str | Noner)rs"rrrsSZrc VPVR4pV'gR#Vwr4VPVPR,4'd5VPR,P V4VP 4V#\ R4h)zRemove metadata of cached file. If path is in the cache, return the filename of the cached file, otherwise return ``None``. Caller is responsible for deleting the cached file. Nzrsg"" % (..)S#XFI&A-A- sAA4-A43A4